必须指定版本号安装facebook/graph-sdk：PHP 7.0用^5.7，7.1–7.4用^5.11，8.0+用^7.0；初始化需传GuzzleHttp\Client；/me请求须显式声明fields；处理响应前须校验HTTP状态码和JSON结构。
直接执行 composer require 就能装，但必须指定版本号
Facebook 官方的 facebook/graph-sdk 库在 v5.7 之后彻底移除了 PHP 5.x 支持，且 v6+ 要求 PHP ≥ 7.1。如果你用的是 PHP 7.0 或更老版本，composer require facebook/graph-sdk 会默认拉取最新版并报错：Your requirements could not be resolved to an installable set of packages.
- PHP 7.0 → 用
composer require facebook/graph-sdk:^5.7 - PHP 7.1–7.4 → 推荐
composer require facebook/graph-sdk:^5.11（v5 最后一个稳定分支） - PHP 8.0+ → 可用
composer require facebook/graph-sdk:^7.0，但注意 v7 移除了Facebook\FacebookSession等旧类，API 调用方式有变化
不指定版本号容易卡在依赖冲突里，尤其当项目已含其他 SDK 或 Guzzle 版本较旧时。
Facebook\Facebook 实例初始化必须传 GuzzleHttp\Client 配置
v5.7+ 的 SDK 不再内置 HTTP 客户端，必须手动传入兼容 PSR-18 的客户端（官方推荐 Guzzle）。如果漏掉或传错，调用 $fb->get() 会直接抛出 Facebook\Exceptions\FacebookSDKException，错误信息类似：Missing required argument $httpClient
- 最简初始化：
$fb = new Facebook\Facebook([ 'app_id' => 'your-app-id', 'app_secret' => 'your-app-secret', 'default_access_token' => 'your-access-token', 'http_client_handler' => new GuzzleHttp\Client(), ]);
- 若需自定义超时或代理，传
['timeout' => 10, 'proxy' => 'http://127.0.0.1:8080']给GuzzleHttp\Client构造函数 - 别用
new \GuzzleHttp\Client([])空数组——Guzzle v7 要求至少传空 array，v6 允许 null，混用会导致运行时报错
获取用户公开资料时，fields 参数必须显式声明
Graph API v12.0+ 默认只返回 id 和 name，即使 token 有 user_posts 权限，也不自动包含 email、picture 等字段。直接调用 $fb->get('/me') 返回的数据会比预期少得多。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法：
$fb->get('/me?fields=id,name,email,picture.width(100).height(100)') - 字段名之间用英文逗号，不要空格；嵌套字段（如
picture）要用点号加括号语法 - 如果字段名拼错（比如写成
emial），Graph API 不报错，只是忽略该字段——调试时得自己核对字段名是否在 文档 中存在
Access Token 过期或权限不足时，FacebookResponse 的 getDecodedBody() 不一定可靠
SDK 的 getDecodedBody() 方法假设响应体是合法 JSON，但 Graph API 在权限错误时可能返回 HTML 登录页（比如 token 过期跳转到 login.facebook.com），这时 json_decode 会返回 null，后续调用 $response->getGraphUser() 就崩了。
- 安全做法：先检查状态码：
if ($response->getHttpStatusCode() !== 200) { /* 处理错误 */ } - 再检查响应体是否为数组：
$body = $response->getDecodedBody(); if (!is_array($body)) { throw new Exception('Invalid response body'); } - 别依赖
getGraphUser()自动解析——它内部没做健壮性校验，遇到缺失字段（如无email）会直接报Facebook\Exceptions\FacebookSDKException
Graph API 的错误响应结构不统一，有些带 error 字段，有些是重定向，有些是空体。靠 SDK 封装层兜底不现实，得自己多走一步判断。
