核心原则：优先修复，谨慎绕过

环境检测是为了确保系统能正常运行。强行绕过核心检查（如数据库扩展、缓存目录写入）会导致安装后无法使用。仅在服务器权限受限且确认影响可控时，才考虑修改检测逻辑。

标准环境修复步骤

大多数检测不通过可以通过调整服务器配置解决，以下是常用操作：

1. 修复目录权限

找到提示不可写的目录，通常是 runtime、data、static 等，赋予写入权限。

chmod -R 755 /www/wwwroot/你的网站目录
chown -R www:www /www/wwwroot/你的网站目录

2. 调整 PHP 配置

如果是函数被禁用，需要在 php.ini 的 disable_functions 中移除对应函数，如 putenv、shell_exec 等，修改后重启 PHP 服务。

php -m | grep pdo  # 检查 PDO 扩展是否加载

不得已时的绕过方案（含代码示例）

如果确实无法修改服务器配置，可尝试修改检测脚本。注意：此操作可能导致后续升级覆盖或功能异常。

1. 定位检测文件

常见版本中，安装检测逻辑通常位于 install/index.php 或 install/ 目录下的相关配置文件中。

2. 修改检测逻辑

打开文件，查找环境检测数组或函数。例如找到类似以下代码：

if(!extension_loaded('pdo')) {
    echo 'PDO 扩展未安装';
    // 阻止继续安装
}

在知晓风险的前提下，可注释掉阻止安装的逻辑：

if(!extension_loaded('pdo')) {
    // echo 'PDO 扩展未安装';
    // 注意：绕过此项可能导致数据库连接失败
}

验证与后续风险

怎么验证是否生效

刷新安装页面，观察之前红色的检测项是否变绿。如果全部通过，按钮才可点击继续。安装完成后，立即测试后台登录、配置保存及静态文件生成功能。

常见坑与风险

• 权限过大：不要为了方便直接把目录设为 777，存在安全风险。
• 升级丢失：修改过检测脚本后，系统升级可能会还原文件，导致再次报错，建议备份修改过的文件。
• 假通过：强行绕过权限检查后，网站后台可能无法保存配置或生成静态文件，需逐一测试核心功能。
• 核心项不可绕：涉及数据库连接、核心扩展的检测项强行绕过通常会导致网站直接无法运行。