Source of file Feed.php
Size: 10,919 Bytes - Last Modified: 2014-03-12T23:21:18+01:00
/home/theseer/Downloads/ZendFramework-2.3.0/library/Zend/Feed/Writer/Extension/ITunes/Feed.php
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363 | <?php /** * Zend Framework (http://framework.zend.com/) * * @link http://github.com/zendframework/zf2 for the canonical source repository * @copyright Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com) * @license http://framework.zend.com/license/new-bsd New BSD License */ namespace Zend\Feed\Writer\Extension\ITunes; use Zend\Feed\Uri; use Zend\Feed\Writer; use Zend\Stdlib\StringUtils; use Zend\Stdlib\StringWrapper\StringWrapperInterface; /** */ class Feed { /** * Array of Feed data for rendering by Extension's renderers * * @var array */ protected $data = array(); /** * Encoding of all text values * * @var string */ protected $encoding = 'UTF-8'; /** * The used string wrapper supporting encoding * * @var StringWrapperInterface */ protected $stringWrapper; /** * Constructor */ public function __construct() { $this->stringWrapper = StringUtils::getWrapper($this->encoding); } /** * Set feed encoding * * @param string $enc * @return Feed */ public function setEncoding($enc) { $this->stringWrapper = StringUtils::getWrapper($enc); $this->encoding = $enc; return $this; } /** * Get feed encoding * * @return string */ public function getEncoding() { return $this->encoding; } /** * Set a block value of "yes" or "no". You may also set an empty string. * * @param string * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesBlock($value) { if (!ctype_alpha($value) && strlen($value) > 0) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "block" may only' . ' contain alphabetic characters'); } if ($this->stringWrapper->strlen($value) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "block" may only' . ' contain a maximum of 255 characters'); } $this->data['block'] = $value; return $this; } /** * Add feed authors * * @param array $values * @return Feed */ public function addItunesAuthors(array $values) { foreach ($values as $value) { $this->addItunesAuthor($value); } return $this; } /** * Add feed author * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function addItunesAuthor($value) { if ($this->stringWrapper->strlen($value) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "author" may only' . ' contain a maximum of 255 characters each'); } if (!isset($this->data['authors'])) { $this->data['authors'] = array(); } $this->data['authors'][] = $value; return $this; } /** * Set feed categories * * @param array $values * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesCategories(array $values) { if (!isset($this->data['categories'])) { $this->data['categories'] = array(); } foreach ($values as $key => $value) { if (!is_array($value)) { if ($this->stringWrapper->strlen($value) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "category" may only' . ' contain a maximum of 255 characters each'); } $this->data['categories'][] = $value; } else { if ($this->stringWrapper->strlen($key) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "category" may only' . ' contain a maximum of 255 characters each'); } $this->data['categories'][$key] = array(); foreach ($value as $val) { if ($this->stringWrapper->strlen($val) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "category" may only' . ' contain a maximum of 255 characters each'); } $this->data['categories'][$key][] = $val; } } } return $this; } /** * Set feed image (icon) * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesImage($value) { if (!Uri::factory($value)->isValid()) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "image" may only' . ' be a valid URI/IRI'); } if (!in_array(substr($value, -3), array('jpg', 'png'))) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "image" may only' . ' use file extension "jpg" or "png" which must be the last three' . ' characters of the URI (i.e. no query string or fragment)'); } $this->data['image'] = $value; return $this; } /** * Set feed cumulative duration * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesDuration($value) { $value = (string) $value; if (!ctype_digit($value) && !preg_match("/^\d+:[0-5]{1}[0-9]{1}$/", $value) && !preg_match("/^\d+:[0-5]{1}[0-9]{1}:[0-5]{1}[0-9]{1}$/", $value) ) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "duration" may only' . ' be of a specified [[HH:]MM:]SS format'); } $this->data['duration'] = $value; return $this; } /** * Set "explicit" flag * * @param bool $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesExplicit($value) { if (!in_array($value, array('yes', 'no', 'clean'))) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "explicit" may only' . ' be one of "yes", "no" or "clean"'); } $this->data['explicit'] = $value; return $this; } /** * Set feed keywords * * @param array $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesKeywords(array $value) { if (count($value) > 12) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "keywords" may only' . ' contain a maximum of 12 terms'); } $concat = implode(',', $value); if ($this->stringWrapper->strlen($concat) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "keywords" may only' . ' have a concatenated length of 255 chars where terms are delimited' . ' by a comma'); } $this->data['keywords'] = $value; return $this; } /** * Set new feed URL * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesNewFeedUrl($value) { if (!Uri::factory($value)->isValid()) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "newFeedUrl" may only' . ' be a valid URI/IRI'); } $this->data['newFeedUrl'] = $value; return $this; } /** * Add feed owners * * @param array $values * @return Feed */ public function addItunesOwners(array $values) { foreach ($values as $value) { $this->addItunesOwner($value); } return $this; } /** * Add feed owner * * @param array $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function addItunesOwner(array $value) { if (!isset($value['name']) || !isset($value['email'])) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "owner" must' . ' be an array containing keys "name" and "email"'); } if ($this->stringWrapper->strlen($value['name']) > 255 || $this->stringWrapper->strlen($value['email']) > 255 ) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: any "owner" may only' . ' contain a maximum of 255 characters each for "name" and "email"'); } if (!isset($this->data['owners'])) { $this->data['owners'] = array(); } $this->data['owners'][] = $value; return $this; } /** * Set feed subtitle * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesSubtitle($value) { if ($this->stringWrapper->strlen($value) > 255) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "subtitle" may only' . ' contain a maximum of 255 characters'); } $this->data['subtitle'] = $value; return $this; } /** * Set feed summary * * @param string $value * @return Feed * @throws Writer\Exception\InvalidArgumentException */ public function setItunesSummary($value) { if ($this->stringWrapper->strlen($value) > 4000) { throw new Writer\Exception\InvalidArgumentException('invalid parameter: "summary" may only' . ' contain a maximum of 4000 characters'); } $this->data['summary'] = $value; return $this; } /** * Overloading: proxy to internal setters * * @param string $method * @param array $params * @return mixed * @throws Writer\Exception\BadMethodCallException */ public function __call($method, array $params) { $point = lcfirst(substr($method, 9)); if (!method_exists($this, 'setItunes' . ucfirst($point)) && !method_exists($this, 'addItunes' . ucfirst($point)) ) { throw new Writer\Exception\BadMethodCallException( 'invalid method: ' . $method ); } if (!array_key_exists($point, $this->data) || empty($this->data[$point])) { return null; } return $this->data[$point]; } } |