Docker部署PHP环境详细教程

本文详细讲解了如何利用 Docker 快速、标准化地部署 PHP 开发环境，涵盖从单容器一键启动（如 php:8.2-apache 或 php:8.2-fpm）到多服务协同（Nginx + PHP-FPM + MySQL + Redis）的完整实践，手把手演示了代码挂载、端口映射、扩展安装、自定义配置、容器间数据库连接、Xdebug 调试配置等核心技巧，并重点推荐使用 docker-compose 统一编排与管理，彻底告别手动编译、重复配置和环境不一致的烦恼——无论你是初学者想秒启本地开发环境，还是进阶开发者追求贴近生产的灵活架构，这篇教程都能让你高效、可靠地跑起一个开箱即用的 PHP 应用环境。

用 Docker 快速启动 PHP 开发环境（含 Web 服务）

不需要手动编译 PHP、安装 Apache/Nginx、配置扩展，Docker 可以一条命令拉起带完整运行时的 PHP 环境。关键是选对镜像、挂载好代码、暴露正确端口。

推荐镜像与基础启动方式

官方 php:8.2-apache 或 php:8.2-fpm 是最稳妥的选择。前者自带 Apache，适合快速验证；后者需搭配 Nginx，更贴近生产结构。

• 带 Apache 的一键启动： docker run -d -p 8080:80 -v $(pwd)/www:/var/www/html --name myphp php:8.2-apache 访问 http://localhost:8080 即可看到 PHP 默认页（或你项目中的 index.php）
• 使用 FPM + Nginx 组合（推荐进阶用）： 先启 FPM 容器：docker run -d --name php-fpm -v $(pwd)/www:/var/www/html php:8.2-fpm 再启 Nginx 容器（需自定义 nginx.conf，指向 php-fpm 容器）：docker run -d -p 8080:80 -v $(pwd)/www:/usr/share/nginx/html -v $(pwd)/nginx.conf:/etc/nginx/nginx.conf --link php-fpm:php-fpm nginx

启用常用扩展与自定义配置

官方镜像默认只开核心扩展。要加 pdo_mysql、gd、opcache 等，最简单的方式是基于官方镜像写 Dockerfile：

• 新建 Dockerfile： FROM php:8.2-apache
RUN docker-php-ext-install pdo_mysql gd opcache
RUN pecl install xdebug && docker-php-ext-enable xdebug
• 构建并运行：docker build -t myphp . && docker run -d -p 8080:80 -v $(pwd)/www:/var/www/html myphp
• PHP 配置（如 upload_max_filesize）可通过 RUN echo "upload_max_filesize = 64M" >> /usr/local/etc/php/conf.d/uploads.ini 注入

连接数据库与调试支持

Docker 中 PHP 连 MySQL 或 PostgreSQL，不能用 localhost —— 要用容器名作为主机名，并确保网络互通。

• 启动 MySQL 容器：docker run -d --name mysql-dev -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 mysql:8.0
• PHP 代码中连接写成：$pdo = new PDO('mysql:host=mysql-dev;dbname=test', 'root', '123456');
• 启用 Xdebug 后，在 IDE（如 PhpStorm）中配置监听 9003 端口，容器内需设置：environment: - XDEBUG_MODE=debug - XDEBUG_CONFIG="client_host=host.docker.internal"（Mac/Win Docker Desktop 支持 host.docker.internal；Linux 需用宿主 IP）

用 docker-compose 管理多服务更省心

把 PHP、Nginx、MySQL、Redis 写进一个 docker-compose.yml，一条命令全启动：

• 示例片段： version: '3.8'
services:
  app:
    build: .
    ports: ["8080:80"]
    volumes: ["./www:/var/www/html"]
  db:
    image: mysql:8.0
    environment: {MYSQL_ROOT_PASSWORD: "123456"}
  redis:
    image: redis:alpine
• 执行 docker-compose up -d，所有服务自动联网，PHP 可直接用 db 和 redis 当主机名连接

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~