海洋 CMS 安装页面空白是什么原因

海洋CMS 安装页面一片空白，绝大多数情况是 PHP 报了致命错误但被配置屏蔽了输出，浏览器只拿到一个空响应，所以你要做的第一件事不是重装，而是把错误打开。

为什么安装页面会「白」而不是报错？

结论：白屏不等于没出错，而是错误发生在 PHP 输出任何 HTML 之前，或者 display_errors 被关掉了。安装入口文件一旦在解析阶段就 Fatal error（比如调用了当前 PHP 不存在的函数），PHP 进程会直接中断，页面自然一个字符都不吐。还有一种情况是服务器返回了 500，但 Nginx/Apache 的错误页也被关掉，看起来同样是空白。

所以判断顺序是：先确认 HTTP 状态码是不是 500，再让 PHP 把错误吐出来，最后才去改代码或换环境。

怎么让 PHP 把错误显示出来？

结论：临时打开 display_errors 和 error_reporting，能解决八成「查不到原因」的困境。

具体做法二选一：

1. 改 php.ini：display_errors = On、error_reporting = E_ALL、log_errors = On，保存后重启 PHP，命令是 systemctl restart php-fpm（用宝塔面板的话，在「软件商店 → PHP → 设置 → 配置修改」里改，然后点重载配置）。
2. 不想动全局配置，就在安装入口文件最顶部加两行：

ini_set('display_errors', 'On');
error_reporting(E_ALL);

刷新页面，具体的报错行号和错误类型就会直接打在屏幕上。

PHP 错误日志在哪里看？

结论：线上环境更推荐看日志而不是开 display_errors，日志里的报错信息最完整。

常见路径：宝塔面板的站点日志在 /www/wwwlogs/ 下；PHP-FPM 的错误日志一般在 /www/server/php/版本号/var/log/php-fpm.log；Nginx 站点错误日志是 /www/wwwlogs/你的域名.error.log。用 tail -f 日志文件路径 实时盯着，再去刷新安装页，报错会立刻出现。重点看这几类关键词：Parse error（语法或编码问题）、Fatal error: Call to undefined function（扩展没装）、Unable to open / Permission denied（权限问题）。

PHP 版本和扩展不匹配怎么办？

结论：海洋CMS 对 PHP 版本比较敏感，用错版本是白屏的高频原因，优先检查这一项。

先查当前版本：命令行执行 php -v；再查扩展是否齐全：php -m | grep -E 'mysqli|gd|curl|mbstring|json|openssl'。数据库连接依赖 mysqli 或 pdo_mysql，验证码和缩略图依赖 gd，采集和远程请求依赖 curl。缺哪个就在面板里勾选安装，或 apt install php-mysqli php-gd php-curl（Debian/Ubuntu）、yum install php-mysqli php-gd php-curl（CentOS）。

如果程序是较老的版本，而服务器默认跑的是新版 PHP，最常见的结果就是白屏。解决办法是在面板里把站点绑定的 PHP 版本切成程序官方推荐的版本，切换后重载 PHP 再试。

目录权限和 open_basedir 会不会导致白屏？

结论：会，尤其是 data 目录不可写、或面板开了「防跨站攻击」时。

安装过程需要往数据目录写配置文件，权限不足会直接中断。做法：

• 把站点目录属主改给 Web 用户：chown -R www:www /www/wwwroot/你的目录；
• 目录权限 chmod -R 755，数据写入目录给 chmod -R 777（安装完成后建议改回更严格的权限）；
• 宝塔的「网站 → 设置 → 网站目录」里若勾选了「防跨站攻击(open_basedir)」，会把 PHP 可访问路径限制在站点目录内，跨目录调用就可能报错。排查阶段可以先关掉这个开关，装完再打开。

还有哪些容易被忽略的白屏原因？

结论：编码 BOM、加密扩展未加载、禁用函数、缓存，都会造成同样的空白现象。

• 用记事本编辑过 PHP 文件、文件头带了 UTF-8 BOM，会导致 headers already sent 或解析异常，用编辑器转成「UTF-8 无 BOM」；
• 程序文件用了 ionCube 或 Zend 加密，服务器没装对应 Loader，页面直接空白；
• disable_functions 里禁用了 scandir、file_get_contents、gethostbyname 之类函数，安装检测环节会挂掉；
• 套了 CDN 或开了页面缓存，浏览器看到的是缓存的空页面，先清缓存或用 curl -I http://你的域名/install/index.php 看真实响应。

正确的排查顺序

结论：按「看状态码 → 开错误显示/看日志 → 查 PHP 版本与扩展 → 查目录权限 → 查 BOM 与禁用函数」这个顺序走，通常十分钟内能定位。

安装时直接访问安装入口文件的完整地址，不要只访问域名根目录，避免被伪静态规则或首页跳转干扰。定位到具体报错后再动手改，比反复重装、换程序有效得多。装完之后记得删掉安装目录，并删掉临时加的 display_errors 那两行，避免线上暴露服务器信息。