annotate vendor/zendframework/zend-feed/src/Writer/Renderer/Feed/Rss.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 7a779792577d
children
rev   line source
Chris@0 1 <?php
Chris@0 2 /**
Chris@0 3 * Zend Framework (http://framework.zend.com/)
Chris@0 4 *
Chris@0 5 * @link http://github.com/zendframework/zf2 for the canonical source repository
Chris@0 6 * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com)
Chris@0 7 * @license http://framework.zend.com/license/new-bsd New BSD License
Chris@0 8 */
Chris@0 9
Chris@0 10 namespace Zend\Feed\Writer\Renderer\Feed;
Chris@0 11
Chris@0 12 use DateTime;
Chris@0 13 use DOMDocument;
Chris@0 14 use DOMElement;
Chris@0 15 use Zend\Feed\Uri;
Chris@0 16 use Zend\Feed\Writer;
Chris@0 17 use Zend\Feed\Writer\Renderer;
Chris@0 18 use Zend\Feed\Writer\Version;
Chris@0 19
Chris@0 20 /**
Chris@0 21 */
Chris@0 22 class Rss extends Renderer\AbstractRenderer implements Renderer\RendererInterface
Chris@0 23 {
Chris@0 24 /**
Chris@0 25 * Constructor
Chris@0 26 *
Chris@0 27 * @param Writer\Feed $container
Chris@0 28 */
Chris@0 29 public function __construct(Writer\Feed $container)
Chris@0 30 {
Chris@0 31 parent::__construct($container);
Chris@0 32 }
Chris@0 33
Chris@0 34 /**
Chris@0 35 * Render RSS feed
Chris@0 36 *
Chris@0 37 * @return self
Chris@0 38 */
Chris@0 39 public function render()
Chris@0 40 {
Chris@0 41 $this->dom = new DOMDocument('1.0', $this->container->getEncoding());
Chris@0 42 $this->dom->formatOutput = true;
Chris@0 43 $this->dom->substituteEntities = false;
Chris@0 44 $rss = $this->dom->createElement('rss');
Chris@0 45 $this->setRootElement($rss);
Chris@0 46 $rss->setAttribute('version', '2.0');
Chris@0 47
Chris@0 48 $channel = $this->dom->createElement('channel');
Chris@0 49 $rss->appendChild($channel);
Chris@0 50 $this->dom->appendChild($rss);
Chris@0 51 $this->_setLanguage($this->dom, $channel);
Chris@0 52 $this->_setBaseUrl($this->dom, $channel);
Chris@0 53 $this->_setTitle($this->dom, $channel);
Chris@0 54 $this->_setDescription($this->dom, $channel);
Chris@0 55 $this->_setImage($this->dom, $channel);
Chris@0 56 $this->_setDateCreated($this->dom, $channel);
Chris@0 57 $this->_setDateModified($this->dom, $channel);
Chris@0 58 $this->_setLastBuildDate($this->dom, $channel);
Chris@0 59 $this->_setGenerator($this->dom, $channel);
Chris@0 60 $this->_setLink($this->dom, $channel);
Chris@0 61 $this->_setAuthors($this->dom, $channel);
Chris@0 62 $this->_setCopyright($this->dom, $channel);
Chris@0 63 $this->_setCategories($this->dom, $channel);
Chris@0 64
Chris@0 65 foreach ($this->extensions as $ext) {
Chris@0 66 $ext->setType($this->getType());
Chris@0 67 $ext->setRootElement($this->getRootElement());
Chris@12 68 $ext->setDomDocument($this->getDomDocument(), $channel);
Chris@0 69 $ext->render();
Chris@0 70 }
Chris@0 71
Chris@0 72 foreach ($this->container as $entry) {
Chris@0 73 if ($this->getDataContainer()->getEncoding()) {
Chris@0 74 $entry->setEncoding($this->getDataContainer()->getEncoding());
Chris@0 75 }
Chris@0 76 if ($entry instanceof Writer\Entry) {
Chris@0 77 $renderer = new Renderer\Entry\Rss($entry);
Chris@0 78 } else {
Chris@0 79 continue;
Chris@0 80 }
Chris@0 81 if ($this->ignoreExceptions === true) {
Chris@0 82 $renderer->ignoreExceptions();
Chris@0 83 }
Chris@0 84 $renderer->setType($this->getType());
Chris@0 85 $renderer->setRootElement($this->dom->documentElement);
Chris@0 86 $renderer->render();
Chris@0 87 $element = $renderer->getElement();
Chris@0 88 $deep = version_compare(PHP_VERSION, '7', 'ge') ? 1 : true;
Chris@0 89 $imported = $this->dom->importNode($element, $deep);
Chris@0 90 $channel->appendChild($imported);
Chris@0 91 }
Chris@0 92 return $this;
Chris@0 93 }
Chris@0 94
Chris@0 95 /**
Chris@0 96 * Set feed language
Chris@0 97 *
Chris@0 98 * @param DOMDocument $dom
Chris@0 99 * @param DOMElement $root
Chris@0 100 * @return void
Chris@0 101 */
Chris@12 102 // @codingStandardsIgnoreStart
Chris@0 103 protected function _setLanguage(DOMDocument $dom, DOMElement $root)
Chris@0 104 {
Chris@12 105 // @codingStandardsIgnoreEnd
Chris@0 106 $lang = $this->getDataContainer()->getLanguage();
Chris@12 107 if (! $lang) {
Chris@0 108 return;
Chris@0 109 }
Chris@0 110 $language = $dom->createElement('language');
Chris@0 111 $root->appendChild($language);
Chris@0 112 $language->nodeValue = $lang;
Chris@0 113 }
Chris@0 114
Chris@0 115 /**
Chris@0 116 * Set feed title
Chris@0 117 *
Chris@0 118 * @param DOMDocument $dom
Chris@0 119 * @param DOMElement $root
Chris@0 120 * @return void
Chris@0 121 * @throws Writer\Exception\InvalidArgumentException
Chris@0 122 */
Chris@12 123 // @codingStandardsIgnoreStart
Chris@0 124 protected function _setTitle(DOMDocument $dom, DOMElement $root)
Chris@0 125 {
Chris@12 126 // @codingStandardsIgnoreEnd
Chris@12 127 if (! $this->getDataContainer()->getTitle()) {
Chris@0 128 $message = 'RSS 2.0 feed elements MUST contain exactly one'
Chris@0 129 . ' title element but a title has not been set';
Chris@0 130 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 131 if (! $this->ignoreExceptions) {
Chris@0 132 throw $exception;
Chris@0 133 } else {
Chris@0 134 $this->exceptions[] = $exception;
Chris@0 135 return;
Chris@0 136 }
Chris@0 137 }
Chris@0 138
Chris@0 139 $title = $dom->createElement('title');
Chris@0 140 $root->appendChild($title);
Chris@0 141 $text = $dom->createTextNode($this->getDataContainer()->getTitle());
Chris@0 142 $title->appendChild($text);
Chris@0 143 }
Chris@0 144
Chris@0 145 /**
Chris@0 146 * Set feed description
Chris@0 147 *
Chris@0 148 * @param DOMDocument $dom
Chris@0 149 * @param DOMElement $root
Chris@0 150 * @return void
Chris@0 151 * @throws Writer\Exception\InvalidArgumentException
Chris@0 152 */
Chris@12 153 // @codingStandardsIgnoreStart
Chris@0 154 protected function _setDescription(DOMDocument $dom, DOMElement $root)
Chris@0 155 {
Chris@12 156 // @codingStandardsIgnoreEnd
Chris@12 157 if (! $this->getDataContainer()->getDescription()) {
Chris@0 158 $message = 'RSS 2.0 feed elements MUST contain exactly one'
Chris@0 159 . ' description element but one has not been set';
Chris@0 160 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 161 if (! $this->ignoreExceptions) {
Chris@0 162 throw $exception;
Chris@0 163 } else {
Chris@0 164 $this->exceptions[] = $exception;
Chris@0 165 return;
Chris@0 166 }
Chris@0 167 }
Chris@0 168 $subtitle = $dom->createElement('description');
Chris@0 169 $root->appendChild($subtitle);
Chris@0 170 $text = $dom->createTextNode($this->getDataContainer()->getDescription());
Chris@0 171 $subtitle->appendChild($text);
Chris@0 172 }
Chris@0 173
Chris@0 174 /**
Chris@0 175 * Set date feed was last modified
Chris@0 176 *
Chris@0 177 * @param DOMDocument $dom
Chris@0 178 * @param DOMElement $root
Chris@0 179 * @return void
Chris@0 180 */
Chris@12 181 // @codingStandardsIgnoreStart
Chris@0 182 protected function _setDateModified(DOMDocument $dom, DOMElement $root)
Chris@0 183 {
Chris@12 184 // @codingStandardsIgnoreEnd
Chris@12 185 if (! $this->getDataContainer()->getDateModified()) {
Chris@0 186 return;
Chris@0 187 }
Chris@0 188
Chris@0 189 $updated = $dom->createElement('pubDate');
Chris@0 190 $root->appendChild($updated);
Chris@0 191 $text = $dom->createTextNode(
Chris@0 192 $this->getDataContainer()->getDateModified()->format(DateTime::RSS)
Chris@0 193 );
Chris@0 194 $updated->appendChild($text);
Chris@0 195 }
Chris@0 196
Chris@0 197 /**
Chris@0 198 * Set feed generator string
Chris@0 199 *
Chris@0 200 * @param DOMDocument $dom
Chris@0 201 * @param DOMElement $root
Chris@0 202 * @return void
Chris@0 203 */
Chris@12 204 // @codingStandardsIgnoreStart
Chris@0 205 protected function _setGenerator(DOMDocument $dom, DOMElement $root)
Chris@0 206 {
Chris@12 207 // @codingStandardsIgnoreEnd
Chris@12 208 if (! $this->getDataContainer()->getGenerator()) {
Chris@0 209 $this->getDataContainer()->setGenerator(
Chris@0 210 'Zend_Feed_Writer',
Chris@0 211 Version::VERSION,
Chris@0 212 'http://framework.zend.com'
Chris@0 213 );
Chris@0 214 }
Chris@0 215
Chris@0 216 $gdata = $this->getDataContainer()->getGenerator();
Chris@0 217 $generator = $dom->createElement('generator');
Chris@0 218 $root->appendChild($generator);
Chris@0 219 $name = $gdata['name'];
Chris@0 220 if (array_key_exists('version', $gdata)) {
Chris@0 221 $name .= ' ' . $gdata['version'];
Chris@0 222 }
Chris@0 223 if (array_key_exists('uri', $gdata)) {
Chris@0 224 $name .= ' (' . $gdata['uri'] . ')';
Chris@0 225 }
Chris@0 226 $text = $dom->createTextNode($name);
Chris@0 227 $generator->appendChild($text);
Chris@0 228 }
Chris@0 229
Chris@0 230 /**
Chris@0 231 * Set link to feed
Chris@0 232 *
Chris@0 233 * @param DOMDocument $dom
Chris@0 234 * @param DOMElement $root
Chris@0 235 * @return void
Chris@0 236 * @throws Writer\Exception\InvalidArgumentException
Chris@0 237 */
Chris@12 238 // @codingStandardsIgnoreStart
Chris@0 239 protected function _setLink(DOMDocument $dom, DOMElement $root)
Chris@0 240 {
Chris@12 241 // @codingStandardsIgnoreEnd
Chris@0 242 $value = $this->getDataContainer()->getLink();
Chris@12 243 if (! $value) {
Chris@0 244 $message = 'RSS 2.0 feed elements MUST contain exactly one'
Chris@0 245 . ' link element but one has not been set';
Chris@0 246 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 247 if (! $this->ignoreExceptions) {
Chris@0 248 throw $exception;
Chris@0 249 } else {
Chris@0 250 $this->exceptions[] = $exception;
Chris@0 251 return;
Chris@0 252 }
Chris@0 253 }
Chris@0 254 $link = $dom->createElement('link');
Chris@0 255 $root->appendChild($link);
Chris@0 256 $text = $dom->createTextNode($value);
Chris@0 257 $link->appendChild($text);
Chris@12 258 if (! Uri::factory($value)->isValid()) {
Chris@0 259 $link->setAttribute('isPermaLink', 'false');
Chris@0 260 }
Chris@0 261 }
Chris@0 262
Chris@0 263 /**
Chris@0 264 * Set feed authors
Chris@0 265 *
Chris@0 266 * @param DOMDocument $dom
Chris@0 267 * @param DOMElement $root
Chris@0 268 * @return void
Chris@0 269 */
Chris@12 270 // @codingStandardsIgnoreStart
Chris@0 271 protected function _setAuthors(DOMDocument $dom, DOMElement $root)
Chris@0 272 {
Chris@12 273 // @codingStandardsIgnoreEnd
Chris@0 274 $authors = $this->getDataContainer()->getAuthors();
Chris@12 275 if (! $authors || empty($authors)) {
Chris@0 276 return;
Chris@0 277 }
Chris@0 278 foreach ($authors as $data) {
Chris@0 279 $author = $this->dom->createElement('author');
Chris@0 280 $name = $data['name'];
Chris@0 281 if (array_key_exists('email', $data)) {
Chris@0 282 $name = $data['email'] . ' (' . $data['name'] . ')';
Chris@0 283 }
Chris@0 284 $text = $dom->createTextNode($name);
Chris@0 285 $author->appendChild($text);
Chris@0 286 $root->appendChild($author);
Chris@0 287 }
Chris@0 288 }
Chris@0 289
Chris@0 290 /**
Chris@0 291 * Set feed copyright
Chris@0 292 *
Chris@0 293 * @param DOMDocument $dom
Chris@0 294 * @param DOMElement $root
Chris@0 295 * @return void
Chris@0 296 */
Chris@12 297 // @codingStandardsIgnoreStart
Chris@0 298 protected function _setCopyright(DOMDocument $dom, DOMElement $root)
Chris@0 299 {
Chris@12 300 // @codingStandardsIgnoreEnd
Chris@0 301 $copyright = $this->getDataContainer()->getCopyright();
Chris@12 302 if (! $copyright) {
Chris@0 303 return;
Chris@0 304 }
Chris@0 305 $copy = $dom->createElement('copyright');
Chris@0 306 $root->appendChild($copy);
Chris@0 307 $text = $dom->createTextNode($copyright);
Chris@0 308 $copy->appendChild($text);
Chris@0 309 }
Chris@0 310
Chris@0 311 /**
Chris@0 312 * Set feed channel image
Chris@0 313 *
Chris@0 314 * @param DOMDocument $dom
Chris@0 315 * @param DOMElement $root
Chris@0 316 * @return void
Chris@0 317 * @throws Writer\Exception\InvalidArgumentException
Chris@0 318 */
Chris@12 319 // @codingStandardsIgnoreStart
Chris@0 320 protected function _setImage(DOMDocument $dom, DOMElement $root)
Chris@0 321 {
Chris@12 322 // @codingStandardsIgnoreEnd
Chris@0 323 $image = $this->getDataContainer()->getImage();
Chris@12 324 if (! $image) {
Chris@0 325 return;
Chris@0 326 }
Chris@0 327
Chris@12 328 if (! isset($image['title']) || empty($image['title'])
Chris@12 329 || ! is_string($image['title'])
Chris@0 330 ) {
Chris@0 331 $message = 'RSS 2.0 feed images must include a title';
Chris@0 332 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 333 if (! $this->ignoreExceptions) {
Chris@0 334 throw $exception;
Chris@0 335 } else {
Chris@0 336 $this->exceptions[] = $exception;
Chris@0 337 return;
Chris@0 338 }
Chris@0 339 }
Chris@0 340
Chris@12 341 if (empty($image['link']) || ! is_string($image['link'])
Chris@12 342 || ! Uri::factory($image['link'])->isValid()
Chris@0 343 ) {
Chris@0 344 $message = 'Invalid parameter: parameter \'link\''
Chris@0 345 . ' must be a non-empty string and valid URI/IRI';
Chris@0 346 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 347 if (! $this->ignoreExceptions) {
Chris@0 348 throw $exception;
Chris@0 349 } else {
Chris@0 350 $this->exceptions[] = $exception;
Chris@0 351 return;
Chris@0 352 }
Chris@0 353 }
Chris@0 354
Chris@0 355 $img = $dom->createElement('image');
Chris@0 356 $root->appendChild($img);
Chris@0 357
Chris@0 358 $url = $dom->createElement('url');
Chris@0 359 $text = $dom->createTextNode($image['uri']);
Chris@0 360 $url->appendChild($text);
Chris@0 361
Chris@0 362 $title = $dom->createElement('title');
Chris@0 363 $text = $dom->createTextNode($image['title']);
Chris@0 364 $title->appendChild($text);
Chris@0 365
Chris@0 366 $link = $dom->createElement('link');
Chris@0 367 $text = $dom->createTextNode($image['link']);
Chris@0 368 $link->appendChild($text);
Chris@0 369
Chris@0 370 $img->appendChild($url);
Chris@0 371 $img->appendChild($title);
Chris@0 372 $img->appendChild($link);
Chris@0 373
Chris@0 374 if (isset($image['height'])) {
Chris@12 375 if (! ctype_digit((string) $image['height']) || $image['height'] > 400) {
Chris@0 376 $message = 'Invalid parameter: parameter \'height\''
Chris@0 377 . ' must be an integer not exceeding 400';
Chris@0 378 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 379 if (! $this->ignoreExceptions) {
Chris@0 380 throw $exception;
Chris@0 381 } else {
Chris@0 382 $this->exceptions[] = $exception;
Chris@0 383 return;
Chris@0 384 }
Chris@0 385 }
Chris@0 386 $height = $dom->createElement('height');
Chris@0 387 $text = $dom->createTextNode($image['height']);
Chris@0 388 $height->appendChild($text);
Chris@0 389 $img->appendChild($height);
Chris@0 390 }
Chris@0 391 if (isset($image['width'])) {
Chris@12 392 if (! ctype_digit((string) $image['width']) || $image['width'] > 144) {
Chris@0 393 $message = 'Invalid parameter: parameter \'width\''
Chris@0 394 . ' must be an integer not exceeding 144';
Chris@0 395 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 396 if (! $this->ignoreExceptions) {
Chris@0 397 throw $exception;
Chris@0 398 } else {
Chris@0 399 $this->exceptions[] = $exception;
Chris@0 400 return;
Chris@0 401 }
Chris@0 402 }
Chris@0 403 $width = $dom->createElement('width');
Chris@0 404 $text = $dom->createTextNode($image['width']);
Chris@0 405 $width->appendChild($text);
Chris@0 406 $img->appendChild($width);
Chris@0 407 }
Chris@0 408 if (isset($image['description'])) {
Chris@12 409 if (empty($image['description']) || ! is_string($image['description'])) {
Chris@0 410 $message = 'Invalid parameter: parameter \'description\''
Chris@0 411 . ' must be a non-empty string';
Chris@0 412 $exception = new Writer\Exception\InvalidArgumentException($message);
Chris@12 413 if (! $this->ignoreExceptions) {
Chris@0 414 throw $exception;
Chris@0 415 } else {
Chris@0 416 $this->exceptions[] = $exception;
Chris@0 417 return;
Chris@0 418 }
Chris@0 419 }
Chris@0 420 $desc = $dom->createElement('description');
Chris@0 421 $text = $dom->createTextNode($image['description']);
Chris@0 422 $desc->appendChild($text);
Chris@0 423 $img->appendChild($desc);
Chris@0 424 }
Chris@0 425 }
Chris@0 426
Chris@0 427 /**
Chris@0 428 * Set date feed was created
Chris@0 429 *
Chris@0 430 * @param DOMDocument $dom
Chris@0 431 * @param DOMElement $root
Chris@0 432 * @return void
Chris@0 433 */
Chris@12 434 // @codingStandardsIgnoreStart
Chris@0 435 protected function _setDateCreated(DOMDocument $dom, DOMElement $root)
Chris@0 436 {
Chris@12 437 // @codingStandardsIgnoreEnd
Chris@12 438 if (! $this->getDataContainer()->getDateCreated()) {
Chris@0 439 return;
Chris@0 440 }
Chris@12 441 if (! $this->getDataContainer()->getDateModified()) {
Chris@0 442 $this->getDataContainer()->setDateModified(
Chris@0 443 $this->getDataContainer()->getDateCreated()
Chris@0 444 );
Chris@0 445 }
Chris@0 446 }
Chris@0 447
Chris@0 448 /**
Chris@0 449 * Set date feed last build date
Chris@0 450 *
Chris@0 451 * @param DOMDocument $dom
Chris@0 452 * @param DOMElement $root
Chris@0 453 * @return void
Chris@0 454 */
Chris@12 455 // @codingStandardsIgnoreStart
Chris@0 456 protected function _setLastBuildDate(DOMDocument $dom, DOMElement $root)
Chris@0 457 {
Chris@12 458 // @codingStandardsIgnoreEnd
Chris@12 459 if (! $this->getDataContainer()->getLastBuildDate()) {
Chris@0 460 return;
Chris@0 461 }
Chris@0 462
Chris@0 463 $lastBuildDate = $dom->createElement('lastBuildDate');
Chris@0 464 $root->appendChild($lastBuildDate);
Chris@0 465 $text = $dom->createTextNode(
Chris@0 466 $this->getDataContainer()->getLastBuildDate()->format(DateTime::RSS)
Chris@0 467 );
Chris@0 468 $lastBuildDate->appendChild($text);
Chris@0 469 }
Chris@0 470
Chris@0 471 /**
Chris@0 472 * Set base URL to feed links
Chris@0 473 *
Chris@0 474 * @param DOMDocument $dom
Chris@0 475 * @param DOMElement $root
Chris@0 476 * @return void
Chris@0 477 */
Chris@12 478 // @codingStandardsIgnoreStart
Chris@0 479 protected function _setBaseUrl(DOMDocument $dom, DOMElement $root)
Chris@0 480 {
Chris@12 481 // @codingStandardsIgnoreEnd
Chris@0 482 $baseUrl = $this->getDataContainer()->getBaseUrl();
Chris@12 483 if (! $baseUrl) {
Chris@0 484 return;
Chris@0 485 }
Chris@0 486 $root->setAttribute('xml:base', $baseUrl);
Chris@0 487 }
Chris@0 488
Chris@0 489 /**
Chris@0 490 * Set feed categories
Chris@0 491 *
Chris@0 492 * @param DOMDocument $dom
Chris@0 493 * @param DOMElement $root
Chris@0 494 * @return void
Chris@0 495 */
Chris@12 496 // @codingStandardsIgnoreStart
Chris@0 497 protected function _setCategories(DOMDocument $dom, DOMElement $root)
Chris@0 498 {
Chris@12 499 // @codingStandardsIgnoreEnd
Chris@0 500 $categories = $this->getDataContainer()->getCategories();
Chris@12 501 if (! $categories) {
Chris@0 502 return;
Chris@0 503 }
Chris@0 504 foreach ($categories as $cat) {
Chris@0 505 $category = $dom->createElement('category');
Chris@0 506 if (isset($cat['scheme'])) {
Chris@0 507 $category->setAttribute('domain', $cat['scheme']);
Chris@0 508 }
Chris@0 509 $text = $dom->createTextNode($cat['term']);
Chris@0 510 $category->appendChild($text);
Chris@0 511 $root->appendChild($category);
Chris@0 512 }
Chris@0 513 }
Chris@0 514 }