idsqm/php-sitemap

Simple sitemap generator

v0.1 2025-07-07 12:38 UTC

Requires

• php: >=8.1
• nesbot/carbon: ^3.10

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

MIT

• Андрей Хузахметов

README

Description

A library for generating and exporting Sitemaps in xml, json, and csv formats. It is possible to register your own formats

Usage example

Generation sitemap.xml

<?php

use Carbon\Carbon;
use Idsqm\Sitemap\SimpleFilesystemWriter;
use Idsqm\Sitemap\SitemapGenerator;

$generator = new SitemapGenerator(
    'https://test.com/',
    [
        ['loc' => 'page/one', 'lastmod' => date('Y-m-d'), 'changefreq' => 'daily', 'priority' => 0.5],
        ['loc' => 'page/two', 'lastmod' => Carbon::today(), 'changefreq' => 'monthly', 'priority' => 0.6],
        ['loc' => 'another-section'],
    ],
    'xml',
    '/var/www/public/sitemap.xml',
    new SimpleFilesystemWriter(),
);

$generator->export();

Example of registering a sitemap exporter in a different format:

<?php

use Idsqm\Sitemap\Sitemap;
use Idsqm\Sitemap\SitemapExporter;
use Idsqm\Sitemap\SitemapExporterFactory;

SitemapExporterFactory::register('new-format', fn() => new class implements SitemapExporter {
    public function execute(Sitemap $sitemap): string
    {
        $result = '';

        foreach ($sitemap->getSitemapRecords() as $sitemapRecord) {
            $result .= $sitemapRecord->getLoc();
        }

        return $result;
    }
});

// Using a new exporter
$generator = new SitemapGenerator(
    'https://test.com/',
    [
        ['loc' => 'page/one']
    ],
    'new-format',
    '/var/www/public/sitemap.format',
    new SimpleFilesystemWriter(),
);

$generator->export();

Run tests

./vendor/bin/phpunit

Linter

The phpstan static code analyzer is used

Make the script executable:

chmod +x utils/linter/linter.sh

Run linter

./utils/linter/linter.sh