PHP cURL 代理接入示例
使用 PHP cURL 扩展、账密环境变量和连接超时完成代理请求。
只只HTTP技术团队维护更新于 2026年7月31日
PHP 服务可以使用 cURL 扩展配置代理主机、端口和认证，凭据不需要拼接到目标 URL 中。
前置条件
- PHP 运行环境已启用 cURL 扩展。
- 通过受控环境注入
PROXY_HOST、PROXY_PORT、PROXY_USERNAME和PROXY_PASSWORD。 - 生产环境关闭包含敏感请求信息的详细调试输出。
完整示例
<?php
$handle = curl_init('https://<public-test-host>/ip');
curl_setopt_array($handle, [
CURLOPT_PROXY => getenv('PROXY_HOST'),
CURLOPT_PROXYPORT => (int) getenv('PROXY_PORT'),
CURLOPT_PROXYTYPE => CURLPROXY_HTTP,
CURLOPT_PROXYUSERPWD => sprintf(
'%s:%s',
getenv('PROXY_USERNAME'),
getenv('PROXY_PASSWORD')
),
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_RETURNTRANSFER => true,
]);
$body = curl_exec($handle);
if ($body === false) {
$message = curl_error($handle);
curl_close($handle);
throw new RuntimeException($message);
}
$status = curl_getinfo($handle, CURLINFO_RESPONSE_CODE);
curl_close($handle);
if ($status >= 400) {
throw new RuntimeException("HTTP {$status}");
}
echo $body;
预期结果
- cURL 使用 HTTP 代理访问 HTTPS 目标并返回出口信息。
- 连接最长等待 10 秒，整个请求最长等待 30 秒。
- 业务代码同时检查传输错误和 HTTP 状态。
错误处理
- 407 优先检查
CURLOPT_PROXYUSERPWD对应的账密是否完整。 - 连接超时先检查代理地址、端口和服务器出口网络。
- TLS 错误不应通过关闭证书校验来掩盖。
安全提示
不要启用会记录认证头的公开调试日志。异常上报前移除代理 URL、代理用户名和密码，只保留 cURL 错误码与脱敏上下文。
这篇内容解决了你的问题吗？
反馈只用于改进公开文档，不会提交账号或请求信息。