使用Facebook PHP SDK上传线索生成表单封面照片报错求助

问题描述 #

上传封面照片时持续触发错误：

(#100) Param cover_photo must be a file with one of the following types: image/jpeg, image/gif, image/png. Received file of type 'application/octet-stream'.

直接传递文件路径或普通CurlFile均无法解决，使用CurlFile时还会抛出“operation aborted by callback”错误。

问题根源 #

• 直接传文件路径时，SDK无法正确识别文件的MIME类型，默认被识别为application/octet-stream
• 手动创建CurlFile时未明确指定正确的MIME类型和文件扩展名，导致Facebook服务器无法识别图片类型
• 临时文件无对应图片后缀，进一步影响类型识别

解决方案 #

方案1：使用SDK内置的FacebookFile类（推荐） #

Facebook PHP SDK提供的FacebookFile类会自动处理MIME类型和文件信息，与SDK请求逻辑兼容更好：

$data = array_filter(
     array(
         LeadgenFormFields::NAME => $task['name'],
         LeadgenFormFields::QUESTIONS => $task['questions'],
         LeadgenFormFields::FOLLOW_UP_ACTION_URL => $task['followUpActionUrl']
         )
);

if (isset($task['coverPhotoUrl'])) {
    $fileContent = file_get_contents($task['coverPhotoUrl']);
    // 从图片URL提取扩展名，或根据内容判断类型
    $pathInfo = pathinfo(parse_url($task['coverPhotoUrl'], PHP_URL_PATH));
    $extension = $pathInfo['extension'] ?? 'jpg';
    
    // 创建带扩展名的临时文件
    $tmpFileName = tempnam(sys_get_temp_dir(), 'fb_lead_cover') . '.' . $extension;
    
    if (file_put_contents($tmpFileName, $fileContent) === false) {
        throw new Exception("Failed to write the cover photo to temporary file: " . $tmpFileName);
    }

    // 用FacebookFile包装文件
    $data["cover_photo"] = new \Facebook\FacebookFile($tmpFileName);
}

$page = new Page($task["facebookPageId"]);
$leadForm = $page->createLeadGenForm([], $data);

方案2：手动配置CurlFile并指定MIME类型 #

如果不使用FacebookFile，需明确指定MIME类型和扩展名：

$data = array_filter(
     array(
         LeadgenFormFields::NAME => $task['name'],
         LeadgenFormFields::QUESTIONS => $task['questions'],
         LeadgenFormFields::FOLLOW_UP_ACTION_URL => $task['followUpActionUrl']
         )
);

if (isset($task['coverPhotoUrl'])) {
    $fileContent = file_get_contents($task['coverPhotoUrl']);
    
    // 检测图片实际MIME类型
    $finfo = new finfo(FILEINFO_MIME_TYPE);
    $mime = $finfo->buffer($fileContent);
    
    // 映射MIME到对应扩展名
    $extensionMap = [
        'image/jpeg' => 'jpg',
        'image/png' => 'png',
        'image/gif' => 'gif'
    ];
    if (!isset($extensionMap[$mime])) {
        throw new Exception("Unsupported image type: {$mime}");
    }
    $extension = $extensionMap[$mime];
    
    // 创建带扩展名的临时文件
    $tmpFileName = tempnam(sys_get_temp_dir(), 'fb_lead_cover') . '.' . $extension;
    
    if (file_put_contents($tmpFileName, $fileContent) === false) {
        throw new Exception("Failed to write the cover photo to temporary file: " . $tmpFileName);
    }

    // 创建带正确参数的CurlFile
    $data["cover_photo"] = new CURLFile($tmpFileName, $mime, "cover_photo.{$extension}");
}

$page = new Page($task["facebookPageId"]);
$leadForm = $page->createLeadGenForm([], $data);

额外注意事项 #

• 提前验证下载的图片内容，确保是image/jpeg、image/png或image/gif类型
• 临时文件必须添加对应图片扩展名，避免类型识别失败
• SDK版本在v5及以上时优先使用FacebookFile，可避免回调相关错误

内容的提问来源于stack exchange，提问作者Murat Colyaran