如何在Docker中运行PHP？

跑PHP在Docker上需注意环境配置与容器稳定性。首先准备好结构清晰的PHP项目，确保有composer.json等依赖文件，并将代码置于独立目录以便挂载；其次使用官方PHP镜像快速启动容器测试，如用CLI镜像执行简单脚本；接着编写Dockerfile自定义镜像，复制代码、安装扩展并启用必要模块；最后处理调试与常见问题，包括权限、依赖缺失、Apache运行及日志查看。部署上线建议构建自定义镜像并优化配置。

跑 PHP 在 Docker 上其实不难，但要确保环境配置正确、容器运行稳定，得注意几个关键点。下面直接说怎么操作。

准备好你的 PHP 项目

在使用 Docker 前，先确认你的 PHP 项目结构清晰，有必要的依赖文件，比如 composer.json（如果你用了 Composer 管理依赖）。这样后面构建镜像时能顺利安装扩展。

另外，建议把代码放在一个独立目录里，方便挂载到容器中。不需要一开始就打包成镜像，先用官方镜像快速启动试试看。

使用官方 PHP 镜像运行容器

Docker Hub 提供了多个版本的 PHP 官方镜像，你可以选择带 Apache 或 FPM 的版本，也可以用 CLI 版本做测试。

比如运行一个简单的 PHP CLI 容器：

docker run -it --rm -v $(pwd):/var/www/html php:8.2-cli php /var/www/html/index.php

这行命令做了几件事：

• 启动一个临时容器（--rm 表示退出后自动删除）
• 把当前目录挂载进容器的 /var/www/html
• 执行 php index.php，也就是你本地的 PHP 文件

如果是 Web 项目，可以用 Apache 或 Nginx PHP-FPM 组合，但一开始没必要太复杂。

编写 Dockerfile 自定义镜像

当你需要固定环境或部署上线时，应该写一个 Dockerfile 来构建自己的镜像。比如这个例子：

FROM php:8.2-apache
COPY . /var/www/html/
RUN docker-php-ext-install mysqli && a2enmod rewrite

说明一下：

• 基于带 Apache 的 PHP 镜像构建
• 把本地代码复制进去
• 安装常用扩展（如 mysqli）并启用 mod_rewrite 支持伪静态

然后用以下命令构建和运行：

docker build -t my-php-app .
docker run -d -p 8080:80 my-php-app

访问 localhost:8080 就能看到你的 PHP 页面了。

调试与常见问题处理

跑起来之后，可能会遇到这些问题：

• 权限问题：确保挂载目录里的文件，容器内用户有读取权限
• 依赖没装：有些 PHP 扩展默认不带，需要在 Dockerfile 中手动安装
• Apache 没启动：用 Apache 镜像时，确保前台运行或者 CMD 正确配置
• 日志查看：用 docker logs 查看运行日志，排查错误更快捷

如果只是开发测试，可以直接用官方镜像加挂载目录；如果要部署上线，建议构建自定义镜像，并加入扩展、配置优化等步骤。

基本上就这些。别一上来就想一步到位，先跑通再优化。

以上是如何在Docker中运行PHP？的详细内容。更多信息请关注PHP中文网其他相关文章！