PHPCMS采集标题自定义替换设置 完整零门槛实操指南

准备说明

本文基于官方原版PHPCMS V9版本撰写，所有操作兼容所有主流PHPCMS二次开发版本，基础替换不需要修改任何代码，进阶自定义替换仅需修改几行代码，零门槛可落地。

第一步：进入采集节点配置页面

操作路径清晰无跳转，按顺序点击即可：

• 登录你的PHPCMS网站后台，在左侧菜单栏依次点击扩展 → 采集管理 → 管理节点
• 找到你需要配置标题替换的已有采集节点，点击节点右侧的修改按钮，进入节点配置页
• 如果还未创建采集节点，请先完成基础采集规则配置，再按照本文步骤操作，配置入口一致

第二步：找到标题替换配置入口

进入节点配置页后，点击顶部标签栏的内容采集规则，向下滚动页面，找到标题设置模块，PHPCMS默认自带基础关键词替换功能，配置入口就在标题规则输入框下方，不需要额外找其他位置。

第三步：基础多关键词替换配置（无需改代码）

这种方式适合大部分普通需求，支持批量替换多个关键词，操作步骤如下：

• 在标题设置模块找到内容替换输入框，默认PHPCMS已经标注了规则格式：旧内容=>新内容
• 每一条替换规则单独占一行，按照格式添加你的替换规则即可，多关键词替换示例：

  ```
  测试=>原创
  本站官网=>我的站点
  推广广告=>
  →·
  ```
  

• 核心注意事项，漏掉任意一点都会导致规则不生效：
  • 分隔符必须是英文半角的=>符号，不能使用中文全角的=>，也不能只写等号
  • 如果需要删除标题里的某个关键词，右侧新内容留空即可，示例中「推广广告」就会被直接删除
  • 特殊符号比如横线、点、空格都可以直接替换，不需要额外转义
  • 规则执行顺序是从上到下，如果你需要先替换大关键词再替换小关键词，按顺序排列即可
• 如果需要给所有标题统一加前缀或者后缀，不需要写在替换规则里，直接修改标题规则即可：找到标题输入框里的默认内容{$title}，如果要加前缀就改成【我的原创】{$title}，加后缀就改成{$title}_站点原创，保存即可生效
• 所有配置完成后，点击页面底部的保存节点配置按钮保存设置

进阶：自定义正则/特殊规则替换配置

如果你的需求比较复杂，比如需要按正则匹配删除内容、截断标题长度、动态替换内容，自带的替换功能无法满足，可以通过添加几行自定义代码实现，步骤如下：

• 通过FTP或者服务器后台文件管理器，打开你的站点根目录下的文件：phpcms/modules/collection/include/collection.class.php
• 在文件中搜索关键词「// 替换内容」，找到原有默认替换代码，完整原有代码如下：

  ```php
  // 替换内容
  if($nodelid['title_replace']) {
  $title_replace = explode("\r\n", $nodelid['title_replace']);
  foreach($title_replace as $v) {
  $v = explode('=>', $v);
  $title = str_replace(trim($v[0]), trim($v[1]), $title);
  }
  }
  ```
  

• 在上述这段代码的下方，添加你需要的自定义替换逻辑，这里给几个常用可直接复制的代码示例：

  ```php
  // 示例1：删除标题中所有4位数年份，比如2023年、2024年
  $title = preg_replace('/\d{4}年/u', '', $title);
  // 示例2：将标题截断为20个汉字，超出部分自动隐藏
  $title = mb_substr($title, 0, 20, 'utf-8');
  // 示例3：删除标题中所有[]括号及括号内的内容
  $title = preg_replace('/\[.?\]/u', '', $title);
  // 示例4：删除标题中所有【】括号及括号内的内容
  $title = preg_replace('/【.?】/u', '', $title);
  ```
  

• 修改完成后保存文件，上传覆盖原文件即可生效，修改前建议先备份原文件，方便出错后回滚

配置完成后测试与问题排查

效果测试方法

不需要全量采集验证，单条测试即可，步骤：回到管理节点页面，点击对应节点右侧的「测试」按钮，输入一个目标文章链接，点击采集，查看输出的标题是否符合你的替换要求，不符合再调整规则即可。

常见不生效问题排查

• 规则格式错误：检查分隔符是不是英文半角，有没有多写空格，每条规则是不是单独换行
• 缓存未更新：修改配置或代码后，到后台点击设置 → 站点管理 → 更新缓存，清除缓存后再测试
• 代码语法错误：添加自定义代码后，检查括号是不是全部闭合，PHP语法有没有错误，保存文件时必须用UTF-8无BOM编码，不能用GBK编码
• 特殊字符不匹配：自定义正则替换时，特殊符号需要加转义符\，比如匹配点要写\.，匹配美元符号要写\$

所有操作完成后，即可正常全量采集，所有标题都会自动按照你的配置完成替换，后续需要调整规则只需要修改后台配置或者自定义代码即可，不需要改动其他内容。