17370845950

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 —— 要用容器名作为主机名，并确保网络互通。

• 启动 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 当主机名连接