Consuming Feeds with SimplePie

Share this article

If you’re an avid feed consumer like I am, you might be a bit sad to see Google’s recent announcement of Reader reaching end of life. Reader was simple and easy to use, but there’s no reason you can’t have the same functionality with your own homegrown project. The PHP library SimplePie allows for quick and easy feed consumption and display. Here’s how you can get started on your own feed reader. SimplePie is installable via Composer. You’ll need to add the following to your composer.json file. After Composer downloads the library and you include the autoloader file in your PHP script, you’re ready to begin writing your very own reader.

    "require": {
        "simplepie/simplepie": "dev-master"

Basic Functionality

To work with SimplePie, you’ll need first to pick a RSS or Atom feed you’d like to manipulate and grab its URL. I’ll be using the New York Times for my examples – here’s what you should have to start:
require_once 'autoloader.php';

$url = '';
$feed = new SimplePie();
You can see in the above code the URL to the NY Times’ feed, and the beginning of our SimplePie-based reader. In the latest version of SimplePie (v1.3), the constructor doesn’t take any arguments, unlike previous versions, and we use the set_feed_url() method to tell it where to pull the feed data from. Once the URL is set, we call init() and the reader is ready to go. You won’t see anything with just the above though; we still need to go out and grab the information. SimplePie provides many classes and methods to extract the information from any given section of an RSS feed. With the above beginning, Let’s add the following:
echo '<h1>' . $feed->get_title() . '</h1>';
echo '<p>' . $feed->get_description() . '</p>';
The methods get_title() and get_description() do exactly what they say; they return the title and the description of the entire feed. You can get the feed author (in some instances, but not with the NY Times feed), feed contributors, feed link(s), copyright, and of course items with similar methods. In order to actually display any stories posted by the feed, you need to get at minimum one item using the get_item() or get_items() functions. For now, let’s just grab a single item and get some information from it.
$item = $feed->get_item(0);
echo '<article>';
echo '<header>';
echo '<p>Title: <a href="' . $item->get_link() . '">' . $item->get_title() . '</a></p>';
echo '<p>Author: ' . $item->get_author()->get_name() . '</p>';
echo '<p>Date: ' . $item->get_date('Y-m-d H:i:s') . '</p>';
echo '<p>Description: ' . $item->get_description() . '</p>';
echo '</header>';
echo $item->get_content(true);
echo '</article>';
This certainly won’t look pretty, but it shows you a the basics necessary for getting information from a feed item. So, let’s go over what some of this means. The get_item()
method retrieves a single item from the feed. The integer argument provided is the feed item number and, like an array, zero is the index of the first item in the feed. The get_link() method returns a URL to the feed item itself, allowing you to open the article/video/etc for whatever feed you are working with. The get_title and get_description() methods should look familiar as they are the same as before when being applied directly to the feed itself. The author line looks a little funny, but as I’m sure you’ve figured out – the get_author() method returns an Author object, and we call the get_name() method on that object to retrieve whom the article is by. The get_date() method takes any standard PHP date format string to display the date however you like. Finally, the get_content() method takes a Boolean argument that says either return only the summary information (true) or try to return the summary information but fallback to the description if none is provided (false).

Selecting Items

So we’ve seen the basics and have displayed a feed title, description, and the relevant information for a single item posted to the feed. That’s all well and good, but it would be frustrating to have to refresh the page constantly to see if there is a newer item, and even more frustrating that we can’t see any past items! SimplePie provides for that very easily, and I’ve already briefly touched on our options: get_item() and get_items(). These two functions are used to get our feed items and their content in two different ways. The first option that we demoed takes a single integer that specifies which item in the “array” of feed items we want to grab. Using this in a loop in conjunction with the method get_item_quantity() allows us to display all of or a subset of the items in the feed.
$itemQty = $feed->get_item_quantity();
for ($i = 0; $i < $itemQty; $i++) {
This solution, however usable, is not very elegant if you want to use pagination when displaying feed items. For this, we can use the method get_items(). It accepts two integers: an offset, and an item count. This allows us to get all of the items by passing zeros for both, or, what is really handy about this, allows us to get small subsets anywhere throughout all available feed items.
foreach ($feed->get_items(3, 3) as $item) {
This usage would be displaying the second page of three items.


With all of this data flowing, it would be quite taxing to process the entire feed every time you load the page, but don’t worry… SimplePie has you covered. There are several options for caching feed data built-in so you don’t have to pull the entire feed every time. SimplePie uses a Conditional GET to determine if a feed has been updated since the last retrieval time. To store the content, your cache storage options are the file system, MySQL, Memcache, or – if you’re feeling up to it – you can write your own handler. The easiest to implement is caching to a file. Here’s how:
$feed = new SimplePie();
And that’s it! The newly added line turns on caching for SimplePie and writes the data out to a file. You’ll need to make sure that your document root contains a writeable directory named cache and you’re all set. If you prefer to specify a different location, that’s easy too. Simply use the method set_cache_location() and pass it a string pointing to the location you want cache files written to. The same method can also be used in the case of caching with MySQL and Memcache.


These are the most basic principles of using the SimplePie library. You’ve learned how to set up and initialize a feed, grab one or more items from the feed, and parse the information contained in those items to display. Of course, SimplePie’s functionality doesn’t end there. It also gives you the ability to pull items and parse information from multiple feeds at once – allowing for a mix of information displayed at your finger tips, all controlled by you. Dive into their API documentation; it’s an excellent resource and will guide you well. I look forward seeing the next best Google Reader replacement powered by SimplePie, written by you! You can find a brief sample to accompany this article on GitHub to get you started. Image via Fotolia

Frequently Asked Questions (FAQs) about Consuming Feeds with SimplePie

What is SimplePie and how does it work?

SimplePie is a very fast and easy-to-use class, written in PHP, that puts the ‘simple’ back into ‘really simple syndication’. It enables developers to access and manipulate RSS feeds in their web pages with minimal effort. SimplePie uses PHP to parse the XML of the RSS feed, and it can return an object that contains all the elements of the feed ready to be displayed in a web page.

How do I install SimplePie?

To install SimplePie, you need to download the SimplePie package from the official website. Once downloaded, extract the files and upload them to your web server. You can then include the SimplePie autoloader in your PHP script to start using SimplePie functions.

How can I customize the feed output with SimplePie?

SimplePie provides several methods to customize the feed output. You can use the get_title(), get_description(), and get_permalink() methods to retrieve the title, description, and link of the feed respectively. You can also use the get_items() method to retrieve all the items in the feed and display them as per your requirements.

Can I use SimplePie to consume multiple feeds at once?

Yes, SimplePie supports the consumption of multiple feeds at once. You can pass an array of feed URLs to the set_feed_url() method and SimplePie will merge the items from all the feeds together, sorted by date.

How do I handle feed errors with SimplePie?

SimplePie provides the error() method to handle feed errors. If there is an error while parsing the feed, the error() method will return a string describing the error. You can display this error message to the user or use it for debugging purposes.

Can I cache feeds with SimplePie?

Yes, SimplePie supports feed caching. By default, SimplePie caches the feeds for 60 minutes. You can change the cache duration using the set_cache_duration() method. Caching feeds can significantly improve the performance of your web page.

How do I sanitize feed data with SimplePie?

SimplePie provides the sanitize() method to sanitize feed data. This method removes any potentially harmful code from the feed data, making it safe to display in your web page.

Can I use SimplePie with WordPress?

Yes, SimplePie is compatible with WordPress. In fact, WordPress uses SimplePie for its RSS widget. You can also use SimplePie in your WordPress themes or plugins to display custom RSS feeds.

How do I update SimplePie to the latest version?

To update SimplePie to the latest version, you need to download the latest SimplePie package from the official website and replace the old SimplePie files on your web server with the new ones.

Where can I get help if I have problems with SimplePie?

If you have problems with SimplePie, you can get help from the SimplePie community. The SimplePie website has a comprehensive documentation and a community forum where you can ask questions and get help from other SimplePie users and developers.

Kevin MowryKevin Mowry
View Author

Kevin Mowry is a software developing, space and science craving, car fanatic. If it's not broken, he's still trying to fix it. When not engrossed in a computer/car related project, Kevin is out golfing or reading about astrophysics and religion. At night he can be found in a dark field staring straight up with his telescope.

Share this article
Read Next
Get the freshest news and resources for developers, designers and digital creators in your inbox each week
Loading form