willvincent / feeds
Laravel 5 Service Provider for the SimplePie library
Installs: 1 108 035
Dependents: 6
Suggesters: 0
Security: 0
Stars: 309
Watchers: 17
Forks: 76
Open Issues: 3
Requires
- php: >=5.4.0 || ^7.2 || ^8.0
- ext-curl: *
- illuminate/support: ~5.0 || ^6.0 || ^7.0 || ^8.0|^9.0|^10.0 || ^11.0
- simplepie/simplepie: ^1.5
README
A simple Laravel 5/6/7/8/9/10 service provider for including the SimplePie library.
Installation
The Laravel 5/6/7/8/9/10 Feeds Service Provider can be installed via Composer by requiring the
willvincent/feeds
package in your project's composer.json
.
{ "require": { "willvincent/feeds": "2.3.*" } }
Configuration
If you're using Laravel 5.5 or newer you may skip the next step.
To use the Feeds Service Provider, you must register the provider when bootstrapping your Laravel application.
Find the providers
key in your config/app.php
and register the Service Provider.
'providers' => [ // ... willvincent\Feeds\FeedsServiceProvider::class, ],
Find the aliases
key in your config/app.php
and register the Facade.
'aliases' => [ // ... 'Feeds' => willvincent\Feeds\Facades\FeedsFacade::class, ],
Usage
Run php artisan vendor:publish --provider="willvincent\Feeds\FeedsServiceProvider"
to publish the default config file, edit caching setting withing the resulting config/feeds.php
file as desired.
See SimplePie Documentation for full API usage documentation.
The make() accepts 3 paramaters, the first parameter is an array of feed URLs, the second parameter is the max number of items to be returned per feed, and while the third parameter is a boolean which you can set to force to read unless content type not a valid RSS.
$feed = \Feeds::make('http://feed/url/goes/here');
Note: In Laravel 5 and newer, Facades must either be prefixed with a backslash, or brought into scope with a use [facadeName]
declaration.
Example controller method, and it's related view:
Controller:
public function demo() { $feed = \Feeds::make('http://blog.case.edu/news/feed.atom'); $data = array( 'title' => $feed->get_title(), 'permalink' => $feed->get_permalink(), 'items' => $feed->get_items(), ); return View::make('feed', $data); }
or Force to read unless content type not a valid RSS
public function demo() { $feed = \Feeds::make('http://blog.case.edu/news/feed.atom', true); // if RSS Feed has invalid mime types, force to read $data = array( 'title' => $feed->get_title(), 'permalink' => $feed->get_permalink(), 'items' => $feed->get_items(), ); return View::make('feed', $data); }
Multifeeds example controller method, and it's related view:
Controller:
public function demo() { $feed = \Feeds::make([ 'http://blog.case.edu/news/feed.atom', 'http://tutorialslodge.com/feed' ], 5); $data = array( 'title' => $feed->get_title(), 'permalink' => $feed->get_permalink(), 'items' => $feed->get_items(), ); return View::make('feed', $data); }
or Force to read unless content type not a valid RSS
public function demo() { $feed = \Feeds::make(['http://blog.case.edu/news/feed.atom', 'http://tutorialslodge.com/feed' ], 5, true); // if RSS Feed has invalid mime types, force to read $data = array( 'title' => $feed->get_title(), 'permalink' => $feed->get_permalink(), 'items' => $feed->get_items(), ); return View::make('feed', $data); }
View:
@extends('app') @section('content') <div class="header"> <h1><a href="{{ $permalink }}">{{ $title }}</a></h1> </div> @foreach ($items as $item) <div class="item"> <h2><a href="{{ $item->get_permalink() }}">{{ $item->get_title() }}</a></h2> <p>{{ $item->get_description() }}</p> <p><small>Posted on {{ $item->get_date('j F Y | g:i a') }}</small></p> </div> @endforeach @endsection