SimplePie 1.3.1 is now available! This is a bugfix release, which fixes a few bugs including a URI-parsing bug and an issue if DOMDocument doesn’t exist. In addition, the various methods deprecated in 1.3 now fail with an E_DEPRECATED error rather than simply having the methods not exist. For a full list of what has been changed in this version, see the commits since 1.3, and the issues closed in 1.3.1. This is a recommended upgrade for all users.
Posted by Ryan McCue at 10:10 am. Comments Off on SimplePie 1.3.1 is now available!
SimplePie 1.3 is now available! This release is our first to be PHP 5-only, and this brings with it a strengthened code base. A huge number of bugs have been fixed, along with plenty of new features. SimplePie 1.3 is almost completely backwards compatible with 1.2, so you have no excuse not to use it!
One of the biggest changes with this release is the dropping of legacy support for PHP 4. SimplePie 1.3 requires at least PHP 5.2.0 to run, and we recommend 5.3+ (as some versions of 5.2 are known to be buggy).
With a new version comes some changes to the API, with features being added and legacy items being removed.
One of the most important changes is that the SimplePie constructor no longer supports arguments. In the past, we’ve run in to a lot of issues with this feature, so we’ve decided to remove it. This may cause some breakages in your code, so watch out for this.
When using multifeeds with SimplePie, the SimplePie::error() method now returns an array (indexed by the number URL which failed). This should make working with invalid feeds easier.
If you’re using a custom caching system, it’s now much easier to use. Rather than overriding SimplePie_Cache, you can now register your handler and use the cache location option to pass options in. We’ve also bundled a Memcache-based cache handler with SimplePie (thanks to Matt Robenolt) to make it even easier to get SimplePie up and running.
This is just a summary of the changes we’ve made to SimplePie. To look at a full list of changes, head on over to the wiki or for the full change list, check out GitHub’s comparison view.
For anyone who has worked with the SimplePie codebase in the past, you’ll know it was a huge pain due to the entire project being in one file. With 1.3, we’ve split SimplePie up into one-class-per-file, enabling easy autoloading of the classes you need without needing to load them all. This means easier developing for us, and faster loading for you. A huge thanks must go to Drak from the Zikula project for the work on this.
If you’re one of the people who loved the monolithic file, don’t worry! We’ve baked a special compiled release which includes all the classes you need in a single file. If the compiled release is too big for you to handle, we’ve also baked a minified release which strips all the comments.
We’ve always prided ourselves on providing stellar documentation, and 1.3 is no different. Previously, an API reference was provided on the wiki, however this had occasionally fallen out of date, or not actually matched the code. With 1.3, we’re now generating this documentation directly from the PHPDoc comments in the code.
Head on over to the API documentation right now to see it! You can also use PHP-style URLs, so http://simplepie.org/api/SimplePie_Item will redirect you to the correct page.
SimplePie 1.4 will focus on slimming down by removing legacy support for several features.
In SimplePie 1.2, due to PHP 4 support class properties were declared with the var keyword, and access was restricted via the @access keyword. With 1.3 came the move to PHP 5 and strict properties, however for backwards compatibility, these properties were left as var. From 1.4 onwards, properties and methods with an @access private tag will have their visibility changed to protected. If you’re using any of these internal APIs, be aware that they will cease to be available. Proper methods are available for all pieces of data that you need to access, and we encourage you to move to those instead.
1.4 will also involve the splitting off of the HTTP handling. SimplePie will bundle Requests, however will have a clearly defined interface to implement your own HTTP handler.
We’ll also be attempting to increase our test coverage, with the aim to get up to at least 80% of the code covered by a test by 1.4.
With the release of 1.3 also begins our new release schedule. A new major version of SimplePie is planned to be released every 6 months, with 1.4 to be released in January 2013. This is a schedule we’ll be trying extremely hard to stick to, and we’d love to get your help in doing so. Pull requests on GitHub will always be welcomed with open arms, as are bug reports and feature requests.
Finally, I’d just like to personally thank all of you for using SimplePie. It’s a pleasure working on the project knowing that so many of you out there are using it. By far my favourite moment was when I accidentally pushed a piece of broken code up to GitHub, only to be alerted to it by a new issue on GitHub within minutes. You all make it worth every minute of my time.
So, thanks to everyone, and I’ll see you all here for a new release in 6 months!
Posted by Ryan McCue at 3:57 am. Comments (0)
For anyone who is using the latest development version of SimplePie (known as 1.3-dev), you might have noticed that the readme mentions SimplePie.compiled.php in the same vein as our previous simplepie.inc. However, in the past, you had to check out the entire repository just to build this.
I’m happy to announce that a pre-built version is now available at dev.simplepie.org. This version is rebuilt within 5 minutes of pushing to GitHub, so it will always be up-to-date with our current development version.
In addition, API documentation built from our PHPDoc comments is now available on dev.simplepie.org. This documentation is designed to give you a bit more of an insight into the SimplePie API, than the wiki. Don’t worry though, our wiki isn’t going anywhere any time soon!
If you encounter any problems, as usual, let us know via the issue tracker.
Posted by Ryan McCue at 5:01 am. Comments (0)