laravel 11在centos 7上需手动配置：强制php 8.2+（通过remi仓库）、composer 2.7+（配阿里镜像）、用create-project --no-interaction创建项目、nginx中正确设置fastcgi_param script_filename为$realpath_root。
Laravel 11 不能直接用 laravel new 在 CentOS 7 上跑通——PHP 版本和系统组件不兼容是硬门槛，必须手动处理依赖链。
PHP 8.2+ 是强制前提，CentOS 7 默认源不提供
CentOS 7 自带的 yum 源最高只到 PHP 5.4（EPEL）或 7.3（Webtatic），而 Laravel 11 要求 PHP >= 8.2.0，且必须启用 mbstring、openssl、pdo、xml、ctype、json、tokenizer、zip、pcntl、posix 等扩展。
推荐方案是启用 remi 仓库并安装 php82：
- 先装 EPEL 和 remi：
yum install epel-release -y && yum install https://rpms.remirepo.net/enterprise/remi-release-7.rpm -y - 启用 php82 模块：
yum-config-manager --enable remi-php82 - 安装核心包：
yum install php82 php82-php-fpm php82-php-mbstring php82-php-xml php82-php-pdo php82-php-zip php82-php-gd php82-php-opcache php82-php-bcmath php82-php-tokenizer php82-php-cli php82-php-json -y - 创建软链接让系统命令识别：
ln -sf /opt/remi/php82/root/usr/bin/php /usr/local/bin/php - 验证：
php -v应输出PHP 8.2.x，php -m | grep -E "mbstring|pdo|xml"确保关键模块已加载
Composer 必须用 2.7+，且要设阿里镜像加速
旧版 Composer（如 1.x 或 2.5 以下）在解析 Laravel 11 的 composer.json 时会报 Package laravel/framework has a PHP requirement incompatible with your PHP version，本质是语义版本约束不识别 PHP 8.2 的 ^8.2 格式。
解决方式很明确：
- 下载最新稳定版：
curl -sS https://getcomposer.org/installer | php -- --filename=composer --version=2.7.8 - 全局安装：
mv composer /usr/local/bin/composer && chmod +x /usr/local/bin/composer - 换国内镜像（否则拉包极慢甚至超时）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证：
composer --version输出应为Composer version 2.7.8或更高
不能用 laravel new，得用 create-project 并跳过交互
laravel/installer 工具在 CentOS 7 上长期存在 PATH 和权限问题，且 Laravel 11 的 installer 未适配 PHP 8.2 的某些反射行为，执行 laravel new blog 常卡在 Installing laravel/laravel (v11.0.0) 后无响应或报 failed to open stream: Permission denied。
绕过 installer，直走 Composer 官方流程：
- 创建项目目录并进入：
mkdir /var/www/blog && cd /var/www/blog - 运行安装命令（加
--no-interaction避免卡在环境确认）：composer create-project laravel/laravel . --prefer-dist --no-interaction - 如果提示
zlib_decode(): data error，说明网络不稳定，重试或加--ignore-platform-reqs（仅调试用，上线前务必移除） - 安装完成后立即设置权限：
chown -R nginx:nginx /var/www/blog，再给 storage 和 bootstrap/cache 写权限：chmod -R 775 storage bootstrap/cache
Nginx 配置里必须显式声明 fastcgi_param SCRIPT_FILENAME
CentOS 7 的 php-fpm 默认监听 127.0.0.1:9000 或 socket 文件，但很多 Nginx 配置模板漏掉关键参数，导致访问返回 File not found. 或空白页。
正确配置片段（写入 /etc/nginx/conf.d/blog.conf）：
server {
listen 80;
server_name example.com;
root /var/www/blog/public;
<pre class="brush:php;toolbar:false;">add_header X-Frame-Options "DENY";
add_header X-Content-Type-Options "nosniff";
index index.php;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all;
}}
注意两点：
-
SCRIPT_FILENAME必须用$realpath_root（不是$document_root），否则 symlink 项目路径时会 404 -
include fastcgi_params不能漏，它提供了基础 CGI 变量；若用fastcgi.conf，需确认其中已定义SCRIPT_FILENAME
最后提醒：Laravel 11 默认启用 pest 测试框架和 sail，但 CentOS 7 缺少 Docker 和较新内核支持，./vendor/bin/sail 无法运行；生产部署请直接用 php-fpm + nginx 组合，别碰 sail up —— 这个坑在文档里不会写，但实测必踩。
