Laravel 10安装时PHP-FPM报错主因是环境未达标：①PHP-FPM未安装或未启动（需php-fpm -v验证并systemctl start/enable）；②缺失ctype、mbstring等12个必需扩展；③Nginx的fastcgi_pass与PHP-FPM监听方式（socket/TCP）及SCRIPT_FILENAME参数不匹配；④Composer版本低或权限不足。
安装 Laravel 10 时遇到 PHP-FPM 报错，通常不是 Laravel 本身的问题，而是本地 PHP 运行环境未达标或服务未就绪。重点不在“装 Laravel”，而在“能否让 PHP-FPM 正常跑起来并被 Web 服务器调用”。以下四类问题覆盖 95% 的真实报错场景，按排查顺序列明关键动作。
确认 PHP-FPM 服务已安装且可启动
运行 php-fpm -v 查版本；若提示 command not found，说明 PHP-FPM 根本没装。Laravel 10 要求 PHP ≥ 8.1，推荐直接安装对应版本的 FPM 包：
- Ubuntu/Debian：
sudo apt install php8.2-fpm（根据你实际 PHP 版本调整） - CentOS/RHEL：
sudo yum install php-fpm或启用 EPEL 后安装 php82-php-fpm
安装后必须启动并设为开机自启：sudo systemctl start php8.2-fpm && sudo systemctl enable php8.2-fpm。再执行 systemctl is-active php8.2-fpm，返回 active 才算通过这关。
检查必需的 PHP 扩展是否全部启用
Laravel 10 强依赖以下扩展：ctype、iconv、json、mbstring、openssl、pdo、tokenizer、xml、curl、bcmath、fileinfo、zip。缺一可能导致 laravel new 中断或后续 500 错误。
Laravel Cloud
下载
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
立即学习“PHP免费学习笔记（深入）”；
- 快速检查命令：
php -m | grep -E "ctype|mbstring|openssl|pdo|tokenizer" - 缺失时安装（Ubuntu 示例）：
sudo apt install php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-bcmath - 改完重启服务：
sudo systemctl reload php8.2-fpm
验证 Nginx 与 PHP-FPM 的通信链路
即使 PHP-FPM 启动了，Nginx 若连不上它，Laravel 应用访问就会报 502。核心是三处必须严格一致：
-
监听方式：查 PHP-FPM 实际监听位置 ——
ss -tlnp | grep ':9000'（TCP）或ls -l /run/php/php8.2-fpm.sock（Unix socket） -
Nginx 配置：确保
fastcgi_pass与上一步完全匹配，例如：- 监听 socket → 写
fastcgi_pass unix:/run/php/php8.2-fpm.sock; - 监听 127.0.0.1:9000 → 写
fastcgi_pass 127.0.0.1:9000;
- 监听 socket → 写
-
SCRIPT_FILENAME 参数：Nginx 配置中必须有这一行：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，否则会报 “Primary script unknown”
排除 Composer 和权限干扰
在终端执行 laravel new myapp 时出错，也可能是 Composer 层面卡住：
- 升级 Composer：
composer self-update（Laravel 10 需 Composer ≥ 2.5） - 绕过内存限制：
php -d memory_limit=-1 composer create-project laravel/laravel myapp - 创建完成后，给 Laravel 必需目录赋权：
sudo chown -R $USER:www-data storage bootstrap/cache，再chmod -R 775 storage bootstrap/cache
不复杂但容易忽略
