curology/docker-php-node-browser

docker-php-node-browser 镜像文档

镜像概述

docker-php-node-browser是一个集成了PHP环境、Node.js环境和Chrome浏览器的Docker镜像，旨在为Web应用的集成测试提供一站式运行环境。通过整合多种开发和测试所需的核心组件，简化测试环境配置流程，确保测试环境的一致性和可重复性。

核心功能与特性

• 多环境集成：同时包含PHP运行环境、Node.js运行环境及Chrome浏览器，满足多技术栈测试需求
• 测试友好：内置浏览器环境，支持基于浏览器的自动化测试（如Selenium、Cypress等工具）
• 环境一致性：统一的容器化环境，避免因本地环境差异导致的测试结果不一致问题
• 即开即用：无需手动配置多组件依赖，拉取镜像后可直接用于测试场景

使用场景

• Web应用的集成测试，需同时运行PHP后端代码和Node.js前端脚本
• 前后端联合测试，验证完整业务流程
• 需要浏览器环境的自动化测试（如端到端测试、UI测试）
• CI/CD流程中的自动化测试环节，确保代码提交前的质量验证

使用方法

基本使用（docker run）

通过以下命令启动容器并运行测试：

bash
docker run -v /path/to/your/test/code:/app -w /app docker-php-node-browser [测试命令]

参数说明：

• -v /path/to/your/test/code:/app：将本地测试代码目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app
• [测试命令]：替换为实际的测试命令（如php vendor/bin/phpunit && node test/script.js && npx cypress run）

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  test:
    image: docker-php-node-browser
    volumes:
      - ./test-code:/app
    working_dir: /app
    command: sh -c "composer install && npm install && phpunit && npx cypress run"

启动测试环境：

bash
docker-compose up

环境变量（可选）

根据实际测试需求，可通过环境变量调整PHP、Node.js或Chrome的配置，例如：

• PHP_INI：自定义PHP配置（需挂载配置文件）
• NODE_ENV：设置Node.js环境（如test、development）
• CHROME_FLAGS：传递Chrome启动参数（如--no-sandbox、--headless）

注意事项

• 运行浏览器测试时，建议添加--headless参数以无界面模式运行Chrome，适合CI/CD环境
• 确保挂载的测试代码目录包含必要的依赖配置文件（如composer.json、package.json）
• 根据测试需求调整容器资源限制（如内存、CPU），避免因资源不足导致测试失败