redwebaps/devbox

redWEB开发工具箱Docker镜像

概述

本Docker镜像专为redWEB项目开发设计，集成了开发过程中所需的核心组件和工具，旨在简化开发环境配置，提供一致的开发体验。通过整合Web服务器、PHP运行环境及代码质量工具，满足redWEB开发过程中的各类执行需求。

核心功能与特性

集成组件

• Apache：提供Web服务器环境，支持HTTP服务及动态内容解析
• PHP：包含PHP运行环境，支持redWEB项目的PHP代码执行
• PHPcs及批准标准：集成PHP代码规范检查工具（PHP CodeSniffer）及预配置的批准标准，确保代码风格一致性
• PHPMd：PHP代码质量分析工具（PHP Mess Detector），用于检测代码中的潜在问题、不良实践等
• Composer初始文件：预配置与redWEB-devbox镜像及MySQL服务器配合使用的Composer初始配置
• 代理可执行文件：提供工具代理机制，支持从本地机器直接启动容器内的PHP工具

使用场景

适用于redWEB项目的开发阶段，特别是需要执行以下操作的场景：

• 本地开发环境搭建与测试
• PHP代码规范检查（通过PHPcs）
• 代码质量分析与优化（通过PHPMd）
• 基于Apache和PHP的Web应用调试

使用方法与配置说明

基本使用（Docker Run）

通过以下命令启动镜像，映射必要端口并挂载项目目录：

bash
docker run -d \
  -p 80:80 \
  -v /path/to/redweb/project:/var/www/html \
  --name redweb-devbox \
  redweb-devbox-image

参数说明：

• -p 80:80：映射容器Apache服务端口到本地80端口
• -v /path/to/redweb/project:/var/www/html：挂载本地redWEB项目目录到容器Web根目录
• --name redweb-devbox：指定容器名称为redweb-devbox

Docker Compose配置

结合MySQL服务器使用时，可创建docker-compose.yml文件：

yaml
version: '3'
services:
  web:
    image: redweb-devbox-image
    ports:
      - "80:80"
    volumes:
      - ./redweb-project:/var/www/html
    depends_on:
      - db
    environment:
      - DB_HOST=db
      - DB_USER=root
      - DB_PASSWORD=password
      - DB_NAME=redweb

  db:
    image: mysql:5.7
    ports:
      - "3306:3306"
    environment:
      - MYSQL_ROOT_PASSWORD=password
      - MYSQL_DATABASE=redweb
    volumes:
      - mysql-data:/var/lib/mysql

volumes:
  mysql-data:

启动命令：

bash
docker-compose up -d

PHP工具使用

通过代理可执行文件从本地机器启动容器内的PHP工具：

bash
# 执行PHPcs检查
./phpcs-proxy /var/www/html/path/to/code

# 执行PHPMd分析
./phpmd-proxy /var/www/html/path/to/code text cleancode,codesize,controversial,design,naming,unusedcode

说明：代理可执行文件（如phpcs-proxy、phpmd-proxy）需放置在本地机器，并配置指向运行中的redweb-devbox容器。