将Python POST请求转为PHP/curl时遇500错误，请求协助解决

我有一个可正常运行的Python脚本，通过Basic Authentication向指定URL上传XML文件并保存XML响应。但目标环境不支持Python（无CGI支持、无系统级权限），因此尝试将其转换为PHP/curl代码，目前仅收到API返回的500错误，无其他详情。故意输入错误密码时会收到未授权提示，说明认证逻辑正常。需要将可正常运行的curl命令的逻辑复现到PHP中以解决500错误。

现有代码 #

可正常运行的Python代码 #

import requests
from requests.auth import HTTPBasicAuth

url = "https://example.com/api/upload"
username = "your_username"
password = "your_password"
xml_file_path = "data.xml"

with open(xml_file_path, 'rb') as f:
    response = requests.post(url, auth=HTTPBasicAuth(username, password), files={'file': f})

with open('response.xml', 'w') as f:
    f.write(response.text)

当前PHP代码（返回500错误） #

<?php
$url = "https://example.com/api/upload";
$username = "your_username";
$password = "your_password";
$xmlFile = "data.xml";

$curl = curl_init();

curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_USERPWD, "$username:$password");

$postData = array(
    'file' => new CURLFile($xmlFile)
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postData);

$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);

echo "HTTP Code: $httpCode\n";
file_put_contents('response.xml', $response);
?>

PHP的curl响应信息 #

HTTP Code: 500
响应内容：无（空白或无详细错误提示）

可正常运行的curl命令 #

curl -u your_username:your_password -X POST -F "file=@data.xml" https://example.com/api/upload -o response.xml

解决方案 #

问题核心是PHP代码未完全对齐curl命令的请求逻辑，以下是修正后的代码及关键说明：

修正后的PHP代码 #

<?php
$url = "https://example.com/api/upload";
$username = "your_username";
$password = "your_password";
$xmlFile = "data.xml";

$curl = curl_init();

// 对齐curl命令的基础配置
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_USERPWD, "$username:$password");

// 显式指定multipart/form-data类型，与curl -F参数逻辑一致
curl_setopt($curl, CURLOPT_HTTPHEADER, array('Content-Type: multipart/form-data'));

// 正确构造文件字段：指定真实路径、MIME类型、文件名，完全匹配curl命令的@语法
$postFields = array(
    'file' => new CURLFile(
        realpath($xmlFile), 
        'application/xml', 
        basename($xmlFile)
    )
);
curl_setopt($curl, CURLOPT_POSTFIELDS, $postFields);

// 开启调试日志，方便对比请求差异
curl_setopt($curl, CURLOPT_VERBOSE, true);
$debugLog = fopen('curl_debug.log', 'w');
curl_setopt($curl, CURLOPT_STDERR, $debugLog);

$response = curl_exec($curl);
$httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
fclose($debugLog);

echo "HTTP Code: $httpCode\n";
file_put_contents('response.xml', $response);
?>

关键修正点 #

• 文件参数对齐：CURLFile明确指定文件真实路径、application/xml MIME类型和原始文件名，与curl命令隐式处理逻辑完全匹配
• 显式设置请求头：手动指定multipart/form-data类型，避免PHP自动处理时的潜在差异
• 调试日志：开启curl verbose日志，可通过curl_debug.log对比正常curl命令的请求细节，快速定位差异

兼容低版本PHP（<5.5）的方案 #

如果目标环境PHP版本低于5.5，不支持CURLFile，可使用以下兼容写法（不推荐，仅作应急）：

<?php
// 其他配置不变
$postFields = array(
    'file' => "@" . realpath($xmlFile) . ";type=application/xml"
);
curl_setopt($curl, CURLOPT_SAFE_UPLOAD, false); // 必须开启此选项
?>

内容的提问来源于stack exchange，提问作者Developer Gee