PHP扩展缺失本身不会直接导致404错误，但可能因框架启动失败、路由未注册或PHP-FPM静默崩溃，使Nginx误判为路径不存在而返回404；需通过php命令行测试、日志分析和phpinfo验证因果关系。
PHP 扩展缺失本身不会直接导致 404 错误——404 Not Found 是 Web 服务器（如 Nginx/Apache）返回的 HTTP 状态码，表示请求的 URL 路径找不到对应文件或路由；而 PHP 扩展未启用通常表现为 Fatal error: Uncaught Error: Call to undefined function 或白屏、500 错误。但现实中，某些框架或 CMS（如 Laravel、WordPress 插件、Laravel Octane、Symfony CLI）在启动时依赖特定扩展（如 mbstring、curl、json、openssl），若缺失，可能导致路由注册失败、自动加载中断、甚至被 Web 服务器误判为“入口文件不可执行”，最终 fallback 到 404。
确认是不是真因扩展缺失引发的 404
别急着装扩展，先验证因果关系：
- 用命令行直接运行 PHP 入口文件，看是否报扩展相关错误：
php /var/www/html/index.php
—— 如果输出Fatal error: Uncaught Error: Call to undefined function mb_strlen()，那mbstring就是罪魁祸首 - 检查 Web 服务器错误日志：
/var/log/nginx/error.log或/var/log/apache2/error.log，搜索PHP Fatal error或Failed opening required - 临时加个
phpinfo();页面，访问它，搜索你怀疑缺失的扩展名（如pdo_mysql），确认是否真的没加载 - 注意：Nginx 配置中若用了
try_files $uri $uri/ /index.php?$query_string;，但index.php因扩展缺失无法解析，PHP-FPM 会静默失败，Nginx 收不到响应，可能直接返回 404（尤其在fastcgi_intercept_errors on;且没配error_page 500 502 503 504 /50x.html;时）
Debian/Ubuntu 上安装常用 PHP 扩展（apt）
PHP 扩展包名格式通常是 php-，比如 PHP 8.2 的 mbstring 就是 php8.2-mbstring。先查当前 PHP 版本：
php -v
- 列出已启用的扩展：
php -m
- 安装多个常用扩展（按需选）：
sudo apt update && sudo apt install php8.2-mbstring php8.2-curl php8.2-xml php8.2-zip php8.2-opcache php8.2-bcmath
- 装完必须重启 PHP-FPM（不是 Apache/Nginx）：
sudo systemctl restart php8.2-fpm
—— 否则扩展不会生效 - 如果用的是 Apache 模块（
libapache2-mod-php），则重启 Apache：sudo systemctl restart apache2
CentOS/RHEL/Rocky 上安装 PHP 扩展（dnf/yum）
Red Hat 系默认使用 php-common 包提供基础扩展，但很多需单独安装。注意仓库源（如 EPEL + Remi）：
立即学习“PHP免费学习笔记（深入）”；
- 启用 Remi 仓库（推荐，支持多 PHP 版本）：
sudo dnf install epel-release -y && sudo dnf install https://rpms.remirepo.net/enterprise/remi-release-9.rpm -y
- 启用对应 PHP 版本模块（如 PHP 8.2）：
sudo dnf module reset php && sudo dnf module enable php:remi-8.2
- 安装扩展：
sudo dnf install php-mbstring php-curl php-xml php-zip php-opcache php-bcmath
- 重启服务：
sudo systemctl restart php-fpm
（或httpd，取决于 Web 服务器）
扩展装了还是不生效？重点排查这三处
装完扩展却仍报错，大概率卡在这几个环节：
-
php.ini文件没被正确加载：运行php --ini
查看实际加载路径，确认扩展是否写在该 ini 文件里（如extension=mbstring）；有些系统会把扩展配置拆到/etc/php/8.2/fpm/conf.d/20-mbstring.ini，确保该文件存在且内容为extension=mbstring - CLI 和 FPM 使用不同
php.ini：php -i | grep "Loaded Configuration File"
和php-fpm -i | grep "Loaded Configuration File"
结果可能不同，FPM 的配置才影响 Web 请求 - 扩展名拼写错误或大小写敏感：Linux 下扩展名必须全小写，
extension=MBSTRING或extension=php_mbstring.dll（Windows 才用 dll）都会失败；正确写法是extension=mbstring
真正卡住人的，往往是以为装了就完了，结果 PHP-FPM 还在读旧配置，或者压根没分清 CLI 和 FPM 的 ini 路径。多跑两遍 php -i 和 php-fpm -i，比重装十次都管用。
