PHP内置开发服务器php -S仅适用于简单调试，缺乏Nginx支持的路由规则、静态资源处理、HTTPS代理等生产级能力；本地部署需严格匹配Nginx与PHP-FPM/CGI的路径、端口、权限及配置层级。
为什么不能直接用 php -S 而要配 Nginx
php -S 是 PHP 内置的开发服务器，只适合最简单的单入口脚本调试。一旦涉及 .htaccess 等价规则（如 Laravel 的 try_files）、静态资源缓存头、gzip 压缩、HTTPS 本地代理、或多个虚拟主机并存，它就完全失效。Nginx 在本地不是“过度配置”，而是补上 PHP 内置服务器缺失的生产级路由与响应控制能力。
Windows 下用 nginx.exe 直接跑 PHP-FPM 的关键三步
核心是让 Nginx 把 PHP 请求转发给 php-cgi.exe（Windows 没有传统 php-fpm 进程，用 CGI 模式替代）。常见错误是路径写错或端口冲突。
- 确认
php-cgi.exe存在且可执行：通常位于php\php-cgi.exe，运行php-cgi.exe -v应输出版本号 - 修改
nginx.conf的location ~ \.php$块，关键字段必须为：fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params;
- 启动顺序不能错：先以
php-cgi.exe -b 127.0.0.1:9000启动 CGI 监听，再运行nginx.exe；否则 Nginx 日志会报connect() failed (10061: Connection refused)
macOS / Linux 用 Homebrew 或 apt 安装后，php-fpm 启不起来的典型原因
系统级服务启动失败，80% 出在配置路径或用户权限。不要直接改 /etc/php/*/fpm/pool.d/www.conf 后就 systemctl restart，先验证配置有效性。
- 检查
listen值是否与 Nginx 中fastcgi_pass一致：若listen = /var/run/php/php8.2-fpm.sock，则 Nginx 必须写fastcgi_pass unix:/var/run/php/php8.2-fpm.sock - 确认 socket 文件目录权限：例如
/var/run/php/所属用户需为www-data（Ubuntu）或_www（macOS），且目录有g+rw权限 - PHP-FPM 日志默认在
/var/log/php*-fpm.log，但实际路径由php-fpm.conf中error_log指定，别只看默认位置
本地 Nginx 配置中，root 和 alias 的误用导致 404
这是最隐蔽的路径错误来源。二者语义完全不同：root 是拼接整个 URI，alias 是替换 location 路径段。
立即学习“PHP免费学习笔记（深入）”；
比如你项目在 /Users/me/project/public，想通过 http://localhost/myapp/ 访问：
- ✅ 正确：
location /myapp/ { alias /Users/me/project/public/; }（注意末尾斜杠） - ❌ 错误：
location /myapp/ { root /Users/me/project/public; }——这会让 Nginx 查找/Users/me/project/public/myapp/index.php，显然不存在 - 对 Laravel / ThinkPHP 等框架，必须用
try_files $uri $uri/ /index.php?$query_string，且该指令只能放在location /或具体 path 下，不能丢在 server 块顶层
