踩过雷的phpcms迁移过来人：页面错位修复超详细教程

前言：我跟phpcms迁移错位的那场“三天三夜拉锯战”

家人们谁懂啊！上个月把公司那个“传家宝级”phpcms老站从阿里云迁到腾讯云轻量，本来以为点个一键搬家工具就喝奶茶躺赢，结果搬完点开首页——嚯！跟喝醉酒踩了地雷炸碎的积木墙似的：导航栏从“正襟危坐一排站”变成“歪歪扭扭挤一团滚楼梯”，产品图片要么缩成“芝麻粒表情包”要么放得“比村口大爷的广场舞扇子还大”，底部联系电话直接飞到了浏览器右下角当“弹窗广告钉子户”！

那三天我熬得眼睛红得像刚啃完火锅底料里的小米辣，各种查phpcms官方论坛的远古帖（真的是远古，2018年之后就没怎么更新官方正经帖了），逛了不下20个站长群蹲大佬救场，终于把这堆“炸碎的积木”拼回去了！今天必须把phpcms迁移后页面错位修复的所有靠谱坑和超有用的小技巧一股脑全塞给你们——别再跟我似的当“熬夜修积木的苦逼站长”！

错位第一弹：积木的“图纸”没搬对——静态资源路径挂了！

怎么判断是不是图纸（静态资源）的问题？

太简单了！按一下电脑上的F12键（手机的话…手机别看了赶紧找电脑！phpcms修复还是得靠电脑端的“积木维修站”开发者工具），点开Network（或者叫“网络”，根据浏览器语言换），然后刷新一下错位的页面！

看到那些标着红色感叹号或者404 Not Found的文件没？文件名带.css、.js、.jpg、.png、.gif的，99.99%都是“传家宝图纸”——也就是咱们phpcms老站的样式、脚本、图片资源的路径出错啦！

那怎么把图纸（路径）掰正？两个傻瓜级操作！

• 操作1：检查phpcms后台的“系统设置→站点配置”！

  这个是最最最容易踩的低级雷！一键搬家工具有时候会“偷懒”，只搬了数据库和文件，没给你改后台里存的“积木仓库地址”（也就是网站URL）！

  步骤给你列得明明白白：

  1. 先登录你的phpcms新后台（别告诉我你连新后台地址都找不到！一般是域名/admin.php，要是改过后台入口文件名就找你自己的笔记！找不到笔记？那继续熬吧…开玩笑，赶紧翻旧服务器的备份文件找后台文件夹的入口！）
  2. 依次点开系统设置→站点管理→编辑站点！
  3. 找到站点域名、网站地址这两个空栏！把旧域名（比如old.com）全改成新域名（比如new.com）！记得加上http://或者https://！别漏“s”！别漏斜杠？不对斜杠一般不用加，具体看你旧站的设置，照搬旧站的格式就行，只换域名！
  4. 最重要的一步来了！别直接退出！点完确定保存之后，一定要去生成管理里把全站静态页面、全站CSS缓存、全站JS缓存全！部！清！空！重！新！生！成！

• 操作2：改根目录下的caches/configs/system.php！

  如果后台改了还是没用？那大概率是一键搬家工具连配置文件里的“仓库暗地址”（也就是硬编码的路径）都没改！

  找个靠谱的文本编辑器（别用记事本！会给你加乱七八糟的乱码！推荐用VS Code、Sublime Text、Notepad++都行），打开新站根目录下的caches/configs/system.php！

  然后用编辑器的全局查找替换功能！把所有的旧域名（比如old.com，包括http://old.com、https://old.com、不带协议的//old.com）全！部！替！换！成！新域名！

  替换完记得保存文件！然后再去生成管理里清！空！所！有！缓！存！重！新！生！成！全！站！静！态！

  家人们！这一步做完，80%的phpcms迁移后页面错位问题都能解决！剩下20%才是“积木零件本身坏了”或者“零件尺寸不对”的硬骨头！但别慌！硬骨头我也啃过！接着往下看！

错位第二弹：积木零件的“包装尺寸”错了——文件权限没调对！

怎么判断是不是包装尺寸（文件权限）的问题？

还是F12“积木维修站”Network标签！刷新之后有没有看到403 Forbidden的静态资源文件？有！那就是零件（文件）被保安（服务器权限）锁起来了！新站的服务器打不开这些被锁的零件，当然就拼不出好看的积木墙啦！

那怎么给保安塞“钥匙”（调文件权限）？

要是用的是宝塔面板？那就太简单了！

步骤：

1. 登录你的宝塔面板！
2. 找到文件→进入你的新站根目录！
3. 找到phpcms、statics、uploadfile这三个文件夹！这三个是“核心零件仓库”！必须解锁！
4. 右键点击这三个文件夹→权限→把权限改成755！然后勾上应用到子目录、应用到子文件！点确定！
5. 要是改完755还是不行？就试试777！不过777是“全开放钥匙”，有点不安全！用完之后记得改成755！除非你是个“心大不怕偷零件的站长”！

要是没用宝塔面板？用的是FTP工具（比如FileZilla）？也一样！连接到你的新站服务器→找到那三个核心文件夹→右键属性→把权限改成755或者777→勾上递归更改子目录和文件→确定！

家人们！这一步又能解决剩下10%的phpcms迁移后页面错位问题！现在只剩10%的“终极硬骨头”了！别放弃！曙光就在前方！坚持就是胜利！phpcms迁移后页面错位修复其实超简单的！

错位第三弹：数据库里的“积木摆放图纸副本”错了——数据库路径没同步！

怎么判断是不是副本（数据库）的问题？

前两步都做了！还是有个别图片是“芝麻粒”或者“广场舞扇子”？或者个别内页错位？那大概率是数据库里存的“内页、产品的个性化图纸副本”（也就是文章内容、产品内容里硬编码的图片、样式路径）没改！

那怎么改副本（数据库）里的路径？

要是用的是宝塔面板的phpMyAdmin？那就跟喝水似的简单！

步骤：

1. 登录你的宝塔面板！
2. 找到数据库→找到你的新站对应的数据库→点击管理→进入phpMyAdmin！
3. 点击SQL标签！
4. 然后输入这段SQL代码： ``` UPDATE `v9_news` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); UPDATE `v9_news_data` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); UPDATE `v9_product` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); UPDATE `v9_product_data` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); UPDATE `v9_picture` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); UPDATE `v9_picture_data` SET `content`=REPLACE(`content`, 'old.com', 'new.com'); ```
5. 注意注意！上面代码里的old.com要全改成你的旧域名！new.com要全改成你的新域名！还有v9_这个前缀！要是你旧站phpcms安装的时候改了数据库前缀（比如改成了abc_），那所有的v9_都要改成你的前缀！
6. 输入完检查三遍！别写错！然后点击执行！
7. 执行完之后！再去生成管理里清！空！所！有！缓！存！重！新！生！成！全！站！静！态！

要是没用宝塔面板？用的是其他数据库管理工具？步骤也差不多！找到SQL执行框→输入替换好的代码→执行→清缓存→生成静态！

家人们！这10%的终极硬骨头也啃完啦！现在刷新一下你的新站！看看是不是跟旧站一模一样！甚至比旧站还快！（毕竟新服务器配置好嘛）

土味正能量收尾：站长不易，但拼完积木超有成就感！

做站长这几年，真的踩过N个雷：有phpcms升级失败的雷，有被黑挂马的雷，有服务器跑路的雷，当然这次的phpcms迁移后页面错位修复雷是踩得最“惊心动魄”但也最“收获满满”的！

其实不管是做网站还是做其他事，遇到问题别慌！别直接放弃！静下心来一步一步找原因！一步一步解决！就像拼积木一样！哪怕一开始炸得稀碎！只要找到图纸！找到零件！给零件开锁！改好副本！总能拼出属于自己的完美积木墙！

最后再重复三遍重要的事情：phpcms迁移后页面错位修复第一步先改后台站点配置！第二步再改system.php配置文件！第三步再改数据库！清缓存！生成静态！清缓存！生成静态！清缓存！生成静态！

祝所有的站长家人们网站越做越好！流量越来越大！赚钱越来越多！phpcms迁移后页面错位修复再也不踩雷！