amanch / facebook-graph-sdk
此软件包最新版本(5.x-dev)没有可用的许可证信息。
PHP Facebook SDK
5.x-dev
2024-04-04 12:25 UTC
Requires
- php: ^5.4|^7.0|^8.0|^9.0
Requires (Dev)
- guzzlehttp/guzzle: ~7.0
- mockery/mockery: ~1.0
- phpunit/phpunit: ~9.0
Suggests
- guzzlehttp/guzzle: Allows for implementation of the Guzzle HTTP client
- paragonie/random_compat: Provides a better CSPRNG option in PHP 5
This package is not auto-updated.
Last update: 2024-09-20 12:48:43 UTC
README
此存储库包含一个开源PHP SDK,允许您从您的PHP应用程序访问Facebook平台。
安装
Facebook PHP SDK可以使用Composer安装。运行以下命令
composer require facebook/graph-sdk
请注意,当与Guzzle 6.x一起使用时,可能会出现问题。php-graph-sdk v5.x仅与Guzzle 5.x兼容。但是,这里有一个解决方案使其与Guzzle 6.x兼容。
升级到v5.x
从v4.x升级?Facebook PHP SDK v5.x引入了破坏性更改。在升级之前,请阅读升级指南。
用法
注意:此版本的Facebook PHP SDK需要PHP 5.4或更高版本。
用户个人资料简单GET示例。
require_once __DIR__ . '/vendor/autoload.php'; // change path as needed $fb = new \Facebook\Facebook([ 'app_id' => '{app-id}', 'app_secret' => '{app-secret}', 'default_graph_version' => 'v2.10', //'default_access_token' => '{access-token}', // optional ]); // Use one of the helper classes to get a Facebook\Authentication\AccessToken entity. // $helper = $fb->getRedirectLoginHelper(); // $helper = $fb->getJavaScriptHelper(); // $helper = $fb->getCanvasHelper(); // $helper = $fb->getPageTabHelper(); try { // Get the \Facebook\GraphNodes\GraphUser object for the current user. // If you provided a 'default_access_token', the '{access-token}' is optional. $response = $fb->get('/me', '{access-token}'); } catch(\Facebook\Exceptions\FacebookResponseException $e) { // When Graph returns an error echo 'Graph returned an error: ' . $e->getMessage(); exit; } catch(\Facebook\Exceptions\FacebookSDKException $e) { // When validation fails or other local issues echo 'Facebook SDK returned an error: ' . $e->getMessage(); exit; } $me = $response->getGraphUser(); echo 'Logged in as ' . $me->getName();
完整的文档、安装说明和示例在此处可用。
测试
- Composer是运行测试的先决条件。全局安装composer,然后运行
composer install
来安装所需的文件。 - 在Facebook开发者上创建一个测试应用程序,然后从
tests/FacebookTestCredentials.php.dist
创建tests/FacebookTestCredentials.php
,并将其编辑为添加您的凭据。 - 从根目录运行此命令可以执行测试
$ ./vendor/bin/phpunit
默认情况下,测试将向Graph API发送实时HTTP请求。如果您没有网络连接,可以通过排除integration
组来跳过这些测试。
$ ./vendor/bin/phpunit --exclude-group integration
贡献
为了接受贡献,您必须首先签署贡献者许可协议。有关详细信息,请参阅CONTRIBUTING。
许可证
有关更多信息,请参阅许可证文件。
安全漏洞
如果您发现了一个安全问题,请直接联系维护者me@sammyk.me。