怎么在Docker中运行PHP项目_Dockerfile编写与镜像构建教程-php教程-PHP中文网

怎么在Docker中运行PHP项目_Dockerfile编写与镜像构建教程

絕刀狂花

发布： 2025-10-30 19:45:02

原创

428人浏览过

首先编写Dockerfile，1. 创建文件并基于php:8.1-apache设置工作目录；2. 复制项目文件并设权限；3. 安装mysqli、pdo、gd等扩展；4. 启用rewrite模块并配置虚拟主机；5. 暴露80端口；6. 构建镜像后运行容器映射8080端口验证。

怎么在docker中运行php项目_dockerfile编写与镜像构建教程

如果您正在尝试将一个PHP项目容器化，但遇到环境依赖或配置问题，则可以通过编写自定义Dockerfile来构建专属镜像以确保运行环境的一致性。以下是完成该任务的具体步骤：

本文运行环境：MacBook Pro，macOS Sonoma

一、准备基础Dockerfile结构

Dockerfile是构建镜像的核心脚本文件，它定义了容器内的操作系统环境、安装的软件包以及启动命令。从官方PHP镜像开始可以快速搭建稳定环境。

1、在项目根目录下创建名为 Dockerfile 的文件（无扩展名）。

2、写入基础指令，指定使用官方PHP的Apache版本镜像作为基础：
FROM php:8.1-apache

3、设置工作目录为Apache默认路径：
WORKDIR /var/www/html

为了使PHP代码能够在容器中运行，需要将本地项目文件复制到镜像的工作目录下，这一步确保所有源码被正确加载。

1、使用COPY指令将当前目录下的所有文件复制到容器的/var/www/html目录：
COPY . /var/www/html

2、设置适当的文件权限，避免因权限问题导致无法访问：
RUN chown -R www-data:www-data /var/www/html

大多数PHP项目依赖特定扩展（如mysqli、pdo、gd等），需在镜像构建过程中通过Dockerfile安装这些扩展以保证功能完整。

豆包AI编程

豆包推出的AI编程助手

483

1、利用Docker PHP镜像提供的docker-php-ext-install工具安装常用扩展：
RUN docker-php-ext-install mysqli pdo pdo_mysql gd

2、如有需要启用某些扩展配置，可追加配置文件至容器指定目录：
COPY php.ini /usr/local/etc/php/conf.d/custom.ini

默认Apache配置可能不满足项目需求，可通过覆盖配置文件或启用重写模块来支持URL重写等功能。

1、启用Apache的mod_rewrite模块以支持.htaccess规则：
RUN a2enmod rewrite

2、若需自定义站点配置，可复制自定义vhost文件并替换默认配置：
COPY default-site.conf /etc/apache2/sites-available/000-default.conf

容器必须声明监听的网络端口，以便外部能够访问运行中的Web服务。Apache默认使用80端口，应在Dockerfile中显式暴露。

1、添加EXPOSE指令声明服务监听端口：
EXPOSE 80

2、由于apache镜像已内置启动脚本，无需额外CMD指令，直接沿用默认启动方式即可。

完成Dockerfile编写后，执行构建命令生成镜像，并通过运行容器验证是否成功加载PHP项目。

1、在终端执行构建命令，为镜像打上标签便于管理：
docker build -t my-php-app .

2、启动容器并将主机8080端口映射到容器80端口：
docker run -d -p 8080:80 my-php-app

3、打开浏览器访问 http://localhost:8080 查看项目是否正常显示。

以上就是怎么在Docker中运行PHP项目_Dockerfile编写与镜像构建教程的详细内容，更多请关注php中文网其它相关文章！