如何用Docker搭建PHP运行环境 PHP环境容器化部署示例-php教程-PHP中文网

如何用Docker搭建PHP运行环境 PHP环境容器化部署示例

雪夜

发布： 2025-07-17 17:45:02

原创

430人浏览过

使用docker搭建php运行环境的核心是通过容器化实现快速部署和环境隔离。具体步骤为：1. 使用docker-compose.yml定义nginx、php、mysql服务；2. 通过自定义dockerfile安装php扩展及composer；3. 配置nginx以支持php-fpm请求处理。各组件通过网络和数据卷互联并持久化数据，从而构建稳定、可复用的开发环境。

如何用Docker搭建PHP运行环境 PHP环境容器化部署示例

使用Docker搭建PHP运行环境，本质上就是将PHP、Web服务器（如Nginx或Apache）、数据库（如MySQL）等组件分别或组合打包成独立的容器，通过容器编排工具（如Docker Compose）进行管理和互联，从而实现快速部署、环境隔离和团队协作的便利。这种方式能有效解决传统开发环境中版本冲突、依赖管理复杂等痛点，让开发和部署流程变得更加高效和可控。

搭建一个PHP运行环境，我个人偏好使用Nginx作为Web服务器，PHP-FPM来处理PHP请求，再配上MySQL作为数据库。这种组合在生产环境中非常常见，而且用Docker来搞定，简直是降维打击。

我们需要一个docker-compose.yml文件来定义这些服务。我通常会把这个文件放在项目根目录，这样整个环境就和项目代码绑定在一起了。

立即学习“PHP免费学习笔记（深入）”；

version: '3.8'
services:
  nginx:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx:/etc/nginx/conf.d
      - ./src:/var/www/html
    depends_on:
      - php
    networks:
      - app-network

  php:
    build:
      context: .
      dockerfile: Dockerfile.php
    volumes:
      - ./src:/var/www/html
    networks:
      - app-network

  mysql:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_strong_password
      MYSQL_DATABASE: your_database_name
      MYSQL_USER: your_user_name
      MYSQL_PASSWORD: your_user_password
    volumes:
      - dbdata:/var/lib/mysql
    networks:
      - app-network

networks:
  app-network:
    driver: bridge

volumes:
  dbdata:

登录后复制

这里面有几个关键点：

LuckyCola工具库

LuckyCola工具库是您工作学习的智能助手，提供一系列AI驱动的工具，旨在为您的生活带来便利与高效。

133

查看详情

nginx服务：用了最新的Nginx镜像，映射80端口，把本地的nginx配置目录和src（你的PHP代码）目录挂载进去。depends_on: - php只是确保php服务先启动，但Nginx不依赖PHP-FPM的健康状态。
php服务：我倾向于用build指令，这样可以自定义PHP环境，比如安装一些扩展。Dockerfile.php就是我们用来构建PHP镜像的文件。
mysql服务：直接用MySQL官方镜像，设置好环境变量，数据卷挂载，防止数据丢失。
networks和volumes：这是Docker Compose的精髓，让服务之间可以互相通信，数据可以持久化。

接下来是Dockerfile.php，这个文件定义了PHP容器的具体内容。

FROM php:8.2-fpm-alpine

# 安装常用的PHP扩展
RUN apk add --no-cache \
    libzip-dev \
    libpng-dev \
    jpeg-dev \
    freetype-dev \
    icu-dev \
    onig-dev \
    git \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) pdo_mysql opcache gd exif pcntl zip intl bcmath mbstring

# 安装Composer
COPY --from=composer/composer:latest-bin /composer /usr/bin/composer

WORKDIR /var/www/html

# 暴露PHP-FPM端口，虽然在docker-compose里不是直接访问，但良好实践
EXPOSE 9000

CMD ["php-fpm"]

登录后复制

这个Dockerfile基于php:8.2-fpm-alpine，这是一个轻量级的PHP-FPM镜像。我加了一些常用的PHP扩展，比如pdo_mysql、gd、zip等，这些都是开发中经常会用到的。Composer也一并安装了，方便管理PHP依赖。

最后，别忘了Nginx的配置，通常我会创建一个nginx/default.conf文件：

server {
    listen 80;
    index index.php index.html index.htm;
    root /var/www/html;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $fastcgi_script_name =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php:9000; # 注意这里是php，对应docker-compose.yml中的服务名
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }

    error_log /var/log/nginx/error.log warn;
    access_log /var/log/nginx/access.log combined;
}

登录后复制

这个Nginx配置就是典型的PHP-FPM反向代理配置，把所有.php请求转发给`php:900

以上就是如何用Docker搭建PHP运行环境 PHP环境容器化部署示例的详细内容，更多请关注php中文网其它相关文章！