PHPCMS采集功能常见报错的详细排查与完整实操修复指南

PHPCMS作为老牌PHP内容管理系统，大量存量站点仍在使用采集功能搬运内容，几乎所有常见采集报错都可以通过以下步骤直接修复，全程无需额外插件，零门槛操作。

一、前置检查：先确认基础环境信息

90%以上的采集报错都是环境兼容或基础配置缺失导致，修改代码前先完成以下检查，避免无效操作：

• 确认PHP版本匹配：PHPCMS V9仅兼容PHP5.3~PHP7.2，PHP7.3及以上版本会存在函数废弃、语法兼容问题，如果版本不符，直接在虚拟主机/服务器面板切换到PHP7.2即可。
• 确认必需扩展已开启：采集功能需要开启curl、dom、json三个扩展，你可以在网站根目录新建phpinfo.php文件，内容为： ```

二、报错修复1：采集节点页面空白/正则测试无响应

报错原因

该问题是因为PHP高版本下，正则测试接口输出额外内容后没有终止程序，导致JSON解析失败，前端无法正常渲染返回结果。

实操修复步骤

1. 打开文件路径：phpcms/modules/collection/node.php，找到public_test_regular()方法，在方法最后json输出后添加exit终止程序，完整修改后的方法代码如下，可直接复制替换： ``` public function public_test_regular() { $url = isset($_GET['url']) ? trim($_GET['url']) : ''; $content_rule = isset($_GET['content']) ? stripslashes($_GET['content']) : ''; $content = file_get_contents($url); preg_match($content_rule, $content, $result); exit(json_encode($result)); } ```

2. 如果修改后仍然空白，继续打开文件：phpcms/modules/collection/include/collection.class.php，找到第190行左右的调试输出代码，将其注释，修改后代码如下： ``` // echo ""; ```

3. 修改完成后保存上传覆盖，登录PHPCMS后台更新全站缓存，刷新页面即可正常使用。

三、报错修复2：采集提示获取内容失败/curl超时

报错原因

默认PHPCMS采集代码不支持HTTPS目标站点采集，同时默认配置没有设置UA，部分站点会拦截爬虫请求，此外默认超时时间过短也会导致超时报错。

实操修复步骤

打开文件路径：phpcms/modules/collection/include/collection_base.class.php，找到原有的get_html方法，直接替换为以下完整兼容代码： ``` public function get_html($url) { $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // 兼容HTTPS采集，跳过SSL证书验证 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); // 设置30秒超时，避免长时间挂起 curl_setopt($ch, CURLOPT_TIMEOUT, 30); // 伪装普通浏览器UA，避免被拦截 $user_agent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36'; curl_setopt($ch, CURLOPT_USERAGENT, $user_agent); $html = curl_exec($ch); $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); if($http_code == 200 && !empty($html)){ return $html; }else{ return false; } } ```

修改完成保存上传，该代码同时解决了HTTPS兼容、请求拦截、超时三个问题，重新测试采集即可正常获取内容。

四、报错修复3：采集完成后提示入库失败/无法保存内容

报错原因

PHP7.2及以上版本废弃了each()函数，而PHPCMS采集入库代码中使用了两个each循环，执行时会直接抛出致命错误，导致入库中断。

实操修复步骤

1. 打开文件路径：phpcms/modules/collection/collection.php，找到第一个包含each的循环，原代码替换为： ``` // 原代码 while(list($key, $val) = each($datas['data'])) { foreach($datas['data'] as $key => $val) { ```

2. 在同一文件中找到第二个包含each的循环，原代码替换为： ``` // 原代码 while(list($k, $v) = each($val)) { foreach($val as $k => $v) { ```

3. 保存上传后，更新全站缓存，重新执行采集即可正常入库。

五、修复效果验证

完成对应修改后，按照以下步骤验证：

• 1. 打开采集节点编辑页，测试正则匹配，能正常返回匹配结果即为第一个报错修复完成
• 2. 执行采集内容步骤，能正常获取到目标站点内容即为第二个报错修复完成
• 3. 执行发布入库，能正常将采集内容保存到指定栏目即为第三个报错修复完成

按照以上步骤操作，95%以上的PHPCMS常见采集报错都可以得到解决，若仍无法使用，只需检查采集规则的正则表达式是否匹配目标站点结构即可。