本文详解 php 中使用 curl 发起 http 请求时设置自定义 user-agent 的方法，重点解决因变量作用域导致的“undefined variable”错误，并提供可直接运行的安全示例代码。
在 PHP 中通过 cURL 模拟浏览器请求时，很多目标服务器会校验 User-Agent 头以识别客户端类型。若未显式设置，cURL 默认使用类似 curl/7.x.x 的标识，易被防火墙或反爬策略拦截。而初学者常犯的一个典型错误，是在函数内部引用外部定义的变量（如 $agent），却未将其引入函数作用域，从而触发 Undefined variable $url 或 Undefined variable $agent 等 Notice 错误。
根本原因在于：PHP 函数具有独立作用域，外部变量默认不可访问。上例中 $agent 在函数外声明，但 file_get_contents_curl() 内直接使用 $agent，PHP 无法解析该变量，进而可能连带引发对 $url 的误报（尤其在调试信息混杂时）。
✅ 正确做法是：将 User-Agent 字符串直接作为字符串字面量传入 curl_setopt()，或通过函数参数/use 闭包方式安全传递。推荐首选前者，简洁、无作用域风险：
getMessage(); } ?>
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 勿在生产环境禁用 SSL 验证（CURLOPT_SSL_VERIFYPEER => false）：应配合 CURLOPT_CAINFO 指向可信 CA 证书包；
- User-Agent 字符串需符合规范：建议使用主流浏览器真实 UA，避免过于陈旧（如 IE6）或格式错误，否则可能被拒绝；
- 始终检查 curl_exec() 返回值：失败时返回 false，需配合 curl_error() 排查；
- 如需动态 UA，可通过函数参数传入：function file_get_contents_curl($url, $userAgent = '')，再在 curl_setopt() 中使用 $userAgent。
总结：设置自定义 User-Agent 的核心是确保字符串值在 curl_setopt($ch, CURLOPT_USERAGENT, ...) 调用时有效且可访问。规避作用域陷阱最稳妥的方式是直接内联字符串，既清晰又健壮。
