当前位置：首页 > 软件库 > Web应用开发 > Web框架 >

laravel-feed

Easily generate RSS feeds

授权协议 MIT License

开发语言 PHP

所属分类 Web应用开发、 Web框架

软件类型开源软件

地区不详

投递者葛泳

操作系统跨平台

开源组织无

适用人群未知

软件概览

Generate RSS feeds in a Laravel app

This package provides an easy way to generate a feed for your Laravel application. Supported formats are RSS, Atom, and JSON. There's almost no coding required on your part. Just follow the installation instructions, update your config file, and you're good to go.

Spatie is a webdesign agency based in Antwerp, Belgium. You'll find an overview of all our open source projects on our website.

Support us

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products.

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall.

Installation

You can install the package via composer:

composer require spatie/laravel-feed

// In routes/web.php
Route::feeds();

Optionally, you can pass a string as a first argument of the macro. The string will be used as a a URL prefix for all configured feeds.

Next, you must publish the config file:

php artisan vendor:publish --provider="Spatie\Feed\FeedServiceProvider" --tag="feed-config"

Here's what that looks like:

return [
    'feeds' => [
        'main' => [
            /*
             * Here you can specify which class and method will return
             * the items that should appear in the feed. For example:
             * [App\Model::class, 'getAllFeedItems']
             *
             * You can also pass an argument to that method.  Note that their key must be the name of the parameter:             *
             * [App\Model::class, 'getAllFeedItems', 'parameterName' => 'argument']
             */
            'items' => '',

            /*
             * The feed will be available on this url.
             */
            'url' => '',

            'title' => 'My feed',
            'description' => 'The description of the feed.',
            'language' => 'en-US',

            /*
             * The image to display for the feed.  For Atom feeds, this is displayed as
             * a banner/logo; for RSS and JSON feeds, it's displayed as an icon.
             * An empty value omits the image attribute from the feed.
             */
            'image' => '',

            /*
             * The format of the feed.  Acceptable values are 'rss', 'atom', or 'json'.
             */
            'format' => 'atom',

            /*
             * The view that will render the feed.
             */
            'view' => 'feed::atom',

            /*
             * The mime type to be used in the <link> tag.  Set to an empty string to automatically
             * determine the correct value.
             */
            'type' => '',

            /*
             * The content type for the feed response.  Set to an empty string to automatically
             * determine the correct value.
             */
            'contentType' => '',
        ],
    ],
];

Optionally you can publish the view files:

php artisan vendor:publish --provider="Spatie\Feed\FeedServiceProvider" --tag="feed-views"

Usage

Imagine you have a model named NewsItem that contains records that you want to have displayed in the feed.

First you must implement the Feedable interface on that model. Feedable expects one method: toFeedItem, which should return a FeedItem instance.

// app/NewsItem.php

use Illuminate\Database\Eloquent\Model;
use Spatie\Feed\Feedable;
use Spatie\Feed\FeedItem;

class NewsItem extends Model implements Feedable
{
    public function toFeedItem(): FeedItem
    {
        return FeedItem::create()
            ->id($this->id)
            ->title($this->title)
            ->summary($this->summary)
            ->updated($this->updated_at)
            ->link($this->link)
            ->authorName($this->author)
            ->authorEmail($this->authorEmail);
    }
}

If you prefer, returning an associative array with the necessary keys will do the trick too.

// app/NewsItem.php

use Illuminate\Database\Eloquent\Model;
use Spatie\Feed\Feedable;
use Spatie\Feed\FeedItem;

class NewsItem extends Model implements Feedable
{
    public function toFeedItem(): FeedItem
    {
        return FeedItem::create([
            'id' => $this->id,
            'title' => $this->title,
            'summary' => $this->summary,
            'updated' => $this->updated_at,
            'link' => $this->link,
            'authorName' => $this->authorName,
        ]);
    }
}

Next, you'll have to create a method that will return all the items that must be displayed inthe feed. You can name that method anything you like and you can do any query you want.

// app/NewsItem.php

public static function getFeedItems()
{
   return NewsItem::all();
}

Finally, you have to put the name of your class and the url where you want the feed to renderedin the config file:

// config/feed.php

return [

    'feeds' => [
        'news' => [
            /*
             * Here you can specify which class and method will return
             * the items that should appear in the feed. For example:
             * 'App\Model@getAllFeedItems'
             * or
             * ['App\Model', 'getAllFeedItems']
             *
             * You can also pass an argument to that method.  Note that their key must be the name of the parameter:             * 
             * ['App\Model@getAllFeedItems', 'parameterName' => 'argument']
             * or
             * ['App\Model', 'getAllFeedItems', 'parameterName' => 'argument']
             */
            'items' => 'App\NewsItem@getFeedItems',

            /*
             * The feed will be available on this url.
             */
            'url' => '/feed',

            'title' => 'All newsitems on mysite.com',

            /*
             * The format of the feed.  Acceptable values are 'rss', 'atom', or 'json'.
             */
            'format' => 'atom',

            /*
             * Custom view for the items.
             *
             * Defaults to feed::feed if not present.
             */
            'view' => 'feed::feed',
        ],
    ],

];

The items key must point to a method that returns one of the following:

An array or collection of Feedables
An array or collection of FeedItems
An array or collection of arrays containing feed item values

Customizing your feed views

This package provides, out of the box, the feed::feed view that displays your feeds details.

However, you could use a custom view per feed by providing a view key inside of your feed configuration.

In the following example, we're using the previous News feed with a custom feeds.news view (located on resources/views/feeds/news.blade.php):

// config/feed.php

return [

    'feeds' => [
        'news' => [
            'items' => ['App\NewsItem', 'getFeedItems'],

            'url' => '/feed',

            'title' => 'All newsitems on mysite.com',

            /*
             * The format of the feed.  Acceptable values are 'rss', 'atom', or 'json'.
             */
            'format' => 'atom',
            
            /*
             * Custom view for the items.
             *
             * Defaults to feed::feed if not present.
             */
            'view' => 'feeds.news',
        ],
    ],

];

Automatically generate feed links

To discover a feed, feed readers are looking for a tag in the head section of your html documents that looks like this:

<link rel="alternate" type="application/atom+xml" title="News" href="/feed">

You can add this to your <head> through a partial view.

@include('feed::links')

As an alternative you can use this blade component:

<x-feed-links />

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

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

使用案例

What tmd is Laravel

官方文档： Laravel 基本信息：什么是 Laravel？ | Laravel China 社区 Laravel 是 Taylor Otwell 开发的一款基于 PHP 语言的 Web 开源框架，采用了 MVC 的架构模式，在 2011 年 6 月正式发布了首个版本 —— 这是 Laravel 的第一个 Commit。由于 Laravel 具备 Rails 敏捷开发等优秀特质，深度集成 PH
laravel笔记-laravel-db_facade

Laravel提供了 DB facade(原始查找) 查询构造器 Eloquent ORM 三种操作数据库方式 DB facade(原始查找)】使用DB facade实现CURD //查询 $student = DB::select('select * from student'); echo '<pre>'; print_r($student); /
laravel redirect

1.redirect()->to() function to($to =null ,$status=302,$header=[],$secure=null) $secure 选择http 还是https 2.redirect()->route() 3.redirect()->back() 4 .home() 指向home路由 refresh() 刷新 away() secure()类似to()方法
Beanstalkd in Laravel

概述环境：LNMP（CentOS7.2 + Nginx1.10 + MariaDB10.0 + PHP5.6），Laravel5.1；目的：在Laravel框架上，用Beanstalkd消息队列实现异步发送邮件；预备知识：Laravel框架基本编程；使用Laravel自带的Mail功能发送邮件；正文一般来说消息队列有两种场景，一种是发布者订阅者模式，一种是生产者消费者模式。本文讨论的通过