最简方案是用官方 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、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 写成这样：
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
环境变量名和值都别写死，这是本地开发最容易忽略、上线后出问题最多的地方。
