Docksal CLI Docker 镜像

镜像概述与主要用途

本镜像为 Docksal 项目的 CLI 服务镜像，专注于提供 LAMP 栈应用开发所需的控制台工具。作为 Docksal 镜像库的一部分，其主要用途是为 LAMP 架构应用（如 Drupal、WordPress 等）的开发过程提供集成化的命令行工具环境，简化开发依赖管理。

版本与镜像标签命名规范

稳定版本

• 2.2-php5.6、php5.6：对应 PHP 5.6
• 2.2-php7.0、php7.0：对应 PHP 7.0
• 2.2-php7.1、php7.1：对应 PHP 7.1
• 2.2-php7.2、php7.2、latest：对应 PHP 7.2（latest 标签默认指向此版本）

开发版本

• edge-php5.6：PHP 5.6 开发版
• edge-php7.0：PHP 7.0 开发版
• edge-php7.1：PHP 7.1 开发版
• edge-php7.2：PHP 7.2 开发版

核心功能与包含工具

PHP 相关工具

• 基础运行环境：php-fpm、php-cli
• 调试工具：Xdebug（默认禁用）
• 依赖管理：Composer
• Drupal 工具：
  • Drush（6、7、8 版本），含 registry_rebuild 组件
  • coder-8.x + phpcs（代码规范检查）
  • Drupal Console 启动器
• WordPress 工具：wp-cli

Ruby 相关工具

• ruby
• gem（RubyGems 包管理器）
• bundler（Ruby 依赖管理工具）

Node.js 相关工具

• nvm（Node 版本管理器）
• nodejs（通过 nvm 安装）
• npm（Node 包管理器）、yarn（依赖管理工具）

Python

• Python 运行环境

其他主要工具

• 版本控制：git
• 网络工具：curl、wget
• 压缩/解压缩：zip、unzip
• 数据库客户端：mysql-client
• 图像处理：imagemagick
• 文件管理：mc（Midnight Commander）
• 邮件发送：mhsendmail

使用场景与适用范围

本镜像适用于 LAMP 栈应用的开发阶段，尤其适合需要多语言工具链协同的场景，例如：

• PHP 应用（如 Drupal、WordPress）的后端开发与调试
• 前端资源构建（依赖 Node.js、npm/yarn）
• Ruby 脚本运行或依赖管理
• 多工具链集成的自动化脚本执行（如使用 Composer 管理 PHP 依赖、npm 构建前端资源）

使用方法与配置说明

基本使用

本镜像通常作为 Docksal 环境的一部分使用，通过 docker-compose.yml 配置集成。典型的服务定义如下：

yaml
version: '3'
services:
  cli:
    image: docksal/cli:latest  # 或指定具体版本标签，如 php7.2
    volumes:
      - ./:/var/www  # 挂载项目代码目录
    environment:
      - XDEBUG_ENABLED=0  # Xdebug 默认禁用
      # 其他环境变量配置

Xdebug 配置

Xdebug 默认禁用，如需启用，需在环境变量中设置 XDEBUG_ENABLED=1：

yaml
services:
  cli:
    ...
    environment:
      ...
      - XDEBUG_ENABLED=1  # 启用 Xdebug
      ...

启用后，可参考 Docksal ***文档 配置 Web 和 CLI 模式下的 PHP 调试。