Docker可一键启动PHP开发环境,推荐php:8.2-apache或php:8.2-fpm镜像;挂载代码、暴露端口即可运行;扩展与配置通过Dockerfile定制;数据库连接用容器名;Xdebug调试需配置host.docker.internal;多服务推荐docker-compose统一管理。

用 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 —— 要用容器名作为主机名,并确保网络互通。
立即学习“PHP免费学习笔记(深入)”;
- 启动 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当主机名连接











