需构建含web服务器与php的docker容器并正确映射端口、挂载文件、启动服务；可选官方php:apache镜像快速启动、自定义dockerfile集成chrome、docker-compose编排lemp栈，或排查403/源码泄露/pdo缺失等常见问题。
如果您希望在 Docker 容器中运行浏览器可访问的 PHP 环境，需构建一个包含 Web 服务器（如 Apache 或 Nginx）与 PHP 解释器的容器，并确保端口映射正确、文件挂载可用、服务自动启动。以下是实现该目标的具体操作步骤：
一、使用官方 php:apache 镜像快速启动
此方法基于 PHP 官方维护的 php:apache 镜像，已预装 Apache 和 PHP 模块，适合快速验证和开发测试。镜像内置了 mod_php，无需额外配置即可解析 .php 文件。
1、创建一个本地目录用于存放 PHP 文件，例如 /home/user/myphp，并在其中新建 index.php，内容为 。
2、执行以下命令启动容器：docker run -d --name myphp -p 8080:80 -v /home/user/myphp:/var/www/html php:apache。
立即学习“PHP免费学习笔记（深入）”；
3、打开浏览器，访问 http://localhost:8080，应显示 PHP 输出内容。
二、使用自定义 Dockerfile 构建含 Chrome 的 PHP 浏览器环境
若需在容器内运行浏览器（如 Chrome）并由 PHP 调用（例如通过 shell_exec 执行 headless Chrome），需在基础 PHP 镜像上安装 Chromium 及依赖库，并解决沙箱权限问题。
1、新建文件 Dockerfile，内容如下：
FROM php:8.2-apache
RUN apt-get update && apt-get install -y wget gnupg && \
wget -q -O - https://dl.google.com/linux/linux_signing_key.pub | apt-key add - && \
echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list && \
apt-get update && apt-get install -y google-chrome-stable && \
rm -rf /var/lib/apt/lists/*
COPY index.php /var/www/html/
EXPOSE 80
2、在同一目录下创建 index.php，内容包含测试 Chrome 调用：&1', $out); print_r($out); ?>。
3、构建并运行：docker build -t php-chrome . && docker run -d --name php-chrome-run -p 8081:80 --cap-add=SYS_ADMIN php-chrome。
三、使用 docker-compose 统一管理 PHP + Nginx + MySQL 多服务
当需要完整 LEMP 栈支持（尤其涉及数据库交互的 PHP 应用），推荐使用 docker-compose 编排多个容器。Nginx 作为反向代理处理 PHP-FPM 请求，分离关注点并提升灵活性。
1、创建 docker-compose.yml，内容包含 nginx、php-fpm、mysql 三个服务，并设置网络互通与卷挂载。
2、在 nginx 服务的配置中，添加 location ~ \.php$ 块，将请求代理至 php-fpm:9000。
3、准备 php-fpm 的自定义配置文件 www.conf，启用 catch_workers_output = yes 便于调试错误日志。
4、执行 docker-compose up -d 启动全部服务，访问 http://localhost 即可加载 PHP 页面。
四、修复常见 php\_docker 配置失败问题
容器启动后 PHP 文件无法解析或 500 错误频发，通常源于权限、路径映射或模块缺失。以下为高频故障对应修正方式：
1、若浏览器返回 403 Forbidden，检查 /var/www/html 目录是否被挂载且容器内用户具有读取权限；可添加 -u www-data 参数或修改宿主机目录权限为 chmod -R 755。
2、若 PHP 代码不执行而直接显示源码，确认 Apache 是否启用 mod_php（php:apache 镜像默认启用），或 Nginx 配置中是否遗漏 fastcgi_pass 指令指向正确的 PHP-FPM 地址。
3、若出现 Class 'PDO' not found，进入容器执行 docker exec -it myphp bash，再运行 docker-php-ext-install pdo_mysql 并重启 Apache。
