使用PHP Graph API发布图文至Facebook页面仅显示文字，如何解决？

我之前也踩过这个坑，核心问题在于图片上传的方式不符合Graph API的要求——Facebook要求上传图片时必须以multipart/form-data格式提交文件内容，而不是直接传递文件路径。结合你的场景，下面是具体的解决方案：

先确认两个必要前提 #

在调整代码前，请先确保满足这两个关键条件：

• 你的页面访问令牌拥有pages_manage_posts和pages_show_list权限（可以在Graph API Explorer里验证令牌的权限列表）。
• 你使用的是页面访问令牌，而非普通用户访问令牌（用户令牌无法直接以页面身份发布内容）。

正确的代码实现（使用官方PHP SDK） #

如果你用的是Facebook官方PHP SDK v5+，这是最稳妥的实现方式：

require_once 'vendor/autoload.php';

// 初始化SDK
$fb = new Facebook\Facebook([
  'app_id' => '你的APP ID',
  'app_secret' => '你的APP密钥',
  'default_graph_version' => 'v18.0', // 建议使用最新稳定版API
]);

$pageAccessToken = '你的页面访问令牌';
$pageId = '你的页面ID';
$target_dir = 'path/to/your/image.png'; // 确保是服务器上的有效路径

// 先检查文件是否存在且可读取
if (!file_exists($target_dir) || !is_readable($target_dir)) {
    die("错误：无法读取图片文件，请检查路径或文件权限");
}

try {
    // 准备发布参数：用SDK的fileToUpload方法处理文件上传
    $postData = [
        'message' => '你的帖子文字内容',
        'source' => $fb->fileToUpload($target_dir),
    ];

    // 调用/photos端点（而非/feed），这个端点会一步完成图片上传+帖子发布
    $response = $fb->post("/$pageId/photos", $postData, $pageAccessToken);
    $graphNode = $response->getGraphNode();

    echo "发布成功！帖子ID：" . $graphNode['id'];
} catch(Facebook\Exceptions\FacebookResponseException $e) {
    echo "Graph API错误：" . $e->getMessage();
} catch(Facebook\Exceptions\FacebookSDKException $e) {
    echo "SDK错误：" . $e->getMessage();
}

常见错误点排查 #

1. 用错API端点：不要用/feed端点发布图片——/feed需要先把图片上传到页面相册，再引用图片URL；而/photos端点会一步完成上传+发帖，更适合你的需求。
2. 直接传文件路径：不能把$target_dir直接作为source的值，必须用SDK的fileToUpload方法或者原生CURLFile对象，这样才能把文件内容以multipart格式发送给API。
3. 文件路径/权限问题：确保$target_dir是服务器上的绝对路径（比如/var/www/html/images/photo.png），或者相对于当前PHP脚本的正确相对路径，同时PHP进程要有读取该文件的权限（可设置文件权限为644）。
4. API版本过旧：旧版本的Graph API可能存在上传兼容问题，建议使用最新的稳定版本。

原生CURL实现（不依赖SDK） #

如果不想依赖SDK，也可以用原生CURL实现，核心是用CURLFile处理文件上传：

$pageId = '你的页面ID';
$accessToken = '你的页面访问令牌';
$imagePath = 'path/to/image.png';
$message = '测试帖子内容';

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://graph.facebook.com/v18.0/$pageId/photos");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, [
    'message' => $message,
    'source' => new CURLFile($imagePath),
    'access_token' => $accessToken
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
if (isset($result['id'])) {
    echo "发布成功，帖子ID：" . $result['id'];
} else {
    echo "发布失败：" . $result['error']['message'];
}

内容的提问来源于stack exchange，提问作者Ido Naveh