Docker PHP 入门实践(三)
在本教程的其余部分，我们将基于 ThinkPHP 框架完成一个天气查询的应用。使用 天气查询-API文档-开发指南-Web服务 API | 高德地图API 的接口来实现我们的功能。把查询数据缓存到 MySql 中，这样就不用每次频繁的请求第三方的接口了（有请求次数限制）
选择高德开放平台-天气查询 API 主要是因为它是免费的。当然你也可以使用其他的第三方天气查询接口，看个人喜好。
该应用是一个非常简单的 REST API 应用，主要实现两个接口。
在我们进行应用编码之前，首先使用 Docker 安装并运行 ThinkPHP
ThinkPHP 是一个免费开源的，快速、简单的面向对象的 轻量级PHP开发框架 ，是为了敏捷WEB应用开发和简化企业应用开发而诞生的。ThinkPHP从诞生以来一直秉承简洁实用的设计原则，在保持出色的性能和至简代码的同时，更注重易用性。遵循 Apache2 开源许可协议发布，意味着你可以免费使用ThinkPHP，甚至允许把你基于ThinkPHP开发的应用开源或商业产品发布/销售 。
这就是为什么我选择它作为本教程的教学框架。我不想让你因为一个框架而放弃，但我也不想从头开始建立所有的东西，因为该教程的重点是Docker，而不是我们的PHP应用。
用Docker 创建 ThinkPHP 应用 实际上比用本地配置PHP环境所需的操作少。并且为我们还需要使用 Composer，多亏了Docker，我们甚至不需要在主机上安装它。
首先打开你的终端，创建一个项目目录。
并进入到该目录中
现在使用[官方Composer Docker镜像]（）安装 ThinkPHP 。
如果你查看weather-app/目录，你会看到 ThinkPHP 6 的项目目录，如下所示：
我们的 docker 运行命令与第二章中的命令相似，但我们使用了不同的镜像。我们没有使用运行hello.php 脚本的 PHP 镜像，而是使用了一个 Composer 镜像。让我们来看看有什么变化。
项目创建完成后，我们需要添加几个路由 URL 和 Controller 文件 。让我们打开 weather-app 目录下的 app/controller , 然后新建 Weather.php 文件，内容如下：
然后打开 weather-app 目录下的 app/route , 在 app.php 文件中追加如下内容：
现在我们可以在 Docker 容器中运行我们的应用程序，只是为了验证我们的程序是否运行正常，因为我们只添加了两个路由 URL。打开命令行，运行。
现在，在浏览器中打开 ，你应该看到一个空页面，上面有以下文字:
那么恭喜你，你刚刚已经成功地在 Docker 中运行了你的第一个 ThinkPHP 应用程序。
这次我们使用的docker run命令与我们用来运行 hello.php 脚本 和composer create-project ...的两个命令不同。原因是这次我们想获得包含 Apache 的最新版本的PHP，这样我们就可以为我们的 Web 应用提供服务。让我们更详细地了解新增的命令部分。
你可以通过向终端发送一个 "中断 "信号来停止和退出终端。在 windows 上，这可以通过按 Ctrl 和按c来实现。
运行你的新网络应用程序的另一个选择是在 "Detached"模式中运行容器。这意味着你在终端将不会看到来自你的容器的输出。这可以通过在我们之前的命令中添加-d标志来实现。
在分离模式下启动容器后，你的终端将显示新容器的完整ID--类似于a70d25c2a7cedae673f8ab...如果你想停止这个容器，你可以使用docker stop命令，用容器的ID告诉Docker。比如说
因为输入整个ID是很麻烦的，如果你愿意，Docker允许你只输入前三个或更多的字符。
最后，我建议为你的容器命名。我们在本书后面的许多例子中都会这样做，因为用名字来记住一个容器比用随机分配的ID要容易得多，再加上ID是随机的，所以每次你运行一个新版本的容器时，它都会得到一个新的ID。只要不是已经有一个同名的容器，名字就可以多次发出来。为了给我们的新应用容器命名，我们可以用传入的--name标志重新创建它。
在使用docker run命令时，还有许多可用的选项，所以你可能想更详细地阅读文档。在我们开发其余的应用程序时，我们会涉及其中的一些选项。
现在我们要引入高德的天气 SDK ，在使用该 SDK 之前你需要阅读高德开放平台-天气查询的技术文档，再添加 SDK 之前我们首先要确保所有现有的容器都停止了。
这个命令将列出所有正在运行的容器。你也可以通过添加-a标志来查看停止的容器。
如果有任何容器正在运行，那么在我们继续前进之前，使用docker stop 来停止它们。
该命令将在你的项目中装新的软件包。在这个过程中，你应该在终端看到一些类似这样的输出。
现在 SDK 已经安装完毕，可以使用了。
我们将使用刚刚添加的高德天气 SDK 来完善我们的业务逻辑，打开 controller 目录下的 Weather.php 添加以下内容：
我们做了一些更新--主要是对引入天气 API 初始化天气类
我们的应用程序已经初步完成了向API传递一个真实的位置ID并返回一些数据。首先，使用这个高德位置查询找到一个位置ID。我使用的是上海的ID进行测试。310000，当然你直接传 上海 也是可以的。ok，让我们再次运行Docker容器。
并在你的浏览器中访问正在运行的应用程序，地址是。你应该可以看到一个JSON数据，看起来像这样。
你的 Docker 化的 PHP 应用程序现在正从外部数据源返回真实数据，并在Apache中提供服务，但你可能会注意到，它的速度并不快（我的页面加载时间为1.92秒！）。
高德天气 API 是一个免费的服务，其他国家可能无法访问。为了解决这个问题，我们将把查询的数据保存在我们自己的 MySQL 数据库中，可以再下次访问的时候可以快速地响应。这将极大地提高性能，下个章节我们将学习如何用 Docker 将 MySql 与 PHP 应用程序相结合。
如何 在Docker窗口中部署PHP开发环境
环境部署一直是一个很大的问题，无论是开发环境还是生产环境，但是 Docker
将开发环境和生产环境以轻量级方式打包，提供了一致的环境。极大的提升了开发部署一致性。当然，实际情况并没有这么简单，因为生产环境和开发环境的配置是完全不同的，比如日志等的问题都需要单独配置，但是至少比以前更加简单方便了，这里以
PHP 开发作为例子讲解 Docker 如何布置开发环境。
一般来说，一个 PHP 项目会需要以下工具：
Web 服务器: Nginx/Tengine
Web 程序: PHP-FPM
数据库: MySQL/PostgreSQL
缓存服务: Redis/Memcache
这是最简单的架构方式，在 Docker 发展早期，Docker 被大量的滥用，比如，一个镜像内启动多服务，日志收集依旧是按照 Syslog
或者别的老方式，镜像容量非常庞大，基础镜像就能达到 80M，这和 Docker 当初提出的思想完全南辕北辙了，而 Alpine Linux
发行版作为一个轻量级 Linux 环境，就非常适合作为 Docker 基础镜像，Docker 官方也推荐使用 Alpine 而不是 Debian
作为基础镜像，未来大量的现有官方镜像也将会迁移到 Alpine 上。本文所有镜像都将以 Alpine 作为基础镜像。
Nginx/Tengine
这部分笔者已经在另一篇文章 Docker 容器的 Nginx 实践中讲解了 Tengine 的 Docker 实践，并且给出了
Dockerfile，由于比较偏好 Tengine，而且官方已经给出了 Nginx 的 alpine 镜像，所以这里就用
Tengine。笔者已经将镜像上传到官方 DockerHub，可以通过
codedocker pull chasontang/tengine:2.1.2_f/code
获取镜像，具体请看 Dockerfile。
PHP-FPM
Docker 官方已经提供了 PHP 的 7.0.7-fpm-alpine 镜像，Dockerfile 如下：
FROM alpine:3.4
# persistent / runtime deps
ENV PHPIZE_DEPS \
autoconf \
file \
g++ \
gcc \
libc-dev \
make \
pkgconf \
re2c
RUN apk add --no-cache --virtual .persistent-deps \
ca-certificates \
curl
# ensure www-data user exists
RUN set -x \
addgroup -g 82 -S www-data \
adduser -u 82 -D -S -G www-data www-data
# 82 is the standard uid/gid for "www-data" in Alpine
#
#
#
ENV PHP_INI_DIR /usr/local/etc/php
RUN mkdir -p $PHP_INI_DIR/conf.d
##autogenerated##
ENV PHP_EXTRA_CONFIGURE_ARGS --enable-fpm --with-fpm-user=www-data --with-fpm-group=www-data
##/autogenerated##
ENV GPG_KEYS 1A4E8B7277C42E53DBA9C7B9BCAA30EA9C0D5763
ENV PHP_VERSION 7.0.7
ENV PHP_FILENAME php-7.0.7.tar.xz
ENV PHP_SHA256 9cc64a7459242c79c10e79d74feaf5bae3541f604966ceb600c3d2e8f5fe4794
RUN set -xe \
apk add --no-cache --virtual .build-deps \
$PHPIZE_DEPS \
curl-dev \
gnupg \
libedit-dev \
libxml2-dev \
openssl-dev \
sqlite-dev \
curl -fSL "" -o "$PHP_FILENAME" \
echo "$PHP_SHA256 *$PHP_FILENAME" | sha256sum -c - \
curl -fSL "" -o "$PHP_FILENAME.asc" \
export GNUPGHOME="$(mktemp -d)" \
for key in $GPG_KEYS; do \
gpg --keyserver ha.pool.sks-keyservers.net --recv-keys "$key"; \
done \
gpg --batch --verify "$PHP_FILENAME.asc" "$PHP_FILENAME" \
rm -r "$GNUPGHOME" "$PHP_FILENAME.asc" \
mkdir -p /usr/src \
tar -Jxf "$PHP_FILENAME" -C /usr/src \
mv "/usr/src/php-$PHP_VERSION" /usr/src/php \
rm "$PHP_FILENAME" \
cd /usr/src/php \
./configure \
--with-config-file-path="$PHP_INI_DIR" \
--with-config-file-scan-dir="$PHP_INI_DIR/conf.d" \
$PHP_EXTRA_CONFIGURE_ARGS \
--disable-cgi \
# --enable-mysqlnd is included here because it's harder to compile after the fact than extensions are (since it's a plugin for several extensions, not an extension in itself)
--enable-mysqlnd \
# --enable-mbstring is included here because otherwise there's no way to get pecl to use it properly (see )
--enable-mbstring \
--with-curl \
--with-libedit \
--with-openssl \
--with-zlib \
make -j"$(getconf _NPROCESSORS_ONLN)" \
make install \
{ find /usr/local/bin /usr/local/sbin -type f -perm +0111 -exec strip --strip-all '{}' + || true; } \
make clean \
runDeps="$( \
scanelf --needed --nobanner --recursive /usr/local \
| awk '{ gsub(/,/, "\nso:", $2); print "so:" $2 }' \
| sort -u \
| xargs -r apk info --installed \
| sort -u \
)" \
apk add --no-cache --virtual .php-rundeps $runDeps \
apk del .build-deps
COPY docker-php-ext-* /usr/local/bin/
##autogenerated##
WORKDIR /var/www/html
RUN set -ex \
cd /usr/local/etc \
if [ -d php-fpm.d ]; then \
# for some reason, upstream's php-fpm.conf.default has "include=NONE/etc/php-fpm.d/*.conf"
sed 's!=NONE/!=!g' php-fpm.conf.default | tee php-fpm.conf /dev/null; \
cp php-fpm.d/ php-fpm.d/; \
else \
# PHP 5.x don't use "include=" by default, so we'll create our own simple config that mimics PHP 7+ for consistency
mkdir php-fpm.d; \
cp php-fpm.conf.default php-fpm.d/; \
{ \
echo '[global]'; \
echo 'include=etc/php-fpm.d/*.conf'; \
} | tee php-fpm.conf; \
fi \
{ \
echo '[global]'; \
echo 'error_log = /proc/self/fd/2'; \
echo; \
echo '[www]'; \
echo '; if we send this to /proc/self/fd/1, it never appears'; \
echo 'access.log = /proc/self/fd/2'; \
echo; \
echo 'clear_env = no'; \
echo; \
echo '; Ensure worker stdout and stderr are sent to the main error log.'; \
echo 'catch_workers_output = yes'; \
} | tee php-fpm.d/docker.conf \
{ \
echo '[global]'; \
echo 'daemonize = no'; \
echo; \
echo '[www]'; \
echo 'listen = [::]:9000'; \
} | tee php-fpm.d/zz-docker.conf
EXPOSE 9000
CMD ["php-fpm"]
##/autogenerated##
如何配置一个 Docker 化持续集成的 PHP 开发环境
首先，我们得知道什么才是好的开发环境， 对于我而言，一个好的开发环境需要具备以下几个特点：
可随意使用。我必须可以随意删除和创建新的环境。
快速启动。我想要用它工作时候，它立马就能用。
易于更新。在我们行业中，事物发展变化非常快，必须能让我很容易将我的开发环境更新到新的软件版本。
而Docker都支持以上这些特点，甚至更多。你几乎可以即时销毁和重建容器，而更新环境只需要重建你当前使用的镜像即可。
什么是PHP开发环境
目前Web应用错综复杂，PHP开发环境需要很多的东西，为了保证环境的简单性，需要做各种各样的限制。
我们这次使用Nginx、PHP5-FPM、MySQL来运行Synmfony项目。由于在容器中运行命令行会更复杂，所以这方面的内容我会放到下一篇博客中再说。
Pet 与 Cattle
另一个我们要讨论的重点是：我们要把开发环境部署在多容器还是单容器中。 两种方式各有优点：
单容器易于分发、维护。因为它们是独立的，所有的东西都运行在同一个容器中，这点就像是一个虚拟机。但这也意味着，当你要升级其中的某样东西（比如PHP新版本）的时候， 需要重新构建整个容器。
多容器可以在添加组件时提供更好的模块化。因为每个容器包含了堆栈的一部分：Web、PHP、MySQL等，这样可以单独扩展每个服务或者添加服务，并且不需要重建所有的东西。
因为我比较懒，加上我需要在我的笔记本上放点别的内容，所以，这里我们只介绍单个容器的方法。
初始化工程
首先要做的是初始化一个新的Symfony工程. 推荐的方法是用composer的create-project命令。本来可以在工作站上安装composer，但是那样太简单了。这次我们通过Docker来使用它。
我之前发过一篇关于Docker命令的文章：make docker commands（好吧，我说谎了，我本来把它写在这篇文章中了，然后觉得把它独立出来会比较好）。
不管怎么样，你可以读一下。接下来如果还没有composer命令的话，你可以创建一个属于自己的composer 别名。
$ alias composer="docker run -i -t -v \$PWD:/srv ubermuda/composer"
现在你可以初始化Symfony工程了：
$ composer create-project symfony/framwork-standard-edition SomeProject
帅呆了！下面来点实在的工作。(省略了博主自娱自乐的一堆balabla....原文:Awesome. Give yourself a high-five， get a cup of coffee or whatever is your liquid drug of choice， and get ready for the real work.)
容器
构建一个运行标准Symfony项目且自给自足的容器相当容易，只需要安装好常用的Nginx、PHP5-FPM和MySQL-Server即可，然后把预先准备好的Nginx的虚拟主机配置文件扔进去，再复制一些配置文件进去就完事了。
本容器的源代码在GitHub上的 ubermuda/docker-symfony仓库中可以找到。 Dockerfile 是Docker构建镜像要用到的配置文件，我们来看一下:
FROM debian:wheezy
ENV DEBIAN_FRONTEND noninteractive
RUN apt-get update -y
RUN apt-get install -y nginx php5-fpm php5-mysqlnd php5-cli mysql-server supervisor
RUN sed -e 's/;daemonize = yes/daemonize = no/' -i /etc/php5/fpm/php-fpm.conf
RUN sed -e 's/;listen\.owner/listen.owner/' -i /etc/php5/fpm/pool.d/
RUN sed -e 's/;listen\.group/listen.group/' -i /etc/php5/fpm/pool.d/
RUN echo "\ndaemon off;" /etc/nginx/nginx.conf
ADD vhost.conf /etc/nginx/sites-available/default
ADD supervisor.conf /etc/supervisor/conf.d/supervisor.conf
ADD init.sh /init.sh
EXPOSE 80 3306
VOLUME ["/srv"]
WORKDIR /srv
CMD ["/usr/bin/supervisord"]
我们通过扩展 debian:wheezy 这个基础镜像开始，然后通过一系列的sed命令来配置Nginx和PHP5-FPM。
RUN sed -e 's/;daemonize = yes/daemonize = no/' -i /etc/php5/fpm/php-fpm.conf
RUN sed -e 's/;listen\.owner/listen.owner/' -i /etc/php5/fpm/pool.d/
RUN sed -e 's/;listen\.group/listen.group/' -i /etc/php5/fpm/pool.d/
RUN echo "\ndaemon off;" /etc/nginx/nginx.conf
这里我们要做两件事。 首先配置PHP5-FPM和Nginx让他们在前台运行以便supervisord可以追踪到他们。
然后，配置PHP5-FPM以指定的用户运行Web-Server，并处理好文件权限。
接下来需要安装一组配置文件，首先是Nginx的虚拟主机配置文件vhost.conf:
server {
listen 80;
server_name _;
access_log /var/log/nginx/access.log;
error_log /var/log/nginx/error.log;
root /srv/web;
index app_dev.php;
location / {
try_files $uri $uri/ /app_dev.php?$query_string;
}
location ~ [^/]\.php(/|$) {
fastcgi_pass unix:/var/run/php5-fpm.sock;
include fastcgi_params;
}
}
因为我们不需要域名，所以把server_name设成了_（有点像perl的$_占位符变量）， 并配置根目录（document root）为/svr/web， 我们会把应用程序部署在/srv下，剩下的就是标准的Mginx + PHP5-FPM配置.
因为一个容器每次只能运行一个程序， 我们需要supervisord（或者任何别的进程管理器，不过我比较中意supervisord）。幸运的是， 这个进程管理器会产生我们需要的所有进程！下面是一小段supervisord的配置：
[supervisord]
nodaemon=true
[program:nginx]
command=/usr/sbin/nginx
[program:php5-fpm]
command=/usr/sbin/php5-fpm
[program:mysql]
command=/usr/bin/mysqld_safe
[program:init]
command=/init.sh
autorestart=false
redirect_stderr=true
redirect_stdout=/srv/app/logs/init.log
这里我们需要做的是定义所有的服务， 加上一个特殊的program:init进程，它不是一个实际的服务，而是一个独创的运行启动脚本的方式。
这个启动脚本的问题在于，它通常需要先启动某些服务。比如，你可能要初始化一些数据库表，但前提是你得先把MySQL跑起来，一个可能的解决办法是，在启动脚本中启动MySQL，然后初始化表，然后为了防止影响到supervisord的进程管理，需要停掉MySQL，最后再启动supervisord。
这样的脚本看起来类似下面这样：
/etc/init.d/mysql start
app/console doctrine:schema:update --force
/etc/init.d/mysql stop
exec /usr/bin/supervisord
看起来丑爆了有木有，咱换种方式，让supervisor来运行它并且永不重启。
实际的init.sh脚本如下：
#!/bin/bash
RET=1
while [[ RET -ne 0 ]]; do
sleep 1;
mysql -e 'exit' /dev/null 21; RET=$?
done
DB_NAME=${DB_NAME:-symfony}
mysqladmin -u root create $DB_NAME
if [ -n "$INIT" ]; then
/srv/$INIT
fi
脚本先等待MySQL启动，然后根据环境变量DB_NAME创建DB，默认为symfony， 然后在INIT环境变量中查找要运行的脚本，并尝试运行它。本文的结尾有说明如何使用这些环境变量。
构建并运行镜像
万事俱备只欠东风。我们还要构建Symfony Docker镜像， 使用docker build命令:
$ cd docker-symfony
$ docker build -t symfony .
现在，可以使用它来运行你的Symfony工程了:
$ cd SomeProject
$ docker run -i -t -P -v $PWD:/srv symfony
我们来看看这一连串的选项分别是干嘛的:
-i 启动交互（interactive）模式， 也就是说，STDIO（标准输入输出）连接到了你当前的终端上。当你要接收日志或者给进程发送信号时，它很有用。
-t 为容器创建一个虚拟TTY， 它跟-i是好基友，通常一起使用。
-P 告诉Docker守护进程发布所有指定的端口， 本例中为80端口。
-v $PWD:/srv 把当前目录挂载到容器的/srv目录。挂载一个目录使得目录内容对目标挂载点可用。
现在你还记得之前提到的DB_NAME和INIT环境变量了吧，干嘛用的呢：用于自定义你的环境。 基本上你可以通过 docker run的-e选项在容器中设置环境变量，启动脚本会拿到环境变量，因此，如果你的DB名为some_project_dev， 你就可以这么运行容器：
$ docker run -i -t -P -v $PWD:/srv -e DB_NAME=some_project_dev symfony
INIT 环境变量就更强大了，它允许你启动时运行指定的脚本。比如， 你有一个bin/setup脚本运行composer install命令并且设置数据库schema:
#!/bin/bash
composer install
app/console doctrine:schema:update --force
用-e来运行它：
$ docker run -i -t -P \
-v $PWD:/srv \
-e DB_NAME=some_project_dev \
-e INIT=bin/setup
注意，-e选项可以在docer run中多次使用，看起来相当酷。另外，你的启动脚本需要可执行权限（chmod +x）。
现在我们通过curl发送请求到容器，来检查一下是否所有的东西都像预期一样工作。首先，我们需要取到Docker映射到容器的80端口的公共端口，用docker port命令:
$ docker port $(docker ps -aql 1) 80
0.0.0.0:49153
docker ps -aql 1 是个好用的命令，可以方便的检索到最后一个容器的id， 在我们的例子中，Docker 把容器的80端口映射到了49153端口。我们 curl 一下看看。
$ curl
You are not allowed to access this file. Check app_dev.php for more information.
当我们不从localhost（译者注：容器的localhost）访问dev controller时，得到了Symfony的默认错误消息，这再正常不过了， 因为我们不是从容器内部发送 curl 请求的， 所以，可以安全的从前端控制器web/app_dev.php中移除这些行。
// This check prevents access to debug front controllers that are deployed by accident to production servers.
// Feel free to remove this， extend it， or make something more sophisticated.
if (isset($_SERVER['HTTP_CLIENT_IP'])
|| isset($_SERVER['HTTP_X_FORWARDED_FOR'])
|| !(in_array(@$_SERVER['REMOTE_ADDR']， array('127.0.0.1'， 'fe80::1'， '::1')) || php_sapi_name() === 'cli-server')
) {
header('HTTP/1.0 403 Forbidden');
exit('You are not allowed to access this file. Check '.basename(__FILE__).' for more information.');
}
这些行阻止了任何从localhost以外的地方访问dev controller。
现在再curl的时候就可以正常工作了，或者用浏览器访问 ：
很容易吧！ 现在我们可以快速的启动、更新环境了，但还是有很多地方需要改进。
在PhpStrom中配置Docker作为本地开发环境
平时大家在开发php项目的时候，本地都要装php程序和composer，做单元测试的时候还需要phpunit，如果需要单测覆盖率的话还要开启debug，本文将使用一个docker镜像搞定这些。
下面是一个php7.3+composer2.1+phpunit9.5的dockerfile，大家也可以根据自己的需要进行修改，然后自己构建为镜像
我把构建的镜像打个标签phpstorm:7.3-composer，方便下边使用
也可以拉取我已经构建好的镜像
本地要先启动docker desktop
2.1点击配置 》PHP 》CLI解释器
2.2 点击+ 》Form docker 》 docker 》选择第一步构建的镜像
2.3 添加成功后如下图，我们可以看到php版本号和xdebug的版本，然后点击应用，确定
2.4 这时已经配置成功了，phpstorm会自动生成路径映射，把项目根目录映射到容器中/opt/project
3.1 这步配置比较简单，看图就可以了
3.2 安装一个包测试一下
新建一个composer.json文件，点击 【工具】 》【composer】》【管理依赖项】》在composer.json文件里随便写一个包名，然后点击安装，如果执行成功，这步就完成了。如果失败，可以查看事件日志是否缺少某些php扩展，然后在dockerfile里安装扩展，重新构建镜像，再次点击composer安装，重新构建镜像不用再重新配置phpstorm。
添加命令行工具，选择composer
看到输出composer版本号，也就配置成功一半了。
我们执行下
配置就直接看图吧
写个单元测试一下，首先准备一个要测试的文件如下
然后点击 【使用覆盖率运行】，开始测试
怎么使用Docker搭建PHP开发环境
最方便的方式是下载一个php集成开发环境。然后安装即可。比如常用的php集成环境：xampp，phpstudy，wampserver等等。