PrestaShop安装过程中出现错误该如何解决

按优先级从高到低排查，可覆盖绝大多数安装场景问题：

• 先开启开发模式获取真实报错。默认安装流程只会弹出通用错误提示，无法定位具体原因。找到安装目录下config/defines.inc.php文件，将define('_PS_MODE_DEV_', false);修改为define('_PS_MODE_DEV_', true);，刷新安装页面就能看到明确错误点，是扩展缺失、权限不足还是代码兼容问题可以直接定位。
• 核对运行环境是否匹配版本要求，这是安装报错占比最高的诱因：
  • PHP版本要和安装包适配：1.7.x版本适配PHP 7.1~7.4，8.x版本适配PHP 7.2及以上，盲目用PHP8.1+安装低版本PrestaShop会直接触发兼容错误。
  • 必装PHP扩展不能缺失：curl、dom、gd、json、mbstring、openssl、pdo_mysql、zip，缺任意一个都可能在安装中途中断，输出phpinfo逐一核对即可。
  • 目录权限配置正确：/config、/cache、/log、/img、/mails、/modules、/themes、/upload、/download这些目录需要给PHP运行用户开放写入权限，Linux环境设为755权限、归属对应用户即可，不要直接设777权限，会触发系统安全校验报错。
• 排查数据库配置类问题：
  • 确认填写的数据库地址、端口、账号、密码、库名完全正确，数据库账号需要拥有对应库的全部读写权限。
  • 数据库版本符合最低要求：MySQL 5.6+或MariaDB 10.0+，低于这个版本会出现SQL语法兼容错误。
  • 如果之前有过安装失败记录，先清空对应数据库里的残留表，再重新走安装流程，避免半生成的表结构引发冲突。
• 排查易被忽略的细节问题：
  • 保证安装包完整，尽量使用官方发布的完整安装包，FTP上传文件时选择二进制模式，避免文件传输损坏；如果是本地上传后解压，核对文件数量不要有缺失。
  • 临时关闭服务器WAF、自定义安全防护规则，部分拦截规则会阻断安装过程的请求导致流程中断。
  • 用本地集成环境安装的话，检查PHP禁用函数列表，不要禁用fopen、exec这类安装流程需要调用的函数。

内容的提问来源于stack exchange，提问作者Mohamed Ali Rebai