Docker运行PHP项目教程及Dockerfile编写指南

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《Docker运行PHP项目教程_Dockerfile编写指南》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

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

如果您正在尝试将一个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扩展依赖

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

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虚拟主机

默认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 查看项目是否正常显示。

文中关于PHP配置的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Docker运行PHP项目教程及Dockerfile编写指南》文章吧，也可关注golang学习网公众号了解相关技术文章。