devgeniem/alpine-wordpress

轻量级WordPress PHP-FPM & Nginx Docker镜像

![License]([***]

这是一个维护中的仓库，我们在生产环境中使用此项目，并推荐您的项目也使用它。该容器不包含MySQL或邮件服务，需从外部来源（如其他容器或主机）提供。

容器进程设计

我们认为Docker容器应运行一组提供单一服务的小型进程，而非单个笨拙进程。此容器通过https://github.com/just-containers/s6-overlay%E5%90%8C%E6%97%B6%E8%BF%90%E8%A1%8CPHP-FPM%E5%92%8CNginx%E3%80%82

目录布局

将WordPress项目挂载到：

/data/code

项目Web根目录需定义在：

/data/code/web

该路径与https://github.com/roots/bedrock%E5%85%BC%E5%AE%B9%EF%BC%8C%E6%98%AFNginx%E7%9A%84%E8%AF%B7%E6%B1%82%E6%9C%8D%E5%8A%A1%E7%9B%AE%E5%BD%95%E3%80%82

用户权限配置

• 使用WP_GID和WP_UID环境变量自定义Web用户/组
• 未设置时，自动读取/data/code/web/下文件的所有者/组
• 若文件为root所有，自动使用100:101权限（避免以root运行服务）

Nginx自定义配置

在项目中挂载/data/code/nginx目录，支持：

• 包含到http块：/data/code/nginx/http/*.conf
• 包含到server块：/data/code/nginx/server/*.conf 更多细节见https://github.com/devgeniem/wp-project%E3%80%82

定时任务

在/data/code/tasks.cron放置定时任务文件，将以wordpress用户运行。示例：

* * * * * echo "测试日志：$(whoami)" >> /tmp/test.log

环境变量

时区

TZ # 默认：Europe/Helsinki，可选值见[PHP时区列表](http://php.net/manual/en/timezones.php)

运行模式

WP_ENV # 默认空，可选development（禁用opcache+启用xdebug）/production
XDEBUG_REMOTE_HOST # 远程xdebug的IP地址，默认空

数据库配置

DB_NAME/DB_PASSWORD/DB_USER/DB_HOST/DB_PORT # 需手动设置，自动注入PHP环境

邮件配置

SMTP_HOST # 默认：172.17.0.1（Docker主机）
SMTP_PORT # 默认：25
SMTP_TLS/SMTP_USER/SMTP_PASSWORD/SMTP_AUTH # 邮件认证相关，详情见[msmtp文档](http://msmtp.sourceforge.net/doc/msmtp.html#Authentication)

容器内置工具

WordPress运行工具

php7、php-fpm7、nginx、wp-cli、composer

测试工具

phantomjs、ruby、poltergeist、rspec、capybara

其他

ssh客户端

部署示例

Docker Run

bash
docker run -d \
  -p 8080:80 \
  -v /本地项目路径:/data/code \
  -e TZ=Asia/Shanghai \
  -e WP_ENV=production \
  -e DB_NAME=wordpress \
  -e DB_USER=root \
  -e DB_PASSWORD=yourpass \
  -e DB_HOST=mysql-container \
  devgeniem/alpine-wordpress

Docker Compose

yaml
version: '3'
services:
  wordpress:
    image: devgeniem/alpine-wordpress
    ports: ["8080:80"]
    volumes: ["./本地项目:/data/code"]
    environment:
      TZ: Asia/Shanghai
      WP_ENV: production
      DB_NAME: wordpress
      DB_USER: root
      DB_PASSWORD: yourpass
      DB_HOST: mysql
    depends_on: [mysql]
  
  mysql:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: yourpass
      MYSQL_DATABASE: wordpress