README

PHP库，用于检索Instagram个人资料动态，将您授权的Instagram账户的动态嵌入到您的网站中。该库使用Instagram基本显示API，并支持自动刷新访问令牌。

要求

PHP托管（带有composer，file_get_contents()，file_put_contents()支持）
Meta开发者应用[指南]
Instagram基本显示API[指南]

安装

要安装此库，请确保您已安装并使用Composer，然后在您的命令行终端中运行以下命令

composer require yizack/instagram-feed

使用

安装此库将允许您通过导入composer自动加载来使用InstagramFeed类。

导入composer自动加载，使用命名空间Yizack\InstagramFeed并初始化InstagramFeed对象。

require "vendor/autoload.php";
use Yizack\InstagramFeed;

$feed = new InstagramFeed(
  "long-lived-access-token" // Paste your long-lived-access-token here
);

要获取您的Instagram动态数组，请使用getFeed()函数。

$array = $feed->getFeed();

或者直接在需要的地方使用foreach方法循环。

foreach ($feed->getFeed() as $value) {
    // your code
}

getFeed()函数还接受一个逗号分隔的返回字段列表。

$array = $feed->getFeed("username,permalink,timestamp,caption,media_url");

有关所有可用字段的列表，请参阅：https://developers.facebook.com/docs/instagram-basic-display-api/reference/media#fields

关于代码

`InstagramFeed`构造函数参数

`getFeed()`函数

更新最后令牌更新的日期并从Instagram账户请求动态数据。

返回一个包含最后25条帖子的数据数组，每条帖子有以下数据

长期有效访问令牌

此方法使用通过授权您的Instagram账户使用您的Meta应用获得的长期有效访问令牌。

由于长期令牌有效期为60天，并且只要它们至少有24小时且未过期，就可以刷新，因此当24小时过去时，getFeed()方法将每次调用时都会刷新您的令牌。

60天内未刷新的令牌将过期且无法刷新，因此请务必经常访问您放置动态的地方的网站。

使用示例

有关详细信息，请检查example文件夹。

要求指南

PHP托管

您可以使用任何PHP托管服务，除非它不支持file_get_contents()和file_put_contents()。

Meta开发者应用

为了使用Instagram API，我们首先必须创建一个Meta应用。按照以下步骤创建Meta应用。

转到Meta开发者网站，登录并创建应用。将应用类型选择为无。
提供您的应用详细信息。
查找Instagram基本显示产品，并单击设置以使用Instagram API。
向下滚动，直到您看到一个警告，然后单击设置以更新您的应用设置。
向下滚动并点击 添加平台 按钮。
选择平台网站。
输入您的 网站网址 并保存更改。

Instagram 基础展示 API

现在是为您的 Instagram 账号授权的时候了。

回到产品 > Instagram > 基础展示。创建新的应用。
填写 OAuth 重定向、取消授权回调和数据删除请求 URL，并使用您的网站网址保存更改。
添加 Instagram 测试者。
输入您的 Instagram 用户名并选择您的个人资料。
前往您的 Instagram 账户设置页面 > 应用和网站 > 测试者邀请，接受邀请。
回到产品 > Instagram > 基础展示 > 用户令牌生成器，您的 Instagram 账号应出现在列表中，然后点击 生成令牌 按钮进行授权并生成 Instagram 的长期访问令牌。
登录并授权应用。
点击 我理解 复选框并复制生成的令牌。
将您的令牌粘贴到您的代码中。