BC break: item can now have only 1 enclosure now

Author: konecnyjakub

CHANGELOG.md

@@ -4,6 +4,7 @@ Version 0.16.0-dev
 - possible BC break: Source no longer extends stdClass
 - added validation for e-mail address for channel's managingEditor and webMaster and item's author
 - added validation for url
+- BC break: item can now have only 1 enclosure now
 
 Version 0.15.1
 - fixed isPermaLink attribute name for element guid

RELEASE_NOTES

@@ -2,6 +2,8 @@ A new version of Rss is out. lastBuildDate and pubDate for channel now have be t
 
 Channel's managingEditor and webMaster and item's author now has to be e-mail addresses; the validation is not perfect but should work in most cases, please report any false positives and negatives that you find. There is basic validation of url for various elements, for now it only support http and https protocols.
 
+An item can now have only 1 enclosure now. It is not explicitly said in the specification but it is the intent.
+
 It is now possible to use special types for elements in BaseElement::registerElements().
 
 For complete list of changes since previous version, see CHANGELOG.md.

src/EnclosuresCollection.php

@@ -8,7 +8,7 @@
 use Nexendrie\Rss\CategoriesCollection;
 use Nexendrie\Rss\Category;
 use Nexendrie\Rss\Cloud;
-use Nexendrie\Rss\EnclosuresCollection;
+use Nexendrie\Rss\Enclosure;
 use Nexendrie\Rss\Extensions\ElementTypes\EmailAddress;
 use Nexendrie\Rss\Extensions\ElementTypes\NonNegativeInteger;
 use Nexendrie\Rss\Extensions\ElementTypes\Url;
@@ -140,7 +140,7 @@ public function configureItemOptions(OptionsResolver $resolver, Generator $gener
         $resolver->setAllowedTypes("link", "string");
         $resolver->setAllowedValues("link", (new Url())->getValidator());
         $resolver->setDefined([
-            "pubDate", "author", "comments", "guid", "source", "categories", "enclosures",
+            "pubDate", "author", "comments", "guid", "source", "categories", "enclosure",
         ]);
         $resolver->setAllowedTypes("pubDate", DateTime::class);
         $resolver->setNormalizer(
@@ -161,7 +161,7 @@ static function (Options $options, DateTime $value) use ($generator): GenericEle
         );
         $resolver->setAllowedTypes("source", Source::class);
         $resolver->setAllowedTypes("categories", CategoriesCollection::class);
-        $resolver->setAllowedTypes("enclosures", EnclosuresCollection::class);
+        $resolver->setAllowedTypes("enclosure", Enclosure::class);
     }
 
     protected function shortenDescription(string $description, int $maxLength): string

src/Extensions/RssCore.php

@@ -24,7 +24,7 @@ public function testToXml(): void
         $category = new Category("abc");
         $data["categories"] = CategoriesCollection::fromArray([$category,]);
         $enclosure = new Enclosure("https://example.com/music/test.mp3", 15, "audio/mpeg");
-        $data["enclosures"] = EnclosuresCollection::fromArray([$enclosure,]);
+        $data["enclosure"] = $enclosure;
         $item = new RssChannelItem($data);
         $xml = new \SimpleXMLElement("<test></test>");
         $item->toXml($xml, new Generator());