PHPackages vamischenko/xmlfeeds - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Logging & Monitoring](/categories/logging) 4. / 5. vamischenko/xmlfeeds ActiveLibrary[Logging & Monitoring](/categories/logging) vamischenko/xmlfeeds ==================== PHP library for generating XML feeds for news aggregators 1.0.1(1mo ago)00MITPHPPHP ^8.2CI passing Since Mar 29Pushed 1mo agoCompare [ Source](https://github.com/vamischenko/xmlfeeds)[ Packagist](https://packagist.org/packages/vamischenko/xmlfeeds)[ Docs](https://github.com/vamischenko/xmlfeeds)[ RSS](/packages/vamischenko-xmlfeeds/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)Dependencies (4)Versions (3)Used By (0) xml-feeds ========= [](#xml-feeds) PHP **8.2+** библиотека для генерации XML-фидов (RSS 2.0, Atom 1.0) под новостные агрегаторы и социальные сети: Яндекс, Google News, Рамблер, Mail.ru, Telegram, ВКонтакте, Facebook и др. Без привязки к фреймворку, Fluent API, опциональная валидация (поля + XSD). Установка --------- [](#установка) ``` composer require vamischenko/xmlfeeds ``` Требования: PHP 8.2+, `ext-dom`, `ext-xmlwriter`, `ext-libxml`. Быстрый старт ------------- [](#быстрый-старт) ``` use XmlFeeds\Builder\FeedBuilder; use XmlFeeds\Platforms\YandexNews; $xml = FeedBuilder::for(new YandexNews()) ->title('Мой сайт') ->link('https://example.com') ->description('Новости') ->items($articles, fn ($a) => [ 'title' => $a->title, 'link' => $a->url, 'pubDate' => $a->published_at, 'content' => $a->body, ]) ->withValidation() ->build(); ``` `build()` возвращает строку с XML (`UTF-8`, декларация ``). Платформы --------- [](#платформы) ### Новостные агрегаторы [](#новостные-агрегаторы) КлассНазначениеФорматРасширения`XmlFeeds\Platforms\RssFeed`Чистый RSS 2.0RSS 2.0—`XmlFeeds\Platforms\AtomFeed`Atom 1.0Atom 1.0—`XmlFeeds\Platforms\YandexNews`Яндекс.НовостиRSS 2.0`yandex:*`, `content:encoded``XmlFeeds\Platforms\YandexZen`Яндекс ДзенRSS 2.0`media:*`, `content:encoded``XmlFeeds\Platforms\YandexTurbo`Яндекс ТурбоRSS 2.0`turbo:*`, `content:encoded``XmlFeeds\Platforms\GoogleNews`Google NewsRSS 2.0`news:*`, `content:encoded``XmlFeeds\Platforms\RamblerNews`Рамблер/НовостиRSS 2.0`content:encoded``XmlFeeds\Platforms\MailRuNews`Mail.ru НовостиRSS 2.0`content:encoded`### Социальные сети и мессенджеры [](#социальные-сети-и-мессенджеры) КлассНазначениеОсобенности`XmlFeeds\Platforms\TelegramChannel`Telegram RSS-ботыЗаголовок ≤ 255 символов (лимит caption)`XmlFeeds\Platforms\VkontakteFeed`ВКонтакте / SMM-сервисыСтандартный RSS для автопостинга`XmlFeeds\Platforms\FacebookFeed`Facebook Instant Articles`content` обязателен (требование IA-формата)Канал задаётся через `title`, `link`, `description`; опционально `language` (по умолчанию `ru`), `lastBuildDate`. Поля элементов (маппер) ----------------------- [](#поля-элементов-маппер) ПолеТипОписание`title``string`Заголовок, обязательное`link``string`Полный URL статьи, обязательное`pubDate``\DateTimeInterface|string`Дата публикации`description``string`Краткое описание / лид`content``string`Полный HTML-текст (CDATA)`author``string`Автор`category``string|list`Рубрика (одна или несколько)`enclosure``array{url, type, length}`Медиавложение`keywords``string|list`Ключевые слова`guid``string`Уникальный идентификатор`source``string`Источник (Яндекс.Новости)`genre``string`Жанр (Яндекс.Новости)`turboContent``string`HTML Турбо-страницы (Яндекс Турбо)`publication_name``string`Название издания (Google News)`publication_language``string`Язык издания (Google News)`media:content``array{url, type, medium}`Медиа (Яндекс Дзен)`media:thumbnail``array{url}`Превью (Яндекс Дзен)Полный список разрешённых полей — `requiredFields()` + `optionalFields()` у выбранной платформы. Валидация --------- [](#валидация) ``` // Бросает ValidationException при первой ошибке (по умолчанию) $builder->withValidation(throw: true)->build(); // Логирует ошибки, XML всё равно возвращается $builder->withValidation(throw: false)->build(); // Только генерация, без валидации $builder->withoutValidation()->build(); // Dry-run: получить ValidationResult без исключений $result = $builder->validate(); if (!$result->isValid()) { print_r($result->errors()); } ``` Что проверяется: - Наличие всех обязательных полей - Корректность URL (`FILTER_VALIDATE_URL`) - Парсируемость `pubDate` - Well-formed XML (libxml) - XSD-схема (если платформа предоставляет `schemaPath()`) Социальные сети — примеры ------------------------- [](#социальные-сети--примеры) ### Telegram [](#telegram) ``` use XmlFeeds\Builder\FeedBuilder; use XmlFeeds\Platforms\TelegramChannel; $xml = FeedBuilder::for(new TelegramChannel()) ->title('Мой канал') ->link('https://t.me/mychannel') ->description('Лучшие новости') ->items($posts, fn ($p) => [ 'title' => $p->title, // обрежется до 255 символов 'link' => $p->url, 'pubDate' => $p->created_at, 'content' => $p->html, // → content:encoded (CDATA) 'enclosure' => ['url' => $p->image_url, 'type' => 'image/jpeg', 'length' => 0], ]) ->build(); ``` ### ВКонтакте [](#вконтакте) ``` use XmlFeeds\Platforms\VkontakteFeed; $xml = FeedBuilder::for(new VkontakteFeed()) ->title('Новости') ->link('https://example.com') ->description('Последние публикации') ->items($articles, fn ($a) => [ 'title' => $a->title, 'link' => $a->url, 'pubDate' => $a->published_at, 'content' => $a->body, ]) ->build(); ``` ### Facebook Instant Articles [](#facebook-instant-articles) ``` use XmlFeeds\Platforms\FacebookFeed; $xml = FeedBuilder::for(new FacebookFeed()) ->title('My Publication') ->link('https://example.com') ->description('Latest articles') ->items($articles, fn ($a) => [ 'title' => $a->title, 'link' => $a->url, 'pubDate' => $a->published_at, 'content' => $a->html_body, // обязательное поле для Instant Articles ]) ->build(); ``` Дополнительные возможности -------------------------- [](#дополнительные-возможности) **Запись в файл** (для больших фидов `XmlGenerator` пишет через `XMLWriter::openUri` без буферизации): ``` FeedBuilder::for(new RssFeed()) // ... ->withoutValidation() ->buildToFile('/var/www/feeds/news.xml'); ``` **Свой генератор** — реализуйте `XmlFeeds\Contracts\GeneratorInterface`(и `StreamableGeneratorInterface` для потоковой записи в файл): ``` $builder->generator($myGenerator); ``` **Свой валидатор схемы** — реализуйте `XmlFeeds\Contracts\SchemaValidatorInterface`: ``` $builder->schemaValidator($mySchemaValidator); ``` **Дополнительный валидатор** (запускается после встроенного) — реализуйте `XmlFeeds\Contracts\ValidatorInterface`: ``` $builder->validator($myExtraValidator); ``` **Строгий список полей** — запрещает ключи, не объявленные платформой: ``` $builder->strictFields(true); ``` **Логирование** (PSR-3): при ошибке валидации пишется уровень `error` (throw=true) или `warning` (throw=false): ``` $builder->logger($psrLogger); ``` **Новая платформа** — реализуйте `PlatformInterface` (или расширьте `AbstractRssPlatform`): ``` final class MyPlatform extends AbstractRssPlatform { public function namespace(): array { return []; } public function requiredFields(): array { return ['title', 'link']; } public function optionalFields(): array { return ['description', 'pubDate']; } public function schemaPath(): ?string { return null; } public function transform(FeedItem $item): array { return $item->toArray(); } } ``` Разработка ---------- [](#разработка) ``` composer install composer test # PHPUnit 12 composer phpstan # статический анализ (PHPStan 2) composer cs-fix # PHP CS Fixer (PSR-12) composer benchmark # нагрузочный прогон (по умолчанию 1000 элементов) ``` Параметр бенчмарка: `php tools/benchmark.php 5000`. Лицензия -------- [](#лицензия) MIT --- English ------- [](#english) PHP **8.2+** library for generating XML feeds (RSS 2.0, Atom 1.0) for news aggregators and social networks: Yandex, Google News, Rambler, Mail.ru, Telegram, VKontakte, Facebook, and others. Framework-agnostic, Fluent API, optional validation (field rules + XSD). ### Installation [](#installation) ``` composer require xmlfeeds/xml-feeds ``` Requirements: PHP 8.2+, `ext-dom`, `ext-xmlwriter`, `ext-libxml`. ### Quick start [](#quick-start) ``` use XmlFeeds\Builder\FeedBuilder; use XmlFeeds\Platforms\YandexNews; $xml = FeedBuilder::for(new YandexNews()) ->title('My site') ->link('https://example.com') ->description('News') ->items($articles, fn ($a) => [ 'title' => $a->title, 'link' => $a->url, 'pubDate' => $a->published_at, 'content' => $a->body, ]) ->withValidation() ->build(); ``` ### Platforms [](#platforms) #### News aggregators [](#news-aggregators) ClassPurposeFormatExtensions`XmlFeeds\Platforms\RssFeed`Plain RSS 2.0RSS 2.0—`XmlFeeds\Platforms\AtomFeed`Atom 1.0Atom 1.0—`XmlFeeds\Platforms\YandexNews`Yandex NewsRSS 2.0`yandex:*`, `content:encoded``XmlFeeds\Platforms\YandexZen`Yandex ZenRSS 2.0`media:*`, `content:encoded``XmlFeeds\Platforms\YandexTurbo`Yandex TurboRSS 2.0`turbo:*`, `content:encoded``XmlFeeds\Platforms\GoogleNews`Google NewsRSS 2.0`news:*`, `content:encoded``XmlFeeds\Platforms\RamblerNews`RamblerRSS 2.0`content:encoded``XmlFeeds\Platforms\MailRuNews`Mail.ruRSS 2.0`content:encoded`#### Social networks & messengers [](#social-networks--messengers) ClassPurposeNotes`XmlFeeds\Platforms\TelegramChannel`Telegram RSS botsTitle truncated to 255 chars`XmlFeeds\Platforms\VkontakteFeed`VKontakte / SMM toolsStandard RSS autopublishing`XmlFeeds\Platforms\FacebookFeed`Facebook Instant Articles`content` field is required### Validation [](#validation) ``` $builder->withValidation(throw: true)->build(); // throws ValidationException on error $builder->withValidation(throw: false)->build(); // logs errors, returns XML anyway $builder->withoutValidation()->build(); // skip validation entirely $result = $builder->validate(); // dry-run, returns ValidationResult ``` ### Extending [](#extending) - **Custom platform**: implement `PlatformInterface` (or extend `AbstractRssPlatform`) - **Custom generator**: implement `GeneratorInterface` (+ `StreamableGeneratorInterface` for file output) - **Custom schema validator**: implement `SchemaValidatorInterface` - **Extra validator**: implement `ValidatorInterface` ### Development [](#development) ``` composer install composer test # PHPUnit 12 composer phpstan # static analysis (PHPStan 2) composer cs-fix # PHP CS Fixer (PSR-12) composer benchmark # load test (default: 1000 items) ``` ### License [](#license) MIT ### Health Score 37 — LowBetter than 83% of packages Maintenance90 Actively maintained with recent releases Popularity0 Limited adoption so far Community2 Small or concentrated contributor base Maturity47 Maturing project, gaining track record How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 46d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/533cf837b244f9c58175ec3cc68fb62c5c08302e73b8cced88e8c268d0503aca?d=identicon)[vamischenko](/maintainers/vamischenko) --- Tags psr-3xmlatomfeedrssSitemap newsyandexgoogle-newsrss2aggregatoryandex turboyandex-newsyandex-zen ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer Type Coverage Yes ### Embed Badge ![Health badge](/badges/vamischenko-xmlfeeds/health.svg) ``` [![Health](https://phpackages.com/badges/vamischenko-xmlfeeds/health.svg)](https://phpackages.com/packages/vamischenko-xmlfeeds) ``` ### Alternatives [monolog/monolog Sends your logs to files, sockets, inboxes, databases and various web services 21.4k964.9M7.0k](/packages/monolog-monolog)[mibe/feedwriter Generate feeds in either RSS 1.0, RSS 2.0 or ATOM formats 1951.1M5](/packages/mibe-feedwriter)[laminas/laminas-feed provides functionality for creating and consuming RSS and Atom feeds 16749.2M47](/packages/laminas-laminas-feed)[php-feed-io/feed-io PHP library built to consume and serve JSONFeed / RSS / Atom feeds 15218.4k8](/packages/php-feed-io-feed-io)[bnomei/kirby3-feed Generate a Atom/JSON/RSS-Feed and XML-Sitemap from Pages-Collections 7224.8k](/packages/bnomei-kirby3-feed)[markrogoyski/simplelog-php Powerful PSR-3 logging. So easy, it's simple. 2818.1k4](/packages/markrogoyski-simplelog-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)