mixedfeed

mixedfeed

统治社交喂养的PHP库，将它们与魔术纠缠，一个PHP库来收集它们并在黑暗中束缚它们

• 使用独立的Docker服务器
  • 可用的环境变量
• 作为库安装
• 结合进料
• 使用进料而不是原始饲料
• 饲料提供商
• 修改缓存TTL
• 创建自己的饲料提供商
  • 从学说存储库中创建饲料提供商

使用独立的Docker服务器

mixedfeed

docker run -p 8080:80 \\
-e MF_FACEBOOK_PAGE_ID=\”xxx\” \\
-e MF_FACEBOOK_ACCESS_TOKEN=\”xxxx\” \\
-e MF_INSTAGRAM_USER_ID=\”xxx\” \\
-e MF_INSTAGRAM_ACCESS_TOKEN=\”xxxx\” \\
-e MF_CACHE_PROVIDER=\”apcu\” \\
-e MF_FEED_LENGTH=\”30\” \\
rezozero/ mixedfeed \”>

 docker pull rezozero/ mixedfeed

docker run -p 8080:80 \\
    -e MF_FACEBOOK_PAGE_ID=\"xxx\" \\
    -e MF_FACEBOOK_ACCESS_TOKEN=\"xxxx\" \\
    -e MF_INSTAGRAM_USER_ID=\"xxx\" \\
    -e MF_INSTAGRAM_ACCESS_TOKEN=\"xxxx\" \\
    -e MF_CACHE_PROVIDER=\"apcu\" \\
    -e MF_FEED_LENGTH=\"30\" \\
    rezozero/ mixedfeed

或使用docker-compose ：复制docker-compose.yml到docker-compose.test.yml ，并在其中填写您的提供商凭据。然后执行docker-compose -f docker-compose.test.yml up -d --force-recreate ， mixedfeed将在http：// localhost上提供：8080

可用的环境变量

作为库安装

mixedfeed V3+至少需要PHP 7.2 ，检查服务器配置。

composer require rezozero/ mixedfeed 

mixedfeed ;
use RZ\\ mixedfeed \\GraphInstagramFeed;
use RZ\\ mixedfeed \\TwitterFeed;
use RZ\\ mixedfeed \\TwitterSearchFeed;
use RZ\\ mixedfeed \\FacebookPageFeed;
use RZ\\ mixedfeed \\GithubReleasesFeed;
use RZ\\ mixedfeed \\GithubCommitsFeed;

$feed = new mixedfeed ([
new GraphInstagramFeed(
\’instagram_user_id\’,
\’instagram_access_token\’,
null ,// you can add a doctrine cache provider
[] // And a fields array to retrieve too
),
new TwitterFeed(
\’twitter_user_id\’,
\’twitter_consumer_key\’,
\’twitter_consumer_secret\’,
\’twitter_access_token\’,
\’twitter_access_token_secret\’,
null, // you can add a doctrine cache provider
true, // exclude replies true/false
false, // include retweets true/false
false // extended mode true/false
),
new TwitterSearchFeed(
[
\’#art\’, // do not specify a key for string searchs
\’from\’ => \’rezo_zero\’,
\’since\’ => \’2015-11-01\’,
\’until\’ => \’2015-11-30\’,
],
\’twitter_consumer_key\’,
\’twitter_consumer_secret\’,
\’twitter_access_token\’,
\’twitter_access_token_secret\’,
null, // you can add a doctrine cache provider
false // extended mode true/false
),
new FacebookPageFeed(
\’page-id\’,
\’app_access_token\’,
null, // you can add a doctrine cache provider
[], // And a fields array to retrieve too
null // A specific Graph API Endpoint URL
),
new GithubCommitsFeed(
\’symfony/symfony\’,
\’access_token\’,
null // you can add a doctrine cache provider
),
new GithubReleasesFeed(
\’roadiz/roadiz\’,
\’access_token\’,
null // you can add a doctrine cache provider
),
new \\RZ\\ mixedfeed \\YoutubePlaylistItemFeed(
\’your_playlist_id\’,
\’api_key\’,
null // you can add a doctrine cache provider
),
]);

return $feed->getItems(12);
// Or use canonical \\RZ\\ mixedfeed \\Canonical\\FeedItem objects
// for a better compatibility and easier templating with multiple
// social platforms.
return $feed->getAsyncCanonicalItems(12);\”>

 use RZ \\ mixedfeed \\ mixedfeed ;
use RZ \\ mixedfeed \\ GraphInstagramFeed ;
use RZ \\ mixedfeed \\ TwitterFeed ;
use RZ \\ mixedfeed \\ TwitterSearchFeed ;
use RZ \\ mixedfeed \\ FacebookPageFeed ;
use RZ \\ mixedfeed \\ GithubReleasesFeed ;
use RZ \\ mixedfeed \\ GithubCommitsFeed ;

$ feed = new mixedfeed ([
    new GraphInstagramFeed (
        \' instagram_user_id \' ,
        \' instagram_access_token \' ,
        null , // you can add a doctrine cache provider
        [] // And a fields array to retrieve too
    ),
    new TwitterFeed (
        \' twitter_user_id \' ,
        \' twitter_consumer_key \' ,
        \' twitter_consumer_secret \' ,
        \' twitter_access_token \' ,
        \' twitter_access_token_secret \' ,
        null ,  // you can add a doctrine cache provider
        true ,  // exclude replies true/false
        false , // include retweets true/false
        false  // extended mode true/false
    ),
    new TwitterSearchFeed (
        [
            \' #art \' , // do not specify a key for string searchs
            \' from \' => \' rezo_zero \' ,
            \' since \' => \' 2015-11-01 \' ,
            \' until \' => \' 2015-11-30 \' ,
        ],
        \' twitter_consumer_key \' ,
        \' twitter_consumer_secret \' ,
        \' twitter_access_token \' ,
        \' twitter_access_token_secret \' ,
        null ,  // you can add a doctrine cache provider
        false  // extended mode true/false
    ),
    new FacebookPageFeed (
        \' page-id \' ,
        \' app_access_token \' ,
        null , // you can add a doctrine cache provider
        [],    // And a fields array to retrieve too
        null // A specific Graph API Endpoint URL
    ),
    new GithubCommitsFeed (
        \' symfony/symfony \' ,
        \' access_token \' ,
        null // you can add a doctrine cache provider
    ),
    new GithubReleasesFeed (
        \' roadiz/roadiz \' ,
        \' access_token \' ,
        null // you can add a doctrine cache provider
    ),
    new \\ RZ \\ mixedfeed \\ YoutubePlaylistItemFeed (
        \' your_playlist_id \' ,
        \' api_key \' ,
        null // you can add a doctrine cache provider
    ),
]);

return $ feed -> getItems ( 12 );
// Or use canonical \\RZ\\ mixedfeed \\Canonical\\FeedItem objects
// for a better compatibility and easier templating with multiple
// social platforms.
return $ feed -> getAsyncCanonicalItems ( 12 );

结合进料

mixedfeed可以结合多个社交供稿，因此您可以循环循环它们，并使用一些常见的数据字段，例如feedItemPlatform ， normalizedDate和canonicalMessage 。 mixedfeed将通过降低normalizedDate来对所有提要项目进行排序，但是您可以将其配置为排序以上：

mixedfeed ::ASC);\”>

 new mixedfeed ([…], mixedfeed :: ASC );

每个饲料提供商都必须在提要项目中注入这三个参数：

• feedItemPlatform ：这是您的社交网络名称，即字符串，即«twitter»。缓存提要和HTML模板引擎以正确渲染每个进料项目非常重要。

例如，如果您使用的是树枝，则可以为每个社交平台包含一个子网站。

mixedfeedItems %}
{% include ‘social-blocks/‘ ~ socialItem.feedItemPlatform ~ ‘.html.twig’ %}
{% endfor %}\”>

{% for socialItem in mixedfeed Items %}
{% include ‘social-blocks/‘ ~ socialItem . feedItemPlatform ~ ‘.html.twig’ %}
{% endfor %}

• normalizedDate ：这是一个关键参数，因为它允许mixedfeed喂养用异质结构对逆时态进行逆转表。
• canonicalMessage ：这是一个有用的字段，其中包含所有平台上每个项目的文本内容。您可以使用它在简单的循环中显示项目文本。

使用进料而不是原始饲料

如果您需要再次将mixedfeed序列化为JSON或XML，则不应希望每个社交供稿项目中包含的所有原始数据。因此，您可以使用$feed->getAsyncCanonicalItems(12);方法不是getItems获得具有基本数据的更简洁的对象： RZ\\ mixedfeed \\Canonical\\FeedItem 。进料将提供这些领域：

• ID string
• 平台string
• 作者string
• 链接string
• 标题string
• 消息string
• LeakeCount int|null
• ShareCount int|null ：分享，评论或转发计数，具体取决于平台。
• 图像Image[]
  • URL string
  • 宽度integer
  • 高度integer
• DateTime DateTime
• 标签array （仅与MediumFeed一起使用）
• 如果规范项目stdClass还不够

当FeffItem具有图像时， FeedItem::$images将容纳RZ\\ mixedfeed \\Canonical\\Image对象的阵列，如果可用的话，可以更好地访问其url ， width和height 。

每个饲料提供商都必须实现如何从原始饲料覆盖createFeedItemFromObject()方法中进行进FeedItem水合。

饲料提供商

修改缓存TTL

从AbstractFeedProvider继承的每个进纸产品都可以访问setTtl()方法，以修改默认的缓存时间。默认情况下，它设置为7200秒，因此您可以将其调整为无效的学说缓存或多或少。

创建自己的饲料提供商

互联网上有很多API，此工具将无法全部处理。但这不是问题，您可以轻松地在mixedfeed中创建自己的饲料提供商。您只需要创建一个新类，该类将从RZ\\ mixedfeed \\AbstractFeedProvider继承。然后，您将必须从FeedProviderInterface实现一些方法：

• getRequests($count = 5): \\Generator方法，将Guzzle Request生成器转换为响应。这是最佳选择，因为它将启用异步请求池。
• supportsRequestPool(): bool方法。如果您使用第三方库来获取数据（例如某些平台SDK），则应将其设置为false 。
• createFeedItemFromObject($item)方法将原始的进料对象转换为规范的RZ\\ mixedfeed \\Canonical\\FeedItem和RZ\\ mixedfeed \\Canonical\\Image
• getDateTime方法在提要中查找关键的DateTime字段。
• getFeed方法可以使用计数限制消耗API端点并照顾您的响应。此方法必须将您自己的饲料项目转换为\\stdClass对象，而不是数组。
• getCanonicalMessage方法可以在提要项目中寻找重要的文本内容。
• getFeedPlatform方法可以为您的提要项目获取全局文本标识符。
• 然后，可以直接在mixedfeed初始化中使用的构造函数。

随时检查我们现有的饲料提供商，以了解其工作原理。我们强烈建议您实施一个缓存系统，不要按每个请求调用API端点。默认情况下，我们使用具有许多存储选项的学说的缓存系统。

从学说存储库中创建饲料提供商

如果您需要将社交网络供稿与自己的网站文章合并，则可以创建一个自定义的FeedProvider，将您的学说对象包裹在\\stdClass项目中。您需要使用EntityManager实现getFeed方法：

mixedfeed\\Canonical\\FeedItem();
$feedItem->setDateTime($this->getDateTime($item));
$feedItem->setMessage($this->getCanonicalMessage($item));
$feedItem->setPlatform($this->getFeedPlatform());

for ($item->images as $image) {
$feedItemImage = new RZ\\ mixedfeed \\Canonical\\Image();
$feedItemImage->setUrl($image->url);
$feedItem->addImage($feedItemImage);
}

return $feedItem;
}\”>

 protected $ entityManager ;

public function __construct ( \\ Doctrine \\ ORM \\ EntityManagerInterface $ entityManager )
{
    $ this -> entityManager = $ entityManager ;
}

protected function getFeed ( $ count = 5 )
{
    return array_map (
        function ( Article $ article ) {
            $ object = new \\ stdClass ();
            $ object -> native = $ article ;
            return $ object ;
        },
        $ this -> entityManager -> getRepository (Article::class)-> findBy (
            [],
            [ \' datetime \' => \' DESC \' ],
            $ count
        )
    );
}

protected function createFeedItemFromObject( $ item )
{
    $ feedItem = new RZ \\ mixedfeed \\ Canonical \\ FeedItem ();
    $ feedItem -> setDateTime ( $ this -> getDateTime ( $ item ));
    $ feedItem -> setMessage ( $ this -> getCanonicalMessage ( $ item ));
    $ feedItem -> setPlatform ( $ this -> getFeedPlatform ());

    for ( $ item -> images as $ image ) {
        $ feedItemImage = new RZ \\ mixedfeed \\ Canonical \\ Image ();
        $ feedItemImage -> setUrl ( $ image -> url );
        $ feedItem -> addImage ( $ feedItemImage );
    }

    return $ feedItem ;
}

然后，您可以定义日期时间和规范消息方法来查看此对象：

 /**
 * @inheritDoc
 */
public function getDateTime ( $ item )
{
    if ( $ item -> native instanceof Article) {
        return $ item -> native -> getDatetime ();
    }

    return null ;
}

/**
 * @inheritDoc
 */
public function getCanonicalMessage ( stdClass $ item )
{
    if ( $ item -> native instanceof Article) {
        return $ item -> native -> getExcerpt ();
    }

    return null ;
}