船说 CMS 安装提示环境不满足怎么办

学完这篇，你能对着船说 CMS 的「环境检测」页逐项排查，把 PHP 版本、PHP 扩展、目录权限这几类问题改到全部显示「通过」，顺利进到下一步。

第一步：先读懂检测页到底卡在哪一项

这一步的目标是拿到一份「不通过清单」，后面所有操作都是照着这份清单做的。

打开安装向导，第一个页面就是环境检测，每一项后面都有状态：绿色对勾是满足，红色叉是不满足。常见条目有 PHP 版本、PDO、PDO_MySQL、MBstring、cURL、GD 或 Fileinfo、OpenSSL、Zip，以及 runtime、public/uploads、config、data 这几个目录的写权限。

把标红的项挨个记下来，不要直接点「下一步」跳过。

注意：部分版本允许跳过检测继续装，装完的表现是后台首页空白、上传图片失败或登录报错，根因就是当时跳过的项。

第二步：确认网站实际用的是哪个 PHP 版本

这一步是解决「明明装了 7.4，检测页却说版本不够」的问题，改完重新打开安装页，版本那一行会变绿。

宝塔面板：左侧「网站」→ 找到站点 → 点「设置」→「网站目录」上方的「PHP版本」下拉框，看当前选的是哪个；再看「软件」→「软件商店」→「已安装」，确认装了哪些 PHP 版本。要换成 7.4，就在那个下拉框里选 PHP-74，保存后刷新安装页。

小皮面板：网站 → 站点右侧「管理」→「PHP版本」。

LNMP 命令行环境：编辑 /usr/local/nginx/conf/vhost/你的域名.conf，把 fastcgi_pass unix:/tmp/php-cgi-70.sock; 改成目标版本的 sock 文件，然后执行 lnmp restart。

注意：php -v 显示的是命令行版本，和网站跑的不是一回事，别拿它当依据。

第三步：补上缺失的 PHP 扩展

这一步解决 PDO_MySQL、fileinfo、curl、mbstring、gd、zip 这些扩展没装的问题，装完检测页对应项会变绿。

宝塔：软件商店 → 已安装 → 找到对应 PHP 版本 → 点「设置」→ 左侧「安装扩展」→ 勾选缺失的扩展 → 点「安装」，等任务队列跑完。

命令行：Debian/Ubuntu 执行 apt install php7.4-mysql php7.4-mbstring php7.4-curl php7.4-gd php7.4-xml php7.4-zip，CentOS 执行 yum install php74-php-mysqlnd php74-php-mbstring php74-php-gd php74-php-zip，装完 systemctl restart php-fpm。

手动改配置：找到 php.ini，把 ;extension=pdo_mysql 前面的分号删掉。php.ini 位置可以在站点根目录建一个 t.php，内容写 <?php phpinfo();，浏览器访问后在页面里搜「Loaded Configuration File」。

注意：改完 php.ini 必须重启 PHP-FPM（宝塔在 PHP 设置里点「重载配置」或「重启」），只重启面板没用。

第四步：检查被禁用的函数

这一步解决「函数被 disable_functions 禁用」这类报错。

在 php.ini 里搜 disable_functions，把 symlink、putenv、exec、proc_open 这类被列进去的函数名删掉，保存并重启 PHP。虚拟主机改不了 php.ini 的，去面板的「PHP设置」→「禁用函数」里删。

第五步：给目录写权限

这一步解决 runtime、uploads 显示不可写的问题。Linux 下假设 PHP 运行用户是 www：

chown -R www:www /www/wwwroot/你的域名
chmod -R 755 /www/wwwroot/你的域名
chmod -R 777 /www/wwwroot/你的域名/runtime
chmod -R 777 /www/wwwroot/你的域名/public/uploads

Windows 服务器右键目录 →「属性」→「安全」→ 给 IIS_IUSRS 加「修改」和「写入」权限。

注意：整站 777 有安全风险，安装完成并确认正常运行后，把 runtime、uploads 之外的目录改回 755。

第六步：数据库那一项连不上

如果检测页提示数据库连接失败，检查主机（localhost 或 127.0.0.1）、端口（默认 3306）、库名、用户名、密码五项。宝塔在「数据库」里点「添加数据库」，用户和库名一般同名。MySQL 8 若报认证插件错误，执行 ALTER USER '用户名'@'localhost' IDENTIFIED WITH mysql_native_password BY '密码'; 再刷新。

小结

• 先记下检测页所有标红项，再逐项修，别跳步。
• PHP 版本看站点绑定的那一个，不是 php -v 的输出。
• 缺扩展用面板一键装或包管理器装，改 php.ini 后必须重启 PHP-FPM。
• runtime 和 uploads 要写权限，其余目录装完改回 755。
• 数据库连接失败先核对主机、端口、认证插件三个点。