PHP怎么使用Docker建环境_PHP使用Docker建环境容器【轻量】

2026-01-14

PHP怎么使用Docker建环境_PHP使用Docker建环境容器【轻量】

最简方案是用官方 php:8.2-apache 镜像并挂载代码目录：docker run -p 8080:80 -v $(pwd):/var/www/html php:8.2-apache，确保当前目录含 index.php；Composer 应用 php:8.2-cli 单独运行；Dockerfile 中只配置不可变项如扩展及时区；多服务用 docker-compose.yml 管理，并通过 .env 注入敏感变量。

php怎么使用docker建环境_php使用docker建环境容器【轻量】

PHP项目直接跑在Docker容器里，不用装本地PHP、Apache或Nginx

能跑起来的最简方案，就是用官方 php:8.2-apache 镜像——它自带 PHP 解释器 + Apache Web 服务，一行命令就能把 index.php 暴露到 http://localhost:8080。

常见错误是直接 docker run -p 8080:80 php:8.2-apache 启动后访问空白页：因为镜像默认只提供 Apache 服务，没挂载你的代码，/var/www/html/ 里是空的。

把当前目录映射进去：docker run -p 8080:80 -v $(pwd):/var/www/html php:8.2-apache
确保当前目录下有 index.php，内容比如
Linux/macOS 用 $(pwd)，Windows PowerShell 用 ${PWD}，CMD 用 %cd%

需要 Composer？选带 CLI 的镜像，别硬装进 Apache 镜像

官方 php:8.2-apache 不带 composer，也不建议在运行中的容器里 curl -sS https://getcomposer.org/installer | php —— 容器重启就没了，还污染镜像层。

更轻量的做法是：用 php:8.2-cli 镜像单独跑 Composer 命令，配合 -v 挂载当前目录，生成的 vendor/ 直接留在宿主机。

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

docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install

--rm 表示命令执行完自动删容器，干净
-w /app 设定工作目录，否则 composer 不知道在哪初始化
如果项目用了 composer.lock，这行命令会精准还原依赖，和本地一致

Dockerfile 写法要克制：PHP 环境不需要 COPY 整个项目再 RUN apt-get

很多新手 Dockerfile 写成这样：

萝卜简历

免费在线AI简历制作工具，帮助求职者轻松完成简历制作。

下载

FROM php:8.2-apache
RUN apt-get update && apt-get install -y zlib1g-dev && docker-php-ext-install zip
COPY . /var/www/html
EXPOSE 80

问题在于：每次改一行代码就得重 build 整个镜像，而且 apt-get 在构建阶段拉包慢、易失败；zip 扩展其实官方镜像已预装（查 php -m | grep zip 就知道），白费力气。

真正该进 Dockerfile 的只有「不可变配置」：比如启用扩展、设时区、调内存限制。

FROM php:8.2-apache
RUN docker-php-ext-enable opcache
RUN echo 'date.timezone=Asia/Shanghai' > /usr/local/etc/php/conf.d/tz.ini
COPY ./public /var/www/html

COPY ./public 而不是 COPY .，避免把 node_modules、vendor 这些大目录塞进镜像
扩展优先用 docker-php-ext-enable（启已编译好的），少用 docker-php-ext-install（现场编译，慢且依赖多）
PHP 配置写进 /usr/local/etc/php/conf.d/*.ini，Apache 配置另放，别混在一起

本地开发用 docker-compose.yml，但别写死数据库密码

单容器够用，但加 MySQL 或 Redis 就得编排。一个轻量 docker-compose.yml 示例：

version: '3.8'
services:
  app:
    image: php:8.2-apache
    ports: ["8080:80"]
    volumes: ["./public:/var/www/html"]
    depends_on: [db]
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: root
      MYSQL_DATABASE: myapp
    volumes: ["mysql-data:/var/lib/mysql"]
volumes:
  mysql-data:

注意：上面的 MYSQL_ROOT_PASSWORD: root 是为了快速启动，**切勿提交到 Git**。实际应通过 .env 文件或 secrets 注入：

新建 .env 文件，写 DB_PASSWORD=secret123
把 environment 改成 MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
运行时 docker-compose up 会自动读取同目录下的 .env

环境变量名和值都别写死，这是本地开发最容易忽略、上线后出问题最多的地方。

https://www.php.cn/faq/1980701.html