asika/sitemap

PHP Simple Sitemap Generator

2.1.0 2024-08-08 13:33 UTC

This package is auto-updated.

Last update: 2024-09-08 13:44:15 UTC


README

PHP Simple Sitemap Generator. Follows the W3C Sitemap Protocol

Installation via Composer

composer require asika/sitemap

Getting Started

Create a sitemap object:

use Asika\Sitemap\Sitemap;

$sitemap = new Sitemap();

Add items to sitemap:

$sitemap->addItem($url);
$sitemap->addItem($url);
$sitemap->addItem($url);

You can add some optional params.

use Asika\Sitemap\ChangeFreq;

$sitemap->addItem($url, '1.0', ChangeFreq::DAILY, '2015-06-07 10:51:20');
$sitemap->addItem($url, '0.7', ChangeFreq::WEEKLY, new \DateTime('2015-06-03 11:24:20'));

The arguments are loc, priority, changefreq and lastmod. See this table:

See: http://www.sitemaps.org/protocol.html#xmlTagDefinitions

Render it to XML:

echo $sitemap->render();

// OR

(string) $sitemap;

This is an example to send it as real sitemap for Google or other search engine:

header('Content-Type: application/xml');

echo $sitemap;

exit();

Use output() to instantly print header and XML body:

$sitemap->output();

exit();

Handle Psr7 Response

$response = new Response();

$response = $sitemap->handleResponse($response);

return $response;

The XML output in browser:

<?xml version="1.0" encoding="utf-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
	<url>
		<loc>http://sitemap.io</loc>
	</url>
	<url>
		<loc>http://sitemap.io/foo/bar/?flower=sakura&amp;fly=bird</loc>
		<changefreq>daily</changefreq>
		<priority>1.0</priority>
		<lastmod>2015-06-07T10:51:20+02:00</lastmod>
	</url>
</urlset>

Arguments

loc

The URL will be auto escaped. For example, the &, > will convert to &amp;, &gt;.

If you want to escape it yourself, set auto escape off:

$sitemap->setAutoEscape(false);

See: http://www.sitemaps.org/protocol.html#escaping

changefreq

Valid values are:

ChangeFreq::ALWAYS;
ChangeFreq::HOURLY;
ChangeFreq::DAILY;
ChangeFreq::WEEKLY;
ChangeFreq::MONTHLY;
ChangeFreq::YEARLY;
ChangeFreq::NEVER;

The value always should be used to describe documents that change each time they are accessed.

The value never should be used to describe archived URLs.

Please note that the value of this tag is considered a hint and not a command. Even though search engine crawlers may consider this information when making decisions, they may crawl pages marked hourly less frequently than that, and they may crawl pages marked yearly more frequently than that.

Crawlers may periodically crawl pages marked never so that they can handle unexpected changes to those pages.

priority

The default priority of a page is 0.5. Please note that the priority you assign to a page is not likely to influence the position of your URLs in a search engine's result pages. Search engines may use this information when selecting between URLs on the same site, so you can use this tag to increase the likelihood that your most important pages are present in a search index. Also, please note that assigning a high priority to all of the URLs on your site is not likely to help you. Since the priority is relative, it is only used to select between URLs on your site.

lastmod

Your date format will auto convert to W3c Datetime format. for example, if you send a string look like: 2015-06-07 10:51:20, Sitemap object will auto convert it to 2015-06-07T10:51:20+02:00.

You can set the format you want:

$sitemap->setDateFormat(\DateTimeInterface::ISO8601);

// OR

$sitemap->setDateFormat('Y-m-d');

Google News Sitemap

Please see Google News Sitemap document.

$sitemap = new \Asika\Sitemap\NewsSitemap();

$sitemap->addItem(
    $url,
    $newsTitle,
    'Publication Name',
    'en-us',
    $publishedDate
);

The format:

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
    xmlns:news="http://www.google.com/schemas/sitemap-news/0.9">
  <url>
  <loc>http://www.example.org/business/article55.html</loc>
  <news:news>
    <news:publication>
      <news:name>The Example Times</news:name>
      <news:language>en</news:language>
    </news:publication>
    <news:publication_date>2008-12-23</news:publication_date>
    <news:title>Companies A, B in Merger Talks</news:title>
  </news:news>
  </url>
</urlset>

Using Sitemap index files (to group multiple sitemap files)

use Asika\Sitemap\SitemapIndex;

$index = new SitemapIndex();

$index->addItem('http://domain.com/sitemap1.xml', $lastmod1);
$index->addItem('http://domain.com/sitemap2.xml', $lastmod2);

echo $index->render();

Output:

<?xml version="1.0" encoding="utf-8"?>
<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
	<sitemap>
        <loc>http://domain.com/sitemap1.xml</loc>
        <lastmod>2015-06-07T10:51:20+02:00</lastmod>
    </sitemap>
	<sitemap>
		<loc>http://domain.com/sitemap2.xml</loc>
		<lastmod>2015-06-07T10:51:20+02:00</lastmod>
	</sitemap>
</sitemapindex>

See: http://www.sitemaps.org/protocol.html#index

More