laravel 11 中 curl 代理认证需在 php 层配置：启用 curl 扩展后，原生 curl 用 curlopt_proxy 和 curlopt_proxyuserpwd 设置，guzzle 则通过环境变量或 withoptions(['proxy' => 'http://u:p@h:p']) 配置，注意协议匹配、特殊字符 url 编码及 ntlm 认证支持。
在 Laravel 11 中，cURL 本身不直接由框架“启动”，而是底层 PHP 的 curl 扩展被 Laravel（如 HTTP 客户端、Guzzle、或自定义请求）调用。设置代理认证的关键在于：**让 PHP 的 cURL 请求走指定代理，并携带认证凭据**。这需要从 PHP 层配置，而非 Laravel 配置文件本身。
确认 PHP cURL 扩展已启用
Laravel 11 强制要求 curl 扩展必须启用（否则项目根本无法初始化）。验证方式：
- 运行
php -m | grep curl（Linux/macOS）或php -m（Windows），确保输出含curl - 若未启用，请检查
php.ini中extension=curl未被注释，并重启 Web 服务（PHP-FPM/Apache/Nginx）
在代码中为单次 cURL 请求设置代理认证
如果你使用原生 curl_init() 发起请求，可直接设置代理和认证选项：
Leaf Curling & Margin Scorch Diagnosis | 植物卷叶/焦边识别（干旱/病害）
下载
利用农业相机拍摄植物叶片高分辨率图像，通过AI视觉技术检测叶片卷曲方向（向上卷曲或向下卷曲）
-
CURLOPT_PROXY：指定代理地址（如"http://proxy.example.com:8080"） -
CURLOPT_PROXYUSERPWD：传入"username:password"（适用于 HTTP Basic 代理认证） - 也可拆分为
CURLOPT_PROXYUSERNAME和CURLOPT_PROXYPASSWORD（libcurl 7.52.0+）
示例：
$ch = curl_init('https://api.example.com');curl_setopt($ch, CURLOPT_PROXY, 'http://proxy.example.com:8080');
curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'myuser:mypass');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
为 Guzzle HTTP 客户端配置代理（Laravel 常用）
Laravel 默认使用 Guzzle（通过 Http facade 或 Illuminate\Http\Client\Factory）。在 config/services.php 或发起请求时传入选项：
- 使用环境变量统一管理（推荐）：
export HTTP_PROXY="http://user:pass@proxy.example.com:8080"
export HTTPS_PROXY="http://user:pass@proxy.example.com:8080"
Guzzle 会自动读取这些变量（需确保运行 Laravel 的 PHP 进程能继承环境变量） - 代码中显式配置：
use Illuminate\Support\Facades\Http;<br> Http::withOptions(['proxy' => 'http://user:pass@proxy.example.com:8080'])<br> ->get('https://api.example.com');
避免常见陷阱
代理认证失败往往不是密码错，而是细节疏漏：
- 代理协议要匹配：HTTP 代理不能用于 HTTPS 目标而不支持 CONNECT；SOCKS5 代理需用
socks5://前缀 - 用户名含特殊字符（如
@或/）必须 URL 编码，例如user%40domain:pass - 某些企业代理使用 NTLM/Kerberos 认证，PHP cURL 需编译支持
gssapi或spnego，且需额外设置CURLOPT_PROXYAUTH为CURLAUTH_NTLM - CLI 环境（如
php artisan tinker）与 Web 环境的环境变量可能不同，建议在.env中定义并在启动脚本中导出
