teamzac/larapie

A Laravel-enhanced wrapper for the SimplePie library

v0.3 2021-03-08 19:33 UTC

This package is auto-updated.

Last update: 2024-03-20 23:18:56 UTC


README

Latest Version on Packagist Build Status

SimplePie is a popular and feature-rich PHP library for parsing RSS/Atom feeds, but I don't particularly like the API. This package is just a lightweight wrapper around SimplePie that provides a slightly different API along with Laravel support.

Installation

You can install the package via composer:

composer require teamzac/larapie

Usage

$feed = LaraPie::feed('https://your-feed-url/here.rss')->get();
$feed->items()->each(function($item) {
  echo $item->title;
});

The primary data types are Feed and Item.

Feed

The Feed class represents the RSS feed. It has an items() method which returns an Illuminate\Support\Collection instance of the feed items (TeamZac\LaraPie\Item). The Feed has the following read-only properties:

  • title
  • type
  • links (TeamZac\LaraPie\Links)

Item

The Item class represents a single feed item. It has the following read-only properties:

  • id - usually the URL
  • title
  • description
  • content
  • categories (Illuminate\Support\Collection of strings)
  • authors (Illuminate\Support\Collection of TeamZac\LaraPie\Author)
  • dates (Illuminate\Support\Collection of Carbon\Carbon)
  • links (Illuminate\Support\Collection of strings)

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email chad@zactax.com instead of using the issue tracker.

Credits

License

The MIT License (MIT). Please see License File for more information.