hacklab/wordpress

WordPress Docker镜像

镜像概述和主要用途

该镜像主要用于WordPress插件和主题开发，同时也可用于托管WordPress网站。集成了OPCache、X-Debug和WP-Cli等实用工具与库，为开发和部署提供便利。

核心功能和特性

• 支持通过环境变量覆盖wp-config.php配置
• 允许挂载目录自定义配置（/var/www/html/wp-config.d）
• 内置X-Debug调试工具，便于开发调试
• 包含WP-Cli工具，支持WordPress命令行操作
• 默认启用多种常用PHP模块，满足多数WordPress项目需求

使用场景和适用范围

• WordPress插件开发与测试
• WordPress主题开发与调试
• 本地WordPress开发环境搭建
• 小型WordPress网站部署

使用方法和配置说明

覆盖配置

可通过环境变量覆盖wp-config.php中的值。以下是wp-config.php中存在的变量及其默认值：

覆盖未在wp-config.php中定义的变量

若需添加未在上述表格中列出的变量，可挂载包含配置文件的目录至/var/www/html/wp-config.d。该目录下的所有PHP文件将被包含到wp-config.php中，也可用于覆盖默认wp-config.php中的变量。

注意事项

若在反向代理后或虚拟主机内运行，WORDPRESS_HOME和WORDPRESS_SITEURL的默认值可能是安全的。但如果容器接收到带有意外SERVER_NAME的请求，必须为这些变量提供值。无论如何，显式设置这些变量是一个好习惯。

开发环境

WordPress安装在/var/www/html目录。开发插件时，可将插件目录挂载至/var/www/html/wp-content/plugins。

以下是开发名为“Awesome”的插件时的docker-compose.yml示例：

yaml
version: '2'

services:
  web:
    image: hacklab/wordpress
    environment:
      - WORDPRESS_DEBUG=true
      - WORDPRESS_DB_USER=the_db_user
      - WORDPRESS_DB_PASSWORD=the_db_pass
      - WORDPRESS_DB_NAME=the_db_name
    ports:
      - "80:80"

  mysql:
    image: mariadb
    environment:
      - MYSQL_USER=the_db_user
      - MYSQL_PASSWORD=the_db_pass
      - MYSQL_DATABASE=the_db_name
      - MYSQL_ROOT_PASSWORD=the_root_pass
      - TERM=xterm

X-Debug

当容器环境变量WORDPRESS_DEBUG=true时，X-Debug配置会自动创建，容器将接受来自任何主机的连接。若需禁用X-Debug，设置环境变量XDEBUG=false。

Atom用户

通过编辑config.cson告知Atom文件夹映射，需配置“php-debug”部分，示例如下：

cson
  "php-debug":
    PathMaps: [
      "remotepath;localpath"
      "/var/www/html/;/local/path/to/wordpress/"
    ]
    PhpException:
      CatchableFatalError: false
      Deprecated: false
      FatalError: false
      Notice: false
      ParseError: false
      StrictStandards: false
      UnknownError: false
      Warning: false
      Xdebug: false
    ServerPort: 9000

默认启用的模块

以下模块适用于大多数Hacklab WordPress项目，并可能对广泛项目有用。虽然模块会占用每个Apache进程的内存，但这些模块支持多种WordPress缓存插件（如W3 Total Cache）：

• apcu
• calendar
• Core
• ctype
• curl
• date
• dom
• fileinfo
• filter
• ftp
• gd
• hash
• iconv
• json
• libxml
• mbstring
• mcrypt
• memcached
• mysqli
• mysqlnd
• openssl
• pcre
• PDO
• pdo_mysql
• pdo_sqlite
• Phar
• posix
• readline
• redis
• Reflection
• session
• SimpleXML
• sockets
• SPL
• sqlite3
• standard
• tokenizer
• xml
• xmlreader
• xmlwriter
• zip
• zlib