使用docker compose搭建php 8.6.0与nginx测试环境,核心做法是编写包含两个服务的`docker-compose.yml`文件,分别定义基于`php:8.6-fpm`和`nginx:latest`的容器,并通过挂载本地代码目录实现数据共享。配置时需在nginx中设置`fastcgi_pass`指向php容器的9000端口,并确保两者在同一个自定义网络下通信,这样即可通过浏览器访问由nginx转发给php处理的动态页面。

Nginx如何正确转发请求到PHP-FPM
Nginx通过`location ~ \.php$`块中的`fastcgi_pass`指令将PHP脚本请求传递给后端服务。关键在于地址必须指向Docker内部网络的PHP容器地址,而非宿主机IP,且需配合`include fastcgi_params`加载标准参数。若配置错误,Nginx会返回404或502错误,因为无法解析FPM进程。

server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_pass php-fpm:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
上述配置中,`fastcgi_pass php-fpm:9000`使用了Docker Compose默认生成的DNS名称`php-fpm`,这确保了Nginx容器能正确解析到PHP容器的IP。同时,`SCRIPT_FILENAME`参数必须设置为`$document_root$fastcgi_script_name`,以匹配挂载卷中的实际路径。启动后,访问`http://localhost/info.php`应显示PHP信息页,证明转发成功。
立即学习“PHP免费学习笔记(深入)”;
Docker Compose网络与卷挂载配置要点
在`docker-compose.yml`中,必须为Nginx和PHP定义相同的`networks`以便相互发现,并使用`volumes`将宿主机的代码目录映射到两个容器中。PHP容器需要读写权限以执行脚本,而Nginx只需读取权限。若未正确配置网络,容器间将无法通信;若卷路径不一致,会导致文件找不到或权限拒绝。

version: '3.8'
services:
nginx:
image: nginx:latest
ports:
- "80:80"
volumes:
- ./html:/var/www/html:ro
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
depends_on:
- php-fpm
networks:
- app-network
php-fpm:
image: php:8.6-fpm
volumes:
- ./html:/var/www/html
networks:
- app-network
networks:
app-network:
driver: bridge
该配置中,`./html`目录被挂载到两个容器的相同路径`/var/www/html`,确保Nginx读取的文件与PHP执行的源文件一致。`depends_on`确保PHP容器先启动,避免连接失败。`app-network`是用户定义的桥接网络,提供稳定的DNS解析。验证时,可在`./html`下创建`index.php`,内容仅含``,访问首页应输出`Hello`,表明卷和网络配置无误。
PHP 8.6 FPM容器启动失败常见原因排查
当PHP容器启动后立即退出或日志报错时,通常是因为基础镜像版本不存在、扩展安装失败或配置文件语法错误。PHP 8.6作为较新版本,需确认Docker Hub上确实存在`php:8.6-fpm`标签,否则需回退至稳定版如8.2。此外,若在Dockerfile中自定义扩展,需确保依赖包已安装,否则构建会中断。检查容器状态可使用`docker compose ps`,查看实时日志用`docker compose logs php-fpm`。



















