当前位置:网站首页 >  攻略

PHPCMS域名更换配置设置 新手零报错实操避坑全指南

时间:2026年05月24日 11:35:06 来源:易频IT社区

说真的兄弟萌,我前阵子刚给手里3个老站做了PHPCMS域名更换配置设置,踩的坑能凑齐一副扑克牌,连吃3天泡面才把所有问题捋顺,今天把掏心窝子的经验甩给你们,看完你做PHPCMS域名更换配置设置连报错的机会都没有。咱先打个比方啊,PHPCMS就像你开了五六年的社区小卖部,旧域名就是原来的门牌号,换域名就等于整条街整改换了新门牌号,你得把营业执照、老客户通知、进货地址、门口的指路牌全换成新的,不然不是人找不着你,就是货送错地方,今天咱就按这个逻辑一步步来,稳得一批。

第一步:先给你的PHPCMS做个“全身体检备份”

咱老祖宗说的晴天备伞没毛病,这步就相当于你搬家前先给所有家当买个巨额保险,真搞崩了也能一键还原,不至于哭天抢地找不着北。我上次做PHPCMS域名更换配置设置就是嫌麻烦没备份自定义模板,改完之后首页串页、列表页乱码,折腾3小时才找回来,泡面都泡胀成粥了也没吃上热的。

要备份的东西一共两样,别漏:

  • 数据库全量备份:进PHPCMS后台,点「扩展-数据库工具-备份数据库」,所有数据表全选,备份完成之后一定要把压缩包下载到本地存好,别光存在服务器上,万一服务器炸了哭都没用。
  • 全站核心文件备份:根目录下的configs配置文件夹、attachment附件文件夹、你自己改的templates模板文件夹,这三个单独拷一份存本地,其他文件要是改过也顺手备份,没坏处。

第二步:改核心配置文件,相当于给小卖部换营业执照地址

这步是基础中的基础,就像你换了门牌号先去工商局改营业执照信息,不然你挂了新牌子,官方系统里还是旧地址,查你无证经营直接给你封店。我上次帮我表哥做PHPCMS域名更换配置设置,他漏改了多站点的子站配置,3个二级站全跳回旧域名,客户以为他搞诈骗直接给投诉到工信部,笑了我半个月。

要改的配置文件都在configs文件夹里:

  1. 首先改config.php:找到$config['siteurl']参数,把里面的旧域名换成新域名,注意之前带不带http/https、末尾带不带斜杠,你就按原来的格式改,别瞎加东西,比如之前是http://www.old-domain.com/,你就换成https://www.new-domain.com/就行。
  2. 如果是多站点版本,还要去configs文件夹下对应站点的site_xxx子文件夹里,把里面的config.php也按上面的方法改一遍,别嫌麻烦,漏一个子站就全乱。
  3. 给你们放个示例代码,照着改就行:

    ``` // 旧的站点URL配置 $config['siteurl'] = 'http://www.old-domain.com/'; // 替换成新域名的配置,格式和之前保持一致 $config['siteurl'] = 'https://www.new-domain.com/'; ```

    第三步:数据库批量替换,给所有老熟客发新地址通知

    PHPCMS域名更换配置设置 新手零报错实操避坑全指南

    你之前发的所有文章、传的所有图片、加的所有友情链接,里面全存的是旧域名,就相当于你之前给所有老客户留的都是旧门牌号,要是不批量改,人家点进来全是404,以为你跑路了直接去别家买东西。我之前有个同行做PHPCMS域名更换配置设置,傻乎乎的直接在后台搜文章手动替换,漏了附件路径,全站图片全裂了,老板追着他绕公司跑了三圈,那场面我现在想起来还笑。

    别手动改,直接进数据库执行SQL语句效率高还不会漏,我把常用的替换语句给你们整理好了,注意把表前缀换成你自己的,默认是v9_,要是你改过就换成自己的前缀,还有旧域名要写全,别漏了http/https:

    ``` -- 替换文章正文里的旧域名 UPDATE v9_news SET content = REPLACE(content,'http://www.old-domain.com','https://www.new-domain.com'); -- 替换栏目URL里的旧域名 UPDATE v9_category SET url = REPLACE(url,'http://www.old-domain.com','https://www.new-domain.com'); -- 替换附件路径里的旧域名 UPDATE v9_attachment SET path = REPLACE(path,'http://www.old-domain.com','https://www.new-domain.com'); -- 替换友情链接里的旧域名 UPDATE v9_link SET url = REPLACE(url,'http://www.old-domain.com','https://www.new-domain.com'); -- 要是有自定义模型,就把v9_news换成你自定义模型的表名,再执行一遍就行 ```

    划重点:执行SQL语句之前一定要先恢复你之前备份的数据库!真的,我见过太多手滑写错语句把数据库搞崩的,稳字当头,小心驶得万年船,备份做的好,媳妇回家早啊兄弟们。

    第四步:后台缓存全清+测试,相当于开业前先试营业一天

    前面的配置全改完了,先别着急对外宣传,先把小卖部的里里外外都打扫一遍,试营业一天看看有没有啥问题。我上次做PHPCMS域名更换配置设置,忘了更新静态页,首页显示的还是旧域名的链接,搜索引擎爬了三天才反应过来,亏了好几个关键词排名,给我悔的肠子都青了。

    要做的操作一共3步:

    • 全量更新缓存:进PHPCMS后台右上角点「更新缓存」,等缓存更新完成之后,再去「内容-发布管理-更新URL」,把全站内容的URL全更新一遍。
    • 更新静态页:要是你开了静态化功能,就把首页、栏目页、详情页的静态文件全重新生成一遍,别留旧的静态文件,不然用户打开还是旧内容。
    • 全流程测试:先测首页能不能正常打开,再点几个栏目页、详情页,看看链接是不是都是新域名,图片能不能正常加载,再测下后台登录、用户留言、表单提交这些功能有没有问题,别光看前端能用就不管后台了。

    最后别忘了给旧域名做301重定向,就相当于在旧门牌号那放个自动指路牌,用户走旧地址直接给领到新地址,搜索引擎还能把旧域名的权重转移到新域名上,稳赚不亏。用Nginx的话直接加这段配置就行:

    ``` server { listen 80; server_name old-domain.com www.old-domain.com; 所有旧域名的请求全部301跳转到新域名对应页面 return 301 https://www.new-domain.com$request_uri; } ```

    最后给兄弟萌提几个踩过的坑,避坑小tips

    • HTTPS和HTTP别搞混:你新域名要是开了HTTPS,所有配置里就全写HTTPS,别一半HTTP一半HTTPS,浏览器报不安全警告就算了,还容易出现跨域问题,就像你新地址是东门你非得给人说西门,人家找不着肯定走啊。
    • 二级域名也要同步改:要是你有绑定二级域名的栏目或者站点,所有配置、数据库替换都要换成对应的新二级域名,别漏了,不然跳转乱的你头大。
    • 旧域名解析别着急删:换完之后至少把旧域名的解析挂1-2个月,等搜索引擎全收录新域名,用户也都记熟新地址了再删,别刚换完就急着删解析,平白无故丢一堆流量。

    说真的,PHPCMS虽然是老程序了,但只要你按我这个步骤来,PHPCMS域名更换配置设置真的没那么难,我之前也是以为要懂好多高深技术才能搞,结果踩了N多坑才发现,都是些细心就能搞定的小事。咱普通人做站,稳就完事儿了,少踩坑就是多赚钱,要是你搞的时候碰到啥奇葩问题,评论区留个言,我看到就给你解答,都是过来人,能帮一把是一把哈。

相关推荐

最新

热门

推荐

精选

标签

易频IT社区是综合性互联网IT技术门户网站,专注分享网络技术、服务器运维、网络安全、编程开发、系统架构、云计算、大数据等行业干货,实时更新IT行业资讯、零基础教程、实战案例,为IT从业者、技术爱好者提供专业的学习交流平台。

Copyright © 2021-2026 易频IT社区. All Rights Reserved. 备案号:闽ICP备2023013482号 网站地图