苹果CMS搬家后Apache配置全指南，五个高频故障的排查与修复

采集模块报错——连接被拒绝与数据抓取失败

报错现象： 搬家后，后台点击“采集”按钮，系统提示“无法连接到数据源”或“采集进程异常终止”，部分采集插件直接超时。

原因分析： 苹果CMS的采集模块依赖curl和allow_url_fopen，搬家后Apache的PHP配置常丢失--with-curl扩展路径，或者防火墙未放行目标采集服务器的443/80端口，更隐蔽的是，新环境中/tmp目录权限不足或open_basedir限制导致临时文件写入失败。

苹果CMS搬家后Apache配置全指南，五个高频故障的排查与修复

解决步骤：

检查PHP扩展：执行php -m | grep curl，若无输出，在php.ini中开启extension=curl，并重启Apache。
排查防火墙：运行iptables -L -n查看是否阻止外部连接，添加规则iptables -A OUTPUT -p tcp --dport 80 -j ACCEPT和443端口。
调整open_basedir：在httpd.conf或.htaccess中，将该指令的值改为/var/www/html:/tmp，确保采集脚本能写入临时文件。
测试采集源连通性：使用wget -S --spider http://采集源地址，确认网络链路通畅。

播放器无法加载——黑屏与“视频源错误”

报错现象： 前台播放页面显示播放器区域空白，控制台报错“Uncaught TypeError: player is null”或“Failed to load resource: 404”。

原因分析： 苹果CMS使用ckplayer或dplayer等前端组件，其JS/CSS文件路径依赖__ROOT__常量，搬家后，网站域名或目录结构变化，导致静态资源路径失效；另外Apache未开启mod_rewrite，使播放器组件URL无法重写。

解决步骤：

检查站点根目录常量：登录后台→系统→参数设置，确认“网站URL”为新域名，并清空runtime缓存目录。
开启Apache重写模块：执行a2enmod rewrite，然后在httpd.conf中确保AllowOverride All（针对站点目录）。
手动验证资源路径：浏览器访问http://域名/static/js/player.js，若404则检查源码中__ROOT__是否被正确编译，必要时在/application/extra下的配置文件中强制修改。
若使用HTTPS,需在Apache配置中强制跳转并重写资源为绝对路径，避免混合内容被浏览器拦截。

后台登录异常——验证码不显示与登录跳转死循环

报错现象： 搬家后，后台验证码图片无法显示，输入正确账号密码后点击登录，页面刷新后仍停留在登录页，无任何错误提示。

原因分析： 验证码不显示多因GD库未安装或session.save_path权限错误；登录死循环则常因admin.php入口文件的Admin_KEY加密串与新环境不匹配，或data/admin/目录下的锁文件残留。

解决步骤：

验证GD库：在phpinfo页面检查GD支持，若无则安装php-gd扩展并重启Apache。
修复Session路径：在php.ini中设置session.save_path = "/var/lib/php/sessions"，并赋予www-data用户读写权限。
重置后台密钥：删除data/admin/install.lock和data/admin/admin.php（若存在），然后访问/admin.php重新生成密钥；或直接修改application/extra/admin.php中的admin_key为随机字符串。
检查Cookie域：在后台配置中，COOKIE_DOMAIN应留空或设为当前域名，避免导致跨域丢Session。

页面空白或乱码——首页白屏与全站中文变“？？？”

报错现象： 搬家后首页完全空白，或整个站点显示乱码（中文变成问号/方块），刷新多次偶尔出现部分页面。

原因分析： 空白页绝大多数是PHP致命错误被隐藏（display_errors关闭），根本原因可能是Mysqli扩展缺失或数据库连接参数错误；乱码则几乎均为Apache未声明UTF-8字符集，且PHP文件本身被以非UTF-8格式保存。

解决步骤：

开启调试模式：临时在index.php顶部加入ini_set('display_errors', 1); error_reporting(E_ALL);，刷新页面查看具体报错（Class 'mysqli' not found”）。
安装PHP数据库扩展：执行apt install php-mysql（Debian系）或yum install php-mysqlnd，重启Apache。
强制UTF-8输出：在httpd.conf中找到AddDefaultCharset，改为AddDefaultCharset UTF-8；同时检查所有PHP文件头部无BOM头，使用记事本另存为UTF-8无BOM格式。
清理编译缓存：删除runtime/目录下的temp和cache子目录，避免旧数组错乱。

安装环境检测不通过——红色警告与无法进入下一步

报错现象： 重新运行安装程序时，环境检测页面显示“PHP版本过低”“curl未启用”或“目录权限不可写”，即使实际已满足要求。

原因分析： 苹果CMS安装程序会读取php_sapi_name()和目录真实路径值，搬家后Apache的DocumentRoot与PHP实际解释路径不一致，或者SELinux的httpd_sys_script_ro_t策略阻止了写入。

解决步骤：

核对PHP版本：确认php -v版本高于7.3，但若Apache调用了其他版本的PHP，需修改/etc/apache2/conf-enabled/php7.4-fpm.conf中的SetHandler路径。
修改目录权限：执行chown -R www-data:www-data /var/www/html && chmod -R 755 /var/www/html，并将data/、application/、runtime/改为775。
关闭SELinux（若开启）：临时使用setenforce 0，永久修改/etc/selinux/config为SELINUX=disabled。
修改安装检测文件：若仅为误报，可编辑install/install.lock（删除）及install/index.php，跳过环境检测直接填写数据库信息，但仅限已知环境安全时操作。