PHP 8.3部署项目不能仅换版本，必须确保Web服务器调用正确FPM实例、扩展兼容、权限与安全模块（SELinux/AppArmor）适配，并严格配置php.ini（如display_errors=Off、error_log路径、OPcache）、Nginx fastcgi_pass及.env访问控制。
PHP 最新版（如 8.3 或 8.4）部署项目，不是换个 PHP 版本就能直接跑起来。核心问题在于：新版 PHP 默认禁用部分旧扩展、调整了错误报告级别、收紧了类型检查，并且多数现代框架（Laravel 11、Symfony 7）已强制要求 8.2+，但它们的部署逻辑和权限/配置细节反而更敏感。
确认 PHP 8.3+ 是否真被 Web 服务器调用
常见现象：php -v 显示 8.3，但浏览器访问 info.php 却显示 7.4 或报 502 —— 说明 Nginx/Apache 并没连上你装的新 PHP-FPM。
- 检查当前生效的 PHP-FPM 实例：
sudo systemctl list-units | grep php，留意服务名是否含版本号，例如php8.3-fpm - 验证监听地址是否匹配：打开
/etc/php/8.3/fpm/pool.d/www.conf，确认listen = /run/php/php8.3-fpm.sock，且user = www-data、group = www-data - Nginx 配置中
fastcgi_pass必须指向同一 socket 路径，不能写成127.0.0.1:9000（除非你显式改过 FPM 的 listen 方式） - 修改后务必执行：
sudo systemctl restart php8.3-fpm && sudo systemctl reload nginx - 测试：创建
/var/www/html/test.php，内容为<?php echo PHP_VERSION; ?>，访问看输出是否为 8.3.x
composer install 在 PHP 8.3 下失败的典型原因
PHP 8.3 移除了 ext-xmlrpc，并默认开启 strict_types=1 检查；Composer v2.5+ 已适配，但老项目 lock 文件可能卡在旧版 Composer 或 require 了不兼容的包。
- 先确保用的是新版 Composer：
curl -sS <a href="https://www.php.cn/link/e910517884e11c8a741c3b1da823f47e">https://www.php.cn/link/e910517884e11c8a741c3b1da823f47e</a> | php -- --install-dir=/usr/local/bin --filename=composer - 运行前设环境变量避免内存溢出：
COMPOSER_MEMORY_LIMIT=-1 composer install --no-dev --optimize-autoloader - 若报
Declaration of ... must be compatible with ...：说明某依赖未适配 8.3 的返回类型声明，需升级该包（如monolog/monolog ^3.5），或临时加--ignore-platform-reqs（仅调试，勿上线） - 注意：PHP 8.3 默认关闭
allow_url_fopen，若 Composer 需远程 fetch 包，得在/etc/php/8.3/cli/php.ini中设allow_url_fopen = On
public/ 目录权限与 SELinux/AppArmor 冲突
PHP 8.3 常运行在较新发行版（Ubuntu 24.04、AlmaLinux 9），其默认启用 SELinux（RHEL系）或 AppArmor（Ubuntu），会导致即使 chown www-data:www-data 也 500 报错。
立即学习“PHP免费学习笔记（深入）”；
- Ubuntu 上检查 AppArmor 状态：
aa-status，若看到nginx或php-fpm在 enforce 模式，临时测试可执行：sudo aa-disable /usr/sbin/nginx（上线前应配策略，而非关） - RHEL/AlmaLinux 上检查 SELinux：
sestatus，若为enforcing，用ls -Z /var/www/myapp/public看上下文，正确应为httpd_sys_content_t，修复命令：sudo semanage fcontext -a -t httpd_sys_content_t "/var/www/myapp/public(/.*)?" && sudo restorecon -Rv /var/www/myapp/public - 不要盲目
chmod 777：PHP 8.3 对 world-writable 目录会触发警告甚至拒绝加载（尤其vendor/和bootstrap/cache）
PHP 8.3+ 部署最易被忽略的一点：.env 文件必须由 Web 用户（如 www-data）可读，但不能被 HTTP 直接访问 —— 意味着它绝不能放在 public/ 下，且 Web 服务器配置里要有明确的 location ~ /.env { deny all; } 规则。很多“能跑但接口 404”的问题，根源其实是 .env 加载失败导致数据库配置为空，而错误日志又被 display_errors = Off 掩盖了。
