将 PHPCMS（通常指的是 PHPCMS V9）更换域名是一个常见需求，比如从测试环境迁移到正式环境、网站搬家或品牌调整等。以下是详细的步骤和注意事项，帮助你顺利完成 PHPCMS 换域名 的操作。

一、准备工作

在开始操作前，请确保：

1、新域名已解析并绑定服务器
2、原站点数据完整备份
3、数据库备份完整

二、换域名的步骤

步骤 1：修改配置文件中的域名设置

PHPCMS 的主要配置文件位于 `/caches/configs/` 目录下，需要修改以下文件：

1、`system.php`

php
// 打开 /caches/configs/system.php
'site_url' = 'http://newdomain.com', // 修改为你的新域名

2、`database.php`（如有必要）

如果旧数据库中包含绝对路径或旧域名，可能还需要更新数据库内容。

步骤 2：更新数据库中的域名信息

很多模块（如文章内容、附件地址、广告、友情链接等）会使用绝对路径存储 URL，因此必须替换数据库中的旧域名。

方法一：使用 SQL 替换语句

建议先备份数据库再执行！

sql
UPDATE `v9_content` SET content = REPLACE(content, 'olddomain.com', 'newdomain.com');
UPDATE `v9_category` SET url = REPLACE(url, 'olddomain.com', 'newdomain.com');
UPDATE `v9_link` SET url = REPLACE(url, 'olddomain.com', 'newdomain.com');
UPDATE `v9_banner` SET image = REPLACE(image, 'olddomain.com', 'newdomain.com');
其他相关表也做类似处理

注意：`v9_` 是默认的表前缀，根据实际情况修改；建议用 phpMyAdmin 或 Navicat 等工具操作。

步骤 3：清理缓存

PHPCMS 缓存分为系统缓存和模板缓存，更换域名后需清除以避免旧数据影响。

删除以下目录内容：

/caches/
/runtime/
/templates_c/

或者直接删除所有缓存文件夹下的内容（保留结构即可）。

步骤 4：检查后台设置

登录后台管理界面，进入以下位置确认域名是否正确：

系统设置 站点管理
检查每个站点的“域名”字段是否为新域名
检查栏目管理中的链接是否正常

步骤 5：更新伪静态规则（如有）

如果你使用了 Nginx/Apache 的伪静态规则，记得更新其中的域名部分。

例如 Nginx 示例：

nginx
if ($host != 'newdomain.com') {
rewrite ^/(.*)$ http://newdomain.com/$1 permanent;
}

三、其他注意事项

| 项目 | 备注 |

| 图片路径 | 如果图片使用了绝对路径，也要替换数据库 |
| 邮件模板 | 后台邮件通知中的链接要检查 |
| 定时任务或 API 接口 | 若调用了旧域名，也需要更新 |
| SEO优化 | 更换域名后百度等搜索引擎会重新收录，建议提交 sitemap |

四、推荐做法（一键替换脚本）

你可以写一个简单的 PHP 脚本来批量替换数据库中的域名（注意安全，运行完请删除该脚本）：

php
<?php
define('PHPCMS_PATH', realpath(dirname(__FILE__)) 、'/');
include PHPCMS_PATH 、'/phpcms/base.php';

$old_domain = 'olddomain.com';
$new_domain = 'newdomain.com';

$db = pc_base::load_model('content_model');

$tables = array(
'content',
'category',
'link',
'banner',
// 添加你需要替换的表名
);

foreach ($tables as $table) {
$dbset_table($table);
$dbquery(UPDATE ` 、$dbdb_tablepre 、$table 、` SET url = REPLACE(url, '$old_domain', '$new_domain'););
$dbquery(UPDATE ` 、$dbdb_tablepre 、$table 、` SET content = REPLACE(content, '$old_domain', '$new_domain'););
}

echo 域名替换完成;
?

五、总结

| 步骤 | 内容 |

| 1 | 修改配置文件 `/caches/configs/system.php` |
| 2 | 替换数据库中的旧域名 |
| 3 | 清除缓存 |
| 4 | 检查后台站点与栏目设置 |
| 5 | 更新伪静态规则 |
| 6 | 测试访问是否正常 |

如你提供具体的数据库表名或遇到错误提示，我可以进一步帮你分析解决。

需要我帮你生成完整的 SQL 替换脚本或配置文件示例吗？