wordpressdevelop/cli Docker 镜像 - 轩辕镜像

镜像概述

该Docker镜像提供WP-CLI（WordPress Command Line Interface）的运行环境，专为WordPress本地开发场景设计。WP-CLI是WordPress官方命令行工具，允许开发者通过命令行高效执行网站管理、配置修改、插件/主题管理等操作，无需依赖图形化界面，适用于提升本地开发流程的自动化与效率。

核心功能与特性

核心功能

• WordPress核心管理：安装、更新WordPress核心文件，配置网站基础信息（如站点URL、标题、管理员账户）。
• 插件/主题管理：通过命令行安装、激活、更新、禁用、删除WordPress插件和主题，支持批量操作。
• 数据库操作：执行数据库导出（wp db export）、导入（wp db import）、查询（wp db query）、优化（wp db optimize）等操作。
• 配置管理：修改wp-config.php文件（如设置数据库参数、调试模式WP_DEBUG），管理WordPress常量配置。
• 用户管理：创建、修改、删除用户，分配用户角色（管理员、编辑、作者等），重置用户密码。
• 内容管理：发布、编辑、删除文章/页面，管理分类和标签。

主要特性

• 轻量级：基于精简的PHP环境构建，镜像体积小，启动速度快。
• 版本兼容性：支持与主流WordPress版本匹配的WP-CLI版本，确保命令兼容性。
• 无界面依赖：完全通过命令行操作，适合集成到脚本或自动化流程中。
• 可扩展性：支持加载自定义WP-CLI命令或第三方命令包。

使用场景与适用范围

• 本地WordPress开发：搭配Docker Compose构建LAMP/LEMP本地开发环境，快速执行网站初始化、插件测试等操作。
• 开发自动化脚本：编写Shell/Python脚本，通过WP-CLI实现批量建站、插件批量部署、环境一致性配置等自动化任务。
• CI/CD流程集成：在持续集成/部署流程中，通过WP-CLI自动完成测试环境的WordPress安装、数据库迁移等步骤。
• 多站点管理：高效管理WordPress多站点（Multisite）网络，包括站点创建、用户权限分配等操作。
• 教学与演示：在无需图形化界面的环境中（如服务器终端），演示WordPress核心功能或插件使用方法。

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+推荐）。
• 本地已存在WordPress项目目录（或通过Docker Compose联动WordPress容器）。
• 若涉及数据库操作，需确保WordPress数据库服务可访问（如本地MySQL/MariaDB或Docker数据库容器）。

基本使用（docker run）

通过docker run直接执行WP-CLI命令，需将本地WordPress目录挂载到容器内的WordPress路径（默认/var/www/html）。

命令格式

bash
docker run --rm -v [本地WordPress目录路径]:/var/www/html [镜像名称] wp [WP-CLI命令]

• --rm：命令执行后自动删除容器，避免残留。
• -v：挂载本地WordPress目录到容器，确保WP-CLI可访问WordPress文件。

示例：查看WordPress版本

假设本地WordPress项目目录为./my-wp-site，执行以下命令查看当前WordPress版本：

bash
docker run --rm -v $(pwd)/my-wp-site:/var/www/html wordpress:cli wp core version

结合Docker Compose使用

推荐通过docker-compose.yml定义WP-CLI服务，与WordPress、数据库容器联动，简化命令执行流程。

docker-compose.yml示例

yaml
version: '3.8'

services:
  # WordPress服务
  wordpress:
    image: wordpress:latest
    volumes:
      - ./my-wp-site:/var/www/html  # 本地WordPress目录挂载
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wpdb
    ports:
      - "8080:80"
    depends_on:
      - db

  # 数据库服务
  db:
    image: mysql:8.0
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: wpdb
      MYSQL_USER: wpuser
      MYSQL_PASSWORD: wppass

  # WP-CLI服务
  wpcli:
    image: wordpress:cli  # 使用WP-CLI镜像
    volumes:
      - ./my-wp-site:/var/www/html  # 共享WordPress目录
    environment:
      # 数据库连接参数（需与WordPress服务一致）
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
      WORDPRESS_DB_NAME: wpdb
    depends_on:
      - wordpress
      - db

volumes:
  db_data:

执行WP-CLI命令

通过docker-compose run调用wpcli服务执行命令，示例：

• 安装WordPress核心：

  bash
  docker-compose run --rm wpcli wp core install \
    --url=localhost:8080 \
    --title="My Local Site" \
    --admin_user=admin \
    --admin_password=admin123 \
    --admin_email=***
  

• 安装并激活插件（如Akismet）：

  bash
  docker-compose run --rm wpcli wp plugin install akismet --activate
  

• 导出数据库：

  bash
  docker-compose run --rm wpcli wp db export backup_$(date +%Y%m%d).sql
  

常用WP-CLI命令示例

配置参数与环境变量