Docker搭建PHP环境教程容器部署示例

想要快速搭建PHP开发环境？本文为你提供一套基于Docker的完整解决方案，通过容器化部署Nginx、PHP-FPM和MySQL，实现环境隔离和快速部署。本文详细介绍了如何使用`docker-compose.yml`定义服务，利用`Dockerfile`自定义PHP镜像并安装常用扩展，以及配置Nginx以支持PHP-FPM请求处理。通过数据卷持久化数据，构建稳定且可复用的开发环境。告别版本冲突和依赖管理难题，让你的PHP开发流程更高效、更可控。无论你是新手还是经验丰富的开发者，都能轻松掌握Docker容器化部署PHP环境的技巧。

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

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

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

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

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:

这里面有几个关键点：

• 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

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。