ThinkPHP网页抓取环境报错主因是环境与框架启动链路断点：需统一PHP CLI与Web服务器版本（TP6.1不支持PHP 8.2+），启用cURL及依赖DLL，确保.env为UTF-8无BOM并清空runtime/config缓存，赋予runtime目录完全控制权限，且Web服务器必须正确传递PATH_INFO以支持路由。
在Windows 10或11系统上搭建ThinkPHP环境用于网页抓取时，常出现PHP版本不兼容、cURL未启用、.env加载失败、PATH_INFO丢失导致路由404、runtime目录权限异常等报错，这些错误并非代码问题，而是环境与框架启动链路的细微断点。
确认PHP CLI版本与Web服务器一致
打开命令提示符，执行 php -v，查看输出的PHP版本号；这一步必须做，因为Windows下IIS/Apache/PHP内置服务器可能调用不同PHP二进制文件，而ThinkPHP安装和运行依赖CLI环境。
若显示PHP 8.2或更高版本，但项目为TP6.1，则需降级——【TP6.1不支持PHP 8.2+，会触发Fatal error: Array and string offset access syntax with curly braces is no longer supported】。
从windows.php.net下载PHP 8.1.29（Thread Safe, x64）压缩包，解压至 C:\php81；将该路径加入系统环境变量PATH，重启终端后再次运行 php -v 确认生效。
立即学习“PHP免费学习笔记（深入）”；
Apache用户需同步修改 httpd.conf 中的 LoadModule php_module 和 PHPIniDir 指向新路径；Nginx用户需检查 fastcgi_pass 对应的php-fpm是否也运行的是同一版本。
启用cURL与关键扩展
抓取页面必须依赖cURL，但Windows版PHP默认禁用该扩展。
方法一：编辑 C:\php81\php.ini，找到 ;extension=curl 行，删掉前面的分号；同时确保 extension_dir = "ext" 路径正确（即 C:\php81\ext 存在且含 php_curl.dll）。
方法二：若启用后仍报 Call to undefined function curl_init()，说明DLL依赖缺失——需将 C:\php81 下的 libssh2.dll、ssleay32.dll、libeay32.dll 复制到 C:\Windows\System32（64位系统）或 C:\Windows\SysWOW64（32位PHP）。
重启Web服务后，创建 test_curl.php 内容为 <?php var_dump(function_exists('curl_init'));，浏览器访问验证返回 bool(true)。
强制重载.env配置避免缓存干扰
ThinkPHP抓取脚本常因.env未加载导致数据库连接失败或HTTP客户端配置为空，尤其在命令行运行 php think crawl:run 时更易复现。
第一步：用VS Code或Notepad++打开项目根目录下的 .env，确认编码为 UTF-8 without BOM；Windows记事本保存的文件100%带BOM，会导致dotenv解析器静默跳过整行。
第二步：检查 .env 是否位于与 think 可执行文件同级的目录，不是 app/ 或 public/ 下；若用composer create-project生成，它应在最外层。
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
第三步：临时在 app/command/CrawlRun.php 的handle()开头插入 dump($_ENV); exit;，执行命令观察是否输出DB_HOST等变量；若为空，说明框架根本没读取.env。
第四步：清空 runtime/container/ 和 runtime/config/ 目录（不要只清cache），这两处缓存了已解析的环境变量，旧缓存会覆盖新.env内容。
修复Windows下runtime目录写入权限
抓取任务需频繁写入日志、临时HTML、截图缓存，而Windows 10/11默认禁止非管理员进程向Program Files或用户文档外目录写入。
进入项目根目录 → 右键 runtime 文件夹 → “属性” → “安全”选项卡 → 点击“编辑” → 选中当前登录用户 → 勾选“完全控制” → 应用。
若使用Git Bash或WSL终端执行命令，还需额外赋予该终端对应用户权限；否则即使图形界面能写，php think crawl:run 仍会抛出 file_put_contents(runtime/log/crawl.log): failed to open stream: Permission denied。
验证方式：在命令行中执行 php -r "file_put_contents('runtime/test.tmp', 'ok'); echo file_get_contents('runtime/test.tmp');"，输出ok即成功。
补全PATH_INFO以支持路由匹配
抓取控制器如 app/controller/Crawl.php 中定义 index() 方法，但访问 /crawl/index 返回404，而加 /index.php/crawl/index 正常——这是Web服务器未传递PATH_INFO所致。
Apache用户：确认 .htaccess 文件存在且内容含 RewriteRule ^(.*)$ index.php/$1 [L]；检查虚拟主机配置中 AllowOverride All 已启用，而非 AllowOverride None。
Nginx用户：在server块中定位 location ~ \.php$ 区段，必须包含以下两行：
fastcgi_param PATH_INFO $fastcgi_path_info;
fastcgi_split_path_info ^(.+\.php)(/.+)$;
缺任一行都会导致 $_SERVER['PATH_INFO'] 为空，ThinkPHP路由系统无法解析模块/控制器/操作，直接返回404。
