WordPress安装教程：PHP7.4配置详解

本文详解WordPress在PHP 7.4环境下的安装避坑指南，直击实际部署中最常导致白屏、500错误、无限跳转安装页或后台404的四大核心问题：服务器未真正绑定PHP 7.4模块、wp-config.php必须手动创建且需UTF-8无BOM编码并避免使用localhost作为DB_HOST、Nginx缺失关键重写规则（需替换为try_files $uri $uri/ /index.php?$args）、以及商业加密主题依赖的SourceGuardian SG11扩展未正确安装。每一步都附带各主流环境（Apache/Nginx/宝塔/phpEnv）的精准操作命令和验证方法，帮你绕过90%的隐性配置陷阱，真正实现开箱即用的稳定运行。

WordPress 在 PHP 7.4 下能稳定运行，但直接放上去大概率会白屏、500 错误或卡在安装页——不是 WordPress 不兼容，而是 PHP 7.4 环境缺关键配置、路径或权限。

PHP 7.4 版本确认与服务绑定

别只看 php -v 显示 7.4 就以为万事大吉。Apache/Nginx 实际调用的 PHP 模块可能仍是旧版本。

• Linux（Apache）：检查 libapache2-mod-php7.4 是否已启用，执行 a2enmod php7.4 并重启 Apache
• Linux（Nginx + PHP-FPM）：确认 Nginx 的 fastcgi_pass 指向的是 127.0.0.1:9000 或 unix:/run/php/php7.4-fpm.sock，且 php7.4-fpm 服务正在运行（systemctl status php7.4-fpm）
• Windows（phpStudy/phpEnv）：在面板中明确将站点“PHP 版本”切换为 php7.4.3nts 或更高，不能只装了没绑定
• 宝塔面板：进入网站设置 → PHP 版本，选中 7.4；再进 PHP 设置 → 禁用函数里确保没禁用 scandir、file_get_contents 等 WordPress 必需函数

wp-config.php 必须手动创建（尤其 phpEnv/宝塔/Nginx 场景）

WordPress 安装向导在 PHP 7.4 下常因权限或重写规则缺失，无法自动生成 wp-config.php，导致“缺少配置文件”或无限跳回安装页。

• 从 wp-config-sample.php 复制一份，重命名为 wp-config.php
• 用 VS Code 或 Notepad++ 保存为 UTF-8 无 BOM 编码（Windows 记事本默认带 BOM，会报错）
• 填入四行核心定义，DB_HOST 别写 localhost：

  define('DB_NAME', 'wordpress');
  define('DB_USER', 'root');
  define('DB_PASSWORD', '');
  define('DB_HOST', '127.0.0.1');

• 若 MySQL 改过端口（如 3307），写成 127.0.0.1:3307；localhost 在 Windows 或部分 Nginx 配置下会走 socket，而 phpEnv/宝塔默认不提供该 socket 文件

Nginx 重写规则缺失导致白屏或 404

Apache 默认有 .htaccess 支持，但 Nginx 不会自动读取它。WordPress 后台、固定链接、媒体上传等功能全依赖重写规则接管请求到 index.php。

• 打开 Nginx 配置文件（如 /www/server/nginx/conf/nginx.conf 或站点 conf 文件），找到 location / 块
• 把原 try_files $uri $uri/ =404; 替换为：

  try_files $uri $uri/ /index.php?$args;

• 保存后必须执行 nginx -t && nginx -s reload（宝塔点「重载配置」，phpEnv 点「重启 Nginx」）
• 漏掉这步，访问后台地址（如 /wp-admin/）会直接 404，而非跳转到登录页

SG11 扩展缺失引发加密主题报错

如果你装的是商业主题或插件，启动时出现 PHP script is protected by SourceGuardian and requires a SourceGuardian loader 'ixed.7.4.lin'，说明它用了 SourceGuardian 加密，而 PHP 7.4 缺少对应解密模块。

• 宝塔用户：PHP 7.4 的扩展列表里没有 SG11，需手动下载 ixed.7.4.lin（注意 Linux 用 .lin，Windows 用 .dll），放入 /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/
• 编辑 /www/server/php/74/etc/php.ini，末尾添加：

  zend_extension = /www/server/php/74/lib/php/extensions/no-debug-non-zts-20190902/ixed.7.4.lin

• 重启 PHP-FPM（宝塔点「重载配置」，命令行执行 service php-fpm-74 restart）
• 验证是否加载成功：php -m | grep sourceguardian 或新建 info.php 输出 phpinfo() 查看 SourceGuardian 段落

最易被忽略的是：Nginx 重写规则和 DB_HOST 写成 localhost 这两处，它们不会报具体错误，只会让整个流程静默失败。动手前先确认这两项，能省下大半排查时间。

到这里，我们也就讲完了《WordPress安装教程：PHP7.4配置详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！