signaleleven/wordpress

Visible Wordpress Starter

Visible团队及贡献者开发的Docker WordPress开发环境，目标是让WordPress开发少一些挫折感。

• 简介
• 示例
• 要求
• 快速开始
• 可用镜像
• 默认WordPress管理员凭据
• 默认数据库凭据
• 服务环境变量
  • wordpress
  • db
• 工作流提示
  • 使用wp-cli
  • 数据库操作
• 生产环境使用
• 贡献

简介

我们撰写了一系列文章深入解释本项目的设计理念：

• 引言：略好一些的WordPress开发者工作流
• 第一部分：使用Docker搭建WordPress本地开发环境
• 第二部分：为WordPress主题开发搭建资源管道
• 第三部分：优化WordPress主题资源并部署到S3
• 第四部分：自动部署网站到服务器（待发布）

要求

运行Docker环境需要Docker。Dockerfile仅包含Apache+PHP+WordPress容器，需搭配MySQL或MariaDB容器运行网站。我们使用Docker Compose 1.6+进行编排。

快速开始

本项目包含两部分：Docker环境和主题开发工具集。快速开始只需运行以下命令：

bash
# 复制文件
git clone https://github.com/visiblevc/wordpress-starter.git

# 进入示例目录
cd wordpress-starter/example

# 在localhost:8080启动网站
docker-compose up -d && docker-compose logs -f wordpress

注意：若在macOS上使用VirtualBox中的Docker，需运行以下命令转发端口：VBoxManage controlvm vm-name natpf1 "tcp8080,tcp,127.0.0.1,8080,,8080"。如使用其他端口，需相应修改命令中的端口号。

可用镜像

如需特定版本，请查看更新日志。

默认WordPress管理员凭据

访问/wp-admin的WordPress管理后台，默认凭据如下：

默认数据库凭据

服务环境变量

注意：

• 标记✅的变量为必填项
• 布尔型环境变量必须用单引号包裹

wordpress

db

工作流提示

使用wp-cli

可通过npm run wp ...访问wp-cli，示例：

bash
npm run wp plugin install <插件名>
npm run wp db import /data/database.sql

数据库操作

若有现有网站导出的.sql文件，将其放入data/文件夹。首次运行容器时，会检测SQL dump并用作数据库；若未找到，则创建新数据库。

若SQL dump有更新，可通过以下命令重新加载数据库：

bash
docker-compose exec wordpress /bin/bash "wp db import $(find /data/*.sql | head -n 1) --allow-root"

若要创建开发数据库的备份，运行：

bash
docker-compose exec wordpress /bin/bash 'wp db export /data --allow-root'

开发环境域名通常与线上不同（如线上example.com，开发localhost:8080），可通过设置docker-compose.yml中的URL_REPLACE: example.com,localhost:8080环境变量自动完成搜索替换。

生产环境使用

调整docker-compose.yml

yaml
# 未显示的部分与示例配置相同
version: '3'
services:
  wordpress:
    ports:
      - 80:80
      - 443:443
    restart: always
    environment:
      SERVER_NAME: mysite.com
      DB_PASS: ${SECURE_PASSWORD} # 存储在.env文件中
    volumes:
      - ./letsencrypt:/etc/letsencrypt
      - ./data:/data
      # 其他需要备份的内容
  db:
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: ${SECURE_PASSWORD} # 存储在.env文件中

SSL证书

强烈建议使用SSL加密保护网站。Let's Encrypt和Certbot项目提供了免费且简单的解决方案，已集成到本项目中。

假设网站已在生产主机上运行，按以下步骤获取和更新SSL证书：

获取证书

bash
$ docker-compose ps
Name                   Command                        State
---------------------------------------------------------
project_db_1           docker-entrypoint.sh mysqld     Up
project_wordpress_1    docker-php-entrypoint /run.sh   Up

$ docker-compose exec wordpress /bin/bash
root@4e16c7fe4a10:/app# certbot --apache

更新证书

bash
$ docker-compose ps
Name                   Command                        State
---------------------------------------------------------
project_db_1           docker-entrypoint.sh mysqld     Up
project_wordpress_1    docker-php-entrypoint /run.sh   Up

$ docker-compose exec wordpress /bin/bash
root@4e16c7fe4a10:/app# certbot renew

贡献

开发说明请参见https://github.com/visiblevc/wordpress-starter/wiki/Development%E3%80%82