必须用 stream_context_create 显式设置 POST 方法、Content-Type、Authorization 和 JSON content，否则 file_get_contents 默认 GET 且缺必要头导致 400 或空响应；超时需设 timeout=30 并用 false 判断连接失败，再查 $http_response_header 定位状态码；API Key 务必通过环境变量加载，严禁硬编码。
file_get_contents 调用 DeepSeek API 时返回空或 400 错误
直接用 file_get_contents 发 POST 请求给 DeepSeek API，大概率会失败——它默认只发 GET，且不自动设置 Content-Type 和请求体。DeepSeek 的 /v1/chat/completions 接口严格校验 application/json 类型和完整 JSON body，缺一不可。
必须用 stream_context_create 构造上下文，显式声明 method、header、content：
$opts = [
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/json\r\n" .
"Authorization: Bearer YOUR_API_KEY\r\n",
'content' => json_encode([
'model' => 'deepseek-chat',
'messages' => [['role' => 'user', 'content' => '你好']],
]),
'timeout' => 30,
]
];
$result = file_get_contents('https://api.deepseek.com/v1/chat/completions', false, stream_context_create($opts));
-
header中换行必须用\r\n，单用\n在某些 PHP 版本下会被忽略 -
content必须是字符串，不能传数组——json_encode后再填进去 - 如果返回空字符串，先检查
$http_response_header（需在file_get_contents后立即读取），看是否是 401（key 错）、400（JSON 格式错）或 429（限流）
如何安全处理 file_get_contents 的超时与连接失败
DeepSeek API 响应时间波动较大，尤其在高峰时段。file_get_contents 默认无超时，可能卡死进程；而简单设 timeout 又无法区分“连接失败”和“响应慢”。
- 始终设置
'timeout' => 30，避免脚本挂起 - 调用后立刻检查返回值：
if ($result === false)表示底层连接失败（DNS 错、网络不通、SSL 握手失败），不是 API 返回错误 - 成功返回但内容为空？别急着重试——先读
$http_response_header，确认状态码是不是 503 或 504 - 不要依赖
error_get_last()，它在file_get_contents失败时不稳定，优先靠false判断 +$http_response_header辅助定位
file_get_contents vs curl：为什么这里不推荐换 curl
你可能会想：“既然这么麻烦，不如改用 curl？” 实际上，在纯 CLI 或简单 Web 场景里，file_get_contents 更轻量、更少出错点——只要你把上下文写对。
One API key for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more
下载
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
立即学习“PHP免费学习笔记（深入）”；
-
curl需手动curl_setopt设置一堆选项（CURLOPT_RETURNTRANSFER、CURLOPT_HTTPHEADER、CURLOPT_POSTFIELDS），漏一个就静默失败 -
file_get_contents的上下文结构清晰，参数集中，调试时print_r($opts)就能一眼看清发了什么 - 唯一硬伤是不支持流式响应（DeepSeek 目前也不开放 SSE），所以不需要边收边处理的场景，
file_get_contents完全够用 - 若已在线上用
curl，别为了“统一”强行切换；但新项目起步，没理由舍近求远
API Key 泄露风险与基础防护建议
file_get_contents 本身不记录日志，但如果你把 Authorization 写死在代码里，又没做任何隔离，Key 就暴露在 Git 历史、错误页面甚至 PHP 报错堆栈中。
- 绝对不要把
YOUR_API_KEY硬编码在 PHP 文件里——用环境变量：getenv('DEEPSEEK_API_KEY')或$_SERVER['DEEPSEEK_API_KEY'] - 确保
.env文件不在 Web 可访问路径下（如放在/var/www/private/.env），并用putenv("DEEPSEEK_API_KEY=" . file_get_contents('/path/to/.env'))加载（仅限 CLI） - Web 环境建议通过 PHP-FPM 的
env[DEEPSEEK_API_KEY]配置项注入，避免getenv被禁用时失效 - 哪怕只是本地测试，也养成用
openssl rand -hex 32生成临时 Key 的习惯，别用主账号 Key
DeepSeek 的 rate limit 是按 Key 绑定的，一个泄露的 Key 足以让整个服务被封停——这事没法回滚。
