videoblocks/docker-php

Dockerized PHP镜像说明

镜像概述

本镜像为开发环境提供Docker化的PHP运行环境，支持在IDE中配置使用，方便开发者进行PHP项目开发和测试。

核心功能

1. 提供PHP 7.4运行环境，包含Xdebug扩展
2. 支持作为PhpStorm的远程CLI解释器
3. 可配置运行PHPUnit测试

使用场景

• 本地PHP项目开发
• PHPUnit测试执行
• IDE（如PhpStorm）内的PHP环境配置

配置说明（以PhpStorm为例）

步骤1：拉取镜像

bash
docker pull videoblocks/docker-php

步骤2：配置Docker服务器

1. 打开PhpStorm偏好设置（⌘+,），导航至Build, Execution, Deployment > Docker
2. 点击"+"创建新配置：
   • 名称：Docker Server（或自定义）
   • 连接方式：Docker for Mac
   • 路径映射：/Users（虚拟机路径）> /Users（本地路径）
3. 点击OK保存

步骤3：配置PHP CLI解释器

1. 打开PhpStorm偏好设置，导航至Languages & Frameworks > PHP
2. 点击CLI Interpreter旁的"..."
3. 点击"+"选择"From Docker"创建远程解释器：
   • 名称：Docker PHP（或自定义）
   • 远程类型：Docker
   • 服务器：Docker Server（步骤2中创建的）
   • 镜像名称：videoblocks/docker-php
   • PHP可执行文件：php（系统会识别版本7.4.4及Xdebug 2.9.0）
   • Debugger扩展路径：/usr/local/lib/php/extensions/no-debug-non-zts-20160303/xdebug.so
4. 点击OK保存

步骤4：设置PHP语言级别及路径映射

1. 在Languages & Frameworks > PHP中：
   • PHP语言级别：7.4
   • 路径映射：<项目根目录> -> /opt/project
2. 配置Docker容器：
   • 网络模式：bridge
   • 卷绑定：/opt/project（容器路径）> <你的项目目录>（主机路径）
   • 环境变量：
     • DB_HOST: host.docker.internal
     • ACCOUNT_SERVICE_CLIENT_BASE_URL: host.docker.internal:9087
     • AUTH_SERVICE_CLIENT_BASE_URL: host.docker.internal:9087
     • SEARCH_SERVICE_CLIENT_BASE_URL: host.docker.internal:9000

步骤5：配置PHPUnit测试框架

1. 打开PhpStorm偏好设置，导航至Languages & Frameworks > PHP > Test Frameworks
2. 点击"+"选择"PHPUnit by Remote Interpreter"：
   • CLI解释器：Docker PHP（步骤3中创建的）
   • 路径映射：<项目根目录> -> /opt/project
   • Docker容器配置：同步骤4中的容器设置
   • PHPUnit库：使用Composer自动加载器
   • 脚本路径：/opt/project/vendor/autoload.php（系统会识别PHPUnit版本8.5.8）
3. 点击OK保存