面向 WEB 开发人员的 Docker（五）：部署开发 WordPress

前面介绍了 Docker 的一些基本知识和使用，对于新技术或者新系统想去尝试运行起来，Docker 是一个最佳的选择，上手容易，抛弃也容易，如果系统或者应用运行起来后不需要了可以直接删除即可，对宿主机没有任何的影响，也不会受到宿主机环境的干扰。本文将分享如何使用 Docker 构建 WordPress 环境，并运行起来。

WordPress 是 2003 年首次发布的基于PHP和MySQL的开放源代码内容管理系统。它为 40％的网站提供支持，受到许多 Web 主机的支持，易于设置，并提供数千个免费主题和插件。

对于大多数人来说，WordPress 是一个博客系统，其实不然，可以为以下需求提供解决方案：

• 可以作为网站的 CMS，编辑内容，生成静态网站

• 作为服务器端，为前端提供 API，如 Vue、React、Angular 等

• 构建门户、社区、视频等内容网站

• ......

即使你不使用（或不想使用）WordPress，本文主要分享 Docker 如何构建一个运行环境来执行代码，环境配置对于开发来说必不可少，但 Docker 值得你去尝试。

本章中创建的文件包含在 https://github.com/QuintionTang/docker-wordpress 提供的示例代码存储库的 wordpress 目录中

环境要求

要运行 WordPress 需要配置的环境：

• Web 服务器，通常为 Apache

• PHP 运行时和扩展，然后相应地配置 Web 服务器

• MySQL 或 MariaDB 定义一个供 WordPress 使用的新数据库

• WordPress 本身，以及所有必需的主题和插件。

XAMPP 之类的工具可以降低环境的配置难度，但是，有了 Docker，你只需要几分钟就可以运行 WordPress 并开发代码。

Windows 用户还将发现 WordPress 在基于 Docker 的基于 Linux 的文件系统上的运行要比本地 NTFS 驱动器快得多。

Docker 配置

需要提取两个 Docker 镜像：

• wordpress：最新的镜像是个不错的选择，它提供了 Debian Linux、Apache、PHP 和 WordPress 的稳定版本。

• mysql：wordpress 数据库，选择 8.0

启动这两个镜像，并加入 Docker 网络中wpnet。

Docker volumes

创建两个 Docker volumes：

• wpdata：存储数据文件，在 MySQL 容器中挂载到/var/lib/mysql
  

• wpfiles：WordPress 应用程序文件夹，对应容器 Apache 服务器根目录中/var/www/html。

可能有人会觉得挂载wpfiles卷是一种反模式，这样 WordPress 容器不再是无状态的。不过 WordPress 并不是一个无状态的应用程序。为了开发目的，Docker 被用来模拟一个活动服务器环境。

挂载wpfiles卷有很多好处：

• Docker 的启动速度更快：这样无需每次启动容器时都复制核心 WordPress 文件

• WordPress 应用程序可以自动更新：这将在安装中发生，因此在开发期间对其进行复制非常有用

如果不挂载wpfiles卷，则需要经常运行docker pull wordpress以下载最新的应用程序镜像。

挂载开发目录

wp-content子目录将在主机 PC 上的项目目录中创建。对应 WordPress 容器的/var/www/html/wp-content目录，目录包含所有插件、主题和上传的资源。

WordPress 开发人员一般只需在wp-content目录中创建和修改文件。

另外，对于项目开发，就需要将wp-content文件提交到 Git 仓库更加容易，因为这个目录是宿主机 PC 上唯一的 WordPress 文件夹。

localhost 域名替换

WordPress 将启动在localhost域上，在实际开发中如果涉及多个站点，不希望用端口进行切换，同时也会带来一些问题。

• 浏览器可能会缓存来自一个站点的文件，并在另一个站点上显示它们。

• WordPress 将访问域名存储在其数据库中，因此使用一个和生产环境一致的域名可以避免一些问题。

为了避免以上的问题，可以在文件中配置其他域以供开发使用，这就涉及更改本机hosts

• 在 Linux 和 macOS 上，修改文件：/etc/hosts
  

• 在 Windows 上，修改文件：C:\Windows\System32\drivers\etc\hosts
  

在主机文件的底部添加一行，例如 127.0.0.1 devpoint.wordpress 并保存。对于 Windows 用户必须运行nbtstat -R或重新启动。

这样，就可以使用 http://devpoint.wordpress 进行访问，而不是 http://localhost，实际上两者都解析到 127.0.0.1。

修改 hosts ，是前端经常用来模拟一个真实访问常用的手段。

docker run --mount "src=wpfiles,target=/var/www/html" -v $PWD/wp-content:/var/www/html/wp-content

$PWD引用 Linux 和 macOS 上的当前目录。它在 Windows 上不可用，因此必须使用正斜杠表示法指定完整路径，如下：

docker run --mount "src=wpfiles,target=/var/www/html" -v /c/projects/wordpress/wp-content:/var/www/html/wp-content

Docker Compose 配置

Docker Compose 是一个用于管理具有关联 volumes 和网络的多个容器的工具。单个配置文件，通常命名为 docker-compose.yml，定义容器，并可以在必要时覆盖 Dockerfile 设置。详细的介绍请参阅《面向WEB开发的Docker（二）：什么是Docker、镜像、编排？》

在项目目录下创建目录 wordpress

mkdir wordpresscd wordpress

这里将使用Docker Compose，在目录中创建docker-compose.yml文件，代码如下：

version: "3" # 表示该 Docker-Compose 文件使用的版本为3services:    mysql:        image: mysql:8        container_name: mysql        environment:            - MYSQL_DATABASE=wpdb            - MYSQL_USER=wpdbuser            - MYSQL_PASSWORD=devpoint            - MYSQL_ROOT_PASSWORD=devpointCn        volumes:            - wpdata:/var/lib/mysql        ports:            - "3306:3306"        networks:            - wpnet        restart: on-failure    wordpress:        image: wordpress        container_name: wordpress        depends_on:            - mysql        environment:            - WORDPRESS_DB_HOST=mysql            - WORDPRESS_DB_NAME=wpdb            - WORDPRESS_DB_USER=wpdbuser            - WORDPRESS_DB_PASSWORD=devpoint        volumes:            - wpfiles:/var/www/html            - ./wp-content:/var/www/html/wp-content        ports:            - "80:80"        networks:            - wpnet        restart: on-failurevolumes:    wpdata:    wpfiles:networks:    wpnet:

下面就来对上面的代码做个详细的介绍：

环境变量

MySQL 环境变量包括MYSQL_DATABASE、MYSQL_USER、MYSQL_PASSWORD和MYSQL_ROOT_PASSWORD ：

• MYSQL_DATABASE：数据库名称，这里定义为 wpdb
  

• MYSQL_USER：数据库用户名称，这里定义为 wpdbuser
  

• MYSQL_PASSWORD：数据库连接密码，定义为devpoint
  

• MYSQL_ROOT_PASSWORD：数据库root用户密码，定义为devpointCn，在应用程序连接中不会用到 root 用户，但对于备份数据或执行其他数据库维护就需要，因此这里也进行了定义

接下来设置 WordPress 的环境变量，包括WORDPRESS_DB_HOST、WORDPRESS_DB_NAME、WORDPRESS_DB_USER、WORDPRESS_DB_PASSWORD：

• WORDPRESS_DB_HOST：连接地址，这里我们定义为 mysql

• WORDPRESS_DB_NAME：连接数据库名称，上面定义的是 wpdb
  

• WORDPRESS_DB_USER：连接数据库用户名称，这里为 wpdbuser
  

• WORDPRESS_DB_PASSWORD：对应的数据库连接密码，为devpoint
  

端口暴露

MySQL 的端口3306是暴露给宿主机 PC 的，所以它可以连接和检查数据库使用任何 MySQL 客户端。

ports:      - "3306:3306"

上面代码的意思是容器中的 3306 端口和宿主机的 3306 端口对应。

如果不想将端口暴露给宿主机，就不需要与其对应，如下：

ports:      - "3306"

这样暴露端口对 Docker 网络中的其他容器也可用，但不会将其暴露给宿主机，从安全的角度可以起到隔离的效果。WordPress 容器不会受到影响，但是宿主机上的 MySQL 客户端将无法连接到容器中的 MySQL 数据库。

接下来就是 Apache 端口的暴露，WordPress 容器中绑定的端口为 80，前面的 80 为绑定的宿主机端口。

ports:      - "80:80"

WordPress 卷绑定挂载

WordPress 容器定义了两个，Mysql 容器定义了 1 个：

• wpfiles ：对应 Docker 中 Apache 服务器根目录下/var/www/html
  

• wp-content：对应 Docker 中/var/www/html/wp-content
  

• wpdata：对应 Docker 中/var/lib/mysql
  

    volumes:      - wpdata:/var/lib/mysql    volumes:      - wpfiles:/var/www/html      - ./wp-content:/var/www/html/wp-content

启动 WordPress 环境

一切都准备好了，就是这么简单！打开一个终端，访问项目目录，然后输入：

docker-compose up

一切下载安装全部自动完成，由于 Docker 需要下载镜像、初始化数据库并复制应用程序文件，因此该过程在第一次运行时可能需要花费几分钟。

安装 WordPress

在浏览器中打开前面我们设置好的域名devpoint.wordpress，首次执行此操作时，将进入 WordPress 安装流程：

按照流程输入基本信息，即可完成安装。

下面选择主题Appointment Dark，进行安装，并启用。

本地 WordPress 开发

现在，可以在宿主机 PC 的目录wp-content中添加、编辑或删除主题插件。

管理面板限制

WordPress 允许直接从管理面板中安装、编辑和删除主题和插件文件，这在 Windows 上是允许的，但是 Linux 和 mac OS 用户可能需要通过在宿主机上输入以下命令授予对项目的wp-content文件夹的权限：

chmod -R 777 ./wp-content

主题制作

要开始开发一个新的 WordPress 主题，在宿主机上目录wp-content/themes中创建主题文件夹，例如 devpoint ，并添加一个style.css样式文件:

/*Theme Name: DevPoint ThemeVersion: 1.0.0License: MIT*/
body {    margin: 0px;    padding: 30px;    background-color: #efefef;    font-family: "Microsoft YaHei", "微软雅黑", "pingfang sc", "宋体", Arial,        Helvetica, sans-serif;    line-height: 1.5;    color: #212529;}

接着再添加一个 index.php 文件，代码如下：

<!DOCTYPE html><html <?php language_attributes(); ?>><head><title><?php bloginfo('name'); ?></title><link rel="stylesheet" href="<?php bloginfo('stylesheet_url'); ?>"><?php wp_head(); ?></head><body>  <header>    <h1><?php bloginfo('name'); ?></h1>    <p><?php bloginfo('description'); ?></p>  </header>  <main>    <?php      if ( have_posts() ) : while ( have_posts() ): the_post(); ?>      <article id="post-<?php the_ID(); ?>">        <h2><?php the_title(); ?></h2>        <?php the_excerpt(); ?>      </article>    <?php      endwhile;    endif;    ?>  </main>  <?php wp_footer(); ?></body></html>

在 WordPress 管理面板的“外观”>“主题”页面中激活此主题，刷新页面即可看到如下效果。

点击启用，既可完成自制主题启用。

总结

到这里，已经基本可以使用 Docker 构建简单的 WEB 应用了，在前端开发中，合理利用 Docker，可以减少很多环境带来的问题。