docker compose编排nginx、php-fpm和mysql是当前laravel本地开发最可靠方式，通过服务名通信、多阶段构建dockerfile、nginx laravel专用配置及逐层排查502/连接拒绝等问题，实现可版本化、可复现、团队一致的开发环境。
直接用 Docker Compose 编排 Nginx、PHP-FPM 和 MySQL 是当前 Laravel 本地开发最可靠的方式。它不追求“一键傻瓜”，而是把环境变成可版本化、可复现、可团队共享的配置代码——你改一行 docker-compose.yml，整个团队就同步升级，不再有人卡在 “为什么我本地报 502”。
核心服务怎么组织
三个容器各司其职，不混装：
-
Nginx 容器：只做反向代理和静态资源服务，不装 PHP。配置里
fastcgi_pass php:9000指向 PHP-FPM 容器名（不是 localhost），靠 Docker 内置 DNS 自动解析 -
PHP-FPM 容器：运行 Laravel 应用逻辑，基于
php:8.2-fpm-alpine或php:8.3-fpm，安装pdo_mysql、mbstring、gd、bcmath等必需扩展 -
MySQL 容器：用
mysql:8.0或mysql:8.4，通过volumes持久化数据，环境变量设好MYSQL_ROOT_PASSWORD和MYSQL_DATABASE
关键配置文件怎么写
项目根目录放三个基础文件，缺一不可：
-
docker-compose.yml：定义服务依赖与网络。注意depends_on只控制启动顺序，不保证 MySQL 已就绪；建议在 PHP 容器启动脚本里加重试逻辑（如用wait-for-it.sh） -
Dockerfile（PHP）：不要直接用官方镜像跑composer install。推荐多阶段构建——第一阶段用composer:latest安装依赖并缓存，第二阶段复制 vendor 到精简的 PHP-FPM 镜像，体积更小、启动更快 -
nginx/conf.d/default.conf：Laravel 专用配置。重点是root /var/www/html/public和try_files $uri $uri/ /index.php?$query_string，确保路由能被正确转发
环境变量和数据库怎么连通
容器间通信靠服务名，不是 IP：
- PHP 容器里
.env的DB_HOST=mysql—— 这个mysql就是docker-compose.yml中 mysql 服务的名字 - 别在宿主机
/etc/hosts里硬写127.0.0.1 mysql，那会干扰容器 DNS 解析 - 首次启动后，进 PHP 容器执行：
php artisan migrate和php artisan key:generate，再刷新浏览器即可看到 Laravel 欢迎页
常见问题怎么快速定位
出错别急着重装，按链路逐层检查：
-
502 Bad Gateway：先
docker logs nginx看是否连不上 php；再docker logs php看 PHP-FPM 是否启动成功、端口是否暴露（EXPOSE 9000）、sock 文件权限是否正确 -
Connection refused to MySQL：进 PHP 容器执行
nc -zv mysql 3306，不通说明 MySQL 没启好或 network 配置错；通了但 Laravel 连不上，检查.env用户密码是否和 mysql 容器环境变量一致 -
页面空白或 404：确认 Nginx root 指向
public/目录，且index.php在该目录下；检查storage/和bootstrap/cache/目录是否可写（可在 Dockerfile 里加RUN chown -R www-data:www-data /var/www/html/storage /var/www/html/bootstrap/cache）
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
