苹果CMS搬家换面板后，这五个鬼打墙问题，我闭着眼都能修好

问：搬家到新服务器，采集器一跑就报“获取远程数据失败”，或者直接超时，连官方资源库都连不上，怎么回事？

报错现象： 后台点击“采集”，进度条走两步就停，日志里全是file_get_contents(): failed to open stream: Connection timed out，或者cURL error 28: Operation timed out after 10001 milliseconds。

原因分析： 90%是新服务器PHP环境没开curl扩展，或者开了但没走代理，苹果CMS默认用的是file_get_contents采集，新面板（比如宝塔）的PHP默认allow_url_fopen是关的，而且防火墙没放行采集站点的HTTPS端口，剩下的10%是你搬家时把config.php里的maccms数据库前缀改了，导致采集临时表写入失败，但报错被PHP吞了，只显示网络错误。

解决步骤：

检查并开启扩展：登录新面板（比如宝塔），找到PHP设置，确认curl、openssl两个扩展已勾选并重载PHP-FPM，同时把allow_url_fopen改为On。
强制走CURL通道：在application/database.php里把'curl' => false改成'curl' => true，如果不生效，去application/extra/http.php确认timeout参数，把默认的5改成30。
防火墙放行：确认服务器安全组和系统防火墙（firewall-cmd --list-all或宝塔安全页面）放行了TCP出站443和80端口，否则就算代码对，连接也被拦。
重建采集缓存：在后台“采集”页面，先点“清空今日采集”，然后去runtime目录删掉collect文件夹下的所有缓存文件，再重试。

问：搬家后播放器一直转圈，换了VOD和FLV模式都黑屏，但后台看播放地址是有数据的，怎么破？

报错现象： 前台播放页面JS报错Uncaught TypeError: Cannot read properties of undefined (reading 'player')，或者Dplayer is not defined，页面框架正常，就是播放器区域空白。

原因分析： 跨域问题，老面板你用的是http://你的老域名，新面板换成了HTTPS或者IP访问，而播放器调用的资源（比如dplayer.min.js、ckplayer.js）URL协议头写死了http://，被浏览器Mixed Content（混合内容）策略拦截了，另一种可能是搬家时数据库里的web配置表里，gid对应的web_url字段没改，播放器在拼js路径时用了旧的根地址。

解决步骤：

强制替换协议头：在后台-系统-网站参数-播放器设置里，把“播放器文件URL”的http改成（自适应协议），或者直接改成你新服务器的HTTPS域名。
检查数据库残留：用phpMyAdmin打开mac_config表，搜索web_url，把值改成https://你的新域名，特别注意player_http和player_https两个字段，都改成新地址。
清缓存并强制刷新：去runtime目录删除template缓存文件夹，然后后台“清理缓存”，前台浏览器按Ctrl+F5硬刷新，顺便打开F12看Network里有没有红色的失败请求，逐条把失败文件的URL改成新域名。

问：后台登录不了，输完密码页面刷新一下又跳回登录页，连密码错误提示都不显示，什么情况？

报错现象： 登录界面一切正常，输入账号密码点登录，地址栏变成/admin.php/admin/index/login.html后立刻跳回/admin.php/admin/index/index.html，但没有报错日志。

原因分析： 典型的二次验证码或SESSION存储失效问题，苹果CMS搬家后，runtime/session目录权限不对（比如拥有者变成www，但没写权限），或者PHP配置里session.save_path指向了一个不存在/不可写的目录，如果你换了域名，但config.php里的AUTH_KEY没重新生成，会导致登录状态加密校验失败。

解决步骤：

重置SESSION目录：在服务器上执行chown -R www:www /你网站的根目录/runtime并chmod -R 755，如果目录不存在就新建，同时检查PHP的session.save_path，在宝塔里改成/tmp并重启PHP。
重置后台密钥：打开application/database.php，找到'authkey' => 'xxx'，随便改一串随机字符串（注意不能和你数据库里的mac_config的auth_user冲突），改了以后，把数据库里mac_admin表的admin_pwd字段重新用MD5加密写入（比如你原密码是123456，MD5后是e10adc3949ba59abbe56e057f20f883e）。
关闭二次验证：如果你开了谷歌验证器，在数据库中mac_config表里找admin_verify字段，设为0，然后重新登录。

问：搬家后首页能开，但一进详情页或分类页就是白屏，连错误提示都不给，刷新多次偶尔又能出来，气死人。

报错现象： 访问/vodtype/1.html直接空白，但后台访问正常，Nginx错误日志里报PHP Fatal error: Call to undefined method app\common\model\Vod::getTypeList()。

原因分析： 70%是伪静态规则没重建，苹果CMS搬家到新面板（尤其是从Apache换到Nginx），如果伪静态内容丢了，URL重写会直接把参数当成真实路径传给PHP，导致路由解析错误，另外30%是PHP版本不对——老代码用mysql_*函数会直接白屏，但新PHP7/8会抛异常，而你关了display_errors。

解决步骤：

重建伪静态：如果你用的Nginx，在站点配置的server{}段里加入下面这段（这是我老手常用的一版，兼容苹果CMS 10全系列）：
```
location / {
 try_files $uri $uri/ /index.php$is_args$args;
}
location ~ \.php$ {
 fastcgi_pass unix:/run/php.sock;
 include fastcgi_params;
}
```
保存后nginx -s reload。
升级PHP版本兼容：如果白屏依旧，到宝塔把PHP切换成7.3（苹果CMS对7.4有兼容性坑，8以上常有函数废弃问题），同时打开application/extra/environment.php，把display_errors设为true，再刷新页面看具体报哪一行代码，按报错改对应函数。
检查模板缓存：删除runtime/template下所有文件，再访问详情页，如果问题只在某个模板（比如红色主题），去模板目录里把vod/detail.html里的{$obj.type.type_name}改成{$obj.type_id|get_type_name}（这是常见的变量命名冲突）。

问：安装环境检测不通过，提示“PDO_MYSQL未启用”或“mysqli未安装”，但我明明在PHP设置里看到了啊？

报错现象： 苹果CMS安装向导第一步，红叉提示检测环境失败，但同一台服务器上phpinfo()里能看到pdo_mysql和mysqli都是ON。

原因分析： 你改了PHP版本但忘了重装扩展，宝塔面板多PHP版本共存，你安装时选的PHP7.4，但PHP设置里改的是PHP7.2的扩展，另一个原因是你手动编译过PHP，扩展路径和php.ini加载路径不匹配。

解决步骤：

逐版本核对：在宝塔“软件商店-PHP项目”列表里，确认你站点绑定的PHP版本，点击“设置”，切到“安装扩展”，勾选pdo_mysql和mysqli，点“安装”。
命令行检查：SSH执行php -m | grep pdo，看输出的是哪个PHP，如果输出为空，说明你命令行用的PHP和你网站用的不是同一个，去宝塔把站点的“PHP版本”下拉框重新选一次你正在配置的那个版本。
强制指定扩展路径：编辑你站点对应PHP版本的php.ini，确认extension_dir = "/www/server/php/74/lib/php/extensions/no-debug-non-zts-20190529/"（以实际为准），然后手动在php.ini末尾加两行：
```
extension=pdo_mysql.so
extension=mysqli.so
```
重启PHP-FPM，如果还不行，大概率是系统库里缺libmysqlclient，执行yum install -y libmysqlclient（CentOS）或apt install -y libmysqlclient21（Debian）再重装扩展。

搬完家别急着开心,先跑一遍“一键检测”，把上面五类问题按顺序过一遍，基本半小时内全搞定，如果还有奇奇怪怪的报错，十有八九是runtime目录权限或数据库编码（utf8mb4 vs utf8）没对齐，再不行就开debug模式逐行看日志，苹果CMS这老哥，最怕的不是代码复杂，而是你动了它的“家”（目录结构）。