制作一个定制PHP环境Docker镜像

目标：采用Dockerfile，定制一个 PHP 基础镜像。基础镜像，通常为含最小功能的系统镜像，之后的应用镜像都以此为基础。

制作基础镜像

选择 Ubuntu 官方的 14.04 版本为我们依赖的系统镜像。

1	FROM ubuntu:trusty

因所有官方镜像均位于境外服务器，为了确保所有示例能正常运行，DaoCloud 提供了一套境内镜像源，并与官方源保持同步。如果使用 DaoCloud 的镜像源，则指向：FROM daocloud.io/ubuntu:trusty

设置镜像的维护者，相当于镜像的作者或发行方。

1	MAINTAINER Misael Yau <misael@qq.com>

用 RUN 命令调用 apt-get 包管理器安装 PHP 环境所依赖的程序包。

安装依赖包相对比较固定，因此该动作应该尽量提前，这样做有助于提高镜像层的复用率。

RUN apt-get update \
    && apt-get -y install \
        curl \
        wget \
        apache2 \
        libapache2-mod-php5 \
        php5-mysql \
        php5-sqlite \
        php5-gd \
        php5-curl \
        php-pear \
        php-apc \

用 RUN 命令调用 Linux 命令对 Apache 服务和 PHP 参数进行配置。

1	RUN echo "ServerName localhost" >> /etc/apache2/apache2.conf \

用 RUN 命令调用 mkdir 来准备一个干净的放置代码的目录。

1	RUN mkdir -p /app && rm -rf /var/www/html && ln -s /app /var/www/html

将本地的代码添加到目录，并指定其为当前的工作目录。

1 2	COPY . /app WORKDIR /app

设置启动脚本的权限，指定暴露的容器内端口地址。

最后指定容器启动的进程。

1
2
3

RUN chmod 755 ./start.sh
EXPOSE 80
CMD ["./start.sh"]

start.sh

#!/bin/bash

source /etc/apache2/envvars
tail -F /var/log/apache2/* &
exec apache2 -D FOREGROUND

至此一个 PHP 的基础镜像制作完毕，你可以在本地运行 docker build -t my-php-base . 来构建出这个镜像并命名为 my-php-base。

由于网络环境的特殊情况，在本地运行 docker build 的时间会很长，并且有可能失败。推荐使用 DaoCloud 加速器 和 DaoCloud 的云端 代码构建 功能。

完整 Dockerfile

# Ubuntu 14.04，Trusty Tahr（可靠的塔尔羊）发行版
FROM ubuntu:trusty

# 道客船长荣誉出品
MAINTAINER Captain Dao <support@daocloud.io>

# APT 自动安装 PHP 相关的依赖包，如需其他依赖包在此添加
RUN apt-get update \
    && apt-get -y install \
        curl \
        wget \
        apache2 \
        libapache2-mod-php5 \
        php5-mysql \
        php5-sqlite \
        php5-gd \
        php5-curl \
        php-pear \
        php-apc \

    # 用完包管理器后安排打扫卫生可以显著的减少镜像大小
    && apt-get clean \
    && apt-get autoclean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* \

    # 安装 Composer，此物是 PHP 用来管理依赖关系的工具
    # Laravel Symfony 等时髦的框架会依赖它
    && curl -sS https://getcomposer.org/installer \
        | php -- --install-dir=/usr/local/bin --filename=composer

# Apache 2 配置文件：/etc/apache2/apache2.conf
# 给 Apache 2 设置一个默认服务名，避免启动时给个提示让人紧张.
RUN echo "ServerName localhost" >> /etc/apache2/apache2.conf \

    # PHP 配置文件：/etc/php5/apache2/php.ini
    # 调整 PHP 处理 Request 里变量提交值的顺序，解析顺序从左到右，后解析新值覆盖旧值
    # 默认设定为 EGPCS（ENV/GET/POST/COOKIE/SERVER）
    && sed -i 's/variables_order.*/variables_order = "EGPCS"/g' \
        /etc/php5/apache2/php.ini

# 配置默认放置 App 的目录
RUN mkdir -p /app && rm -rf /var/www/html && ln -s /app /var/www/html
COPY . /app
WORKDIR /app
RUN chmod 755 ./start.sh

EXPOSE 80
CMD ["./start.sh"]

开发一个PHP的Docker化应用

目标：基于 PHP 的 Docker 基础镜像，开发一个 Docker 化的示例 PHP 应用。

基于官方镜像

本次基础镜像使用 PHP 官方镜像，也可以根据自己的项目需求与环境依赖使用定制的 PHP 基础镜像。

因所有官方镜像均位于境外服务器，为了确保所有示例能正常运行，DaoCloud 提供了一套境内镜像源，并与官方源保持同步。

官方镜像维护了自 5.4 版本起的所有 PHP 基础镜像，所有镜像均采用 debian:jessie 作为系统镜像。

首先，选择官方的 php:5.6-cli 镜像作为项目的基础镜像。

1	FROM daocloud.io/php:5.6-cli

由于该示例代码较为简单，我们采用仅安装 PHP CLI 的 Docker 镜像来运行。

接着，将代码复制到目标目录。

1
2
3

COPY . /app
WORKDIR /app
CMD [ "php", "./hello.php" ]

ADD 与 COPY 的区别，总体来说 ADD 和 COPY 都是添加文件的操作，其中 ADD 比 COPY 功能更多，ADD 允许后面的参数为 URL，还有 ADD 添加的文件为压缩包的话，它将自动解压。

CMD 为本次构建出来的镜像运行起来时候默认执行的命令，我们可以通过 docker run 的启动命令修改默认运行命令。

Dockerfile 具体语法请参考：Dockerfile。

有了 Dockerfile 以后，我们可以运行下面的命令构建 PHP 应用镜像并命名为 my-php-app：

docker build -t my-php-app .

最后，让我们从镜像启动容器：

docker run my-php-app

1	Welcome the world of Docker !

如果看到这段字符串，那么就说明你成功进入到了一个 Docker 化的世界。

欢迎来到 Docker 的世界，这个世界有你意想不到的精彩！

FROM daocloud.io/php:5.6-cli

COPY . /app
WORKDIR /app
CMD [ "php", "./hello.php" ]

开发一个PHP+MySQL Docker化应用

目标：基于典型的 LAMP 技术栈，用 Docker 镜像的方式搭建一个 Linux + Apache + MySQL + PHP 的应用。

本项目代码维护在 DaoCloud/php-apache-mysql-sample 项目中。

创建 PHP 应用容器

因所有官方镜像均位于境外服务器，为了确保所有示例能正常运行，DaoCloud 提供了一套境内镜像源，并与官方源保持同步。

首先，选择官方的 PHP 镜像作为项目的基础镜像。

1	FROM daocloud.io/php:5.6-apache

接着，用官方 PHP 镜像内置命令docker-php-ext-install安装 PHP 的 MySQL 扩展依赖。

1	RUN docker-php-ext-install pdo_mysql

依赖包通过 docker-php-ext-install 安装，如果依赖包需要配置参数则通过 docker-php-ext-configure 命令。
安装 pdo_mysql PHP 扩展。

然后，将代码复制到目标目录。

1	COPY . /var/www/html/

因为基础镜像内已经声明了暴露端口和启动命令，此处可以省略。

至此，包含 PHP 应用的 Docker 容器已经准备好了。PHP 代码中访问数据库所需的参数，是通过读取环境变量的方式声明的。

$serverName =   env("MYSQL_PORT_3306_TCP_ADDR", "localhost");
$databaseName = env("MYSQL_INSTANCE_NAME", "homestead");
$username =     env("MYSQL_USERNAME", "homestead");
$password =     env("MYSQL_PASSWORD", "secret");

/**
 * 获取环境变量
 * @param $key
 * @param null $default
 * @return null|string
 */
function env($key, $default = null)
{
    $value = getenv($key);
    if ($value === false) {
        return $default;
    }
    return $value;
}

这样做是因为在 Docker 化应用开发的最佳实践中，通常将有状态的数据类服务放在另一个容器内运行，并通过容器特有的 link 机制将应用容器与数据容器动态的连接在一起。

绑定 MySQL 数据容器（本地）

首先，需要创建一个 MySQL 容器。

1	docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:5.5

之后，通过 Docker 容器间的 link 机制，便可将 MySQL 的默认端口（3306）暴露给应用容器。

1	docker run --name some-app --link some-mysql:mysql -d app-that-uses-mysql

绑定 MySQL 数据服务（云端）

比起本地创建，在云端创建和绑定 MySQL 数据服务会更简单。

在 GitHub 上 Fork DaoCloud/php-apache-mysql-sample 或者添加自己的代码仓库。
注册成为 DaoCloud 用户。
在 DaoCloud 「控制台」中选择「代码构建」。
创建新项目，选择代码源，开始构建镜像。
在「服务集成」创建 MySQL 服务实例。
将构建的应用镜像关联 MySQL 服务实例并部署在云端。

DaoCloud 使用图文介绍

了解如何用 DaoCloud 进行代码构建：参考代码构建。
了解如何用 DaoCloud 进行持续集成：参考持续集成。
了解如何用为应用准备一个数据库服务：参考服务集成。
了解如何部署一个刚刚构建好的应用镜像：参考应用部署。

DaoCloud 使用视频介绍

应用截图

Dockerfile


# 使用官方 PHP-Apache 镜像

FROM daocloud.io/php:5.6-apache

# docker-php-ext-install 为官方 PHP 镜像内置命令，用于安装 PHP 扩展依赖
# pdo_mysql 为 PHP 连接 MySQL 扩展
RUN docker-php-ext-install pdo_mysql

# /var/www/html/ 为 Apache 目录
COPY . /var/www/html/

配置Docker化持续集成的PHP环境

目标：我们将为之前创建的 PHP+MySQL 应用，编写测试代码和创建持续集成环境。

利用 PHPUnit 编写单元测试（本地）

使用以下命令安装 PHPUnit 4.0：

1	composer global require "phpunit/phpunit=~4.0"

假设我们的工程包含两个文件，一个源代码文件 Cal.php 和一个测试代码文件 CalTest.php。

<?php
// Cal.php

class Calculator{
    function add($p1,$p2)
    {
        return $p1+$p2;
    }
}

<?php
// CalTest.php

require_once("Cal.php");
class CalTest extends PHPUnit_Framework_TestCase
{
    public $cal;
    function setUp()
    {
        $this->cal = new Calculator();
    }
    function tearDown() {
        unset($this->cal);
    }
    function testadd1()
    {
        $result = $this->cal->add(1,1);
        $this->assertEquals($result,2);
    }
    function testadd2()
    {
        $result = $this->cal->add(100,-50);
        $this->assertTrue($result == 50);
    }
}

使用以下命令来启动测试：

1	phpunit CalTest

利用 DaoCloud 配置持续集成环境（云端）

当我们写完测试代码之后，我们需要一个持续集成环境来自动执行测试，报告项目的健康状况。这里我们使用 DaoCloud 云端的持续集成能力来为我们的 PHP + MySQL 应用配置持续集成环境。

我们只需要在源代码的根目录放置 daocloud.yml 文件便可以接入 DaoCloud 持续集成系统，每一次源代码的变更都会触发一次 DaoCloud 持续集成。关于 daocloud.yml 的格式，请参考这里。

以下是我们为 PHP + MySQL 应用编写的测试代码和 daocloud.yml。

<?php
// DBTest.php

require_once("DB.php");
class DBTest extends PHPUnit_Framework_TestCase
{
    public $db;
    function setUp()
    {
        $this->db = new DB();
    }
    function tearDown() {
        unset($this->db);
    }
    function exist($name, $phone) {
        $contacts = $this->db->all();
        foreach ($contacts as $index => $contact) {
            if ($contact['name'] == $name && $contact['phone'] == $phone) {
                return true;
            }
        }
        return false;
    }
    function total() {
        return count($this->db->all());
    }
    function test001()
    {
        $this->db->add("abc", "123");
        $this->assertTrue($this->exist("abc", "123"));
    }
    function test002()
    {
        $pre = $this->total();
        $this->db->add("bcd", "1234");
        $post = $this->total();
        $this->assertTrue($post - $pre == 1);
    }
}


# daocloud.yml

image: daocloud.io/ci-php:5.5

services:
  - mysql

env:
  - MYSQL_USERNAME = "root"
  - MYSQL_PASSWORD = ""
  - MYSQL_INSTANCE_NAME = "test"

install:
  - docker-php-ext-install pdo_mysql

script:
  - phpunit DBTest

开发一个 PHP + NewRelic 的生产级 Docker 化应用

目标：我们将为之前创建的 PHP + MySQL 应用，配置由 NewRelic 提供的应用监控探针。

创建 PHP 应用容器

因所有官方镜像均位于境外服务器，为了确保所有示例能正常运行，DaoCloud 提供了一套境内镜像源，并与官方源保持同步。

首先，选择官方的 PHP 镜像作为项目的基础镜像。

1	FROM daocloud.io/php:5.6-apache

接着，按照 NewRelic 官方 PHP 安装教程，进行脚本的编写。

## 安装 NewRelic
RUN mkdir -p /etc/apt/sources.list.d \
    && echo 'deb http://apt.newrelic.com/debian/ newrelic non-free' \
        >> /etc/apt/sources.list.d/newrelic.list \

    # 添加 NewRelic APT 下载时用来验证的 GPG 公钥
    && curl -s https://download.newrelic.com/548C16BF.gpg \
        | apt-key add - \

    # 安装 NewRelic PHP 代理
    && apt-get update \
    && apt-get install -y newrelic-php5 \
    && newrelic-install install \

    # 用完包管理器后安排打扫卫生可以显著的减少镜像大小
    && apt-get clean \
    && apt-get autoclean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*

apt-get update 下载从仓库的软件包列表并获取软件包版本信息。
apt-get install -y newrelic-php5 安装 NewRelic PHP5 扩展。
Docker 镜像采用分层数据存储格式，镜像的大小等于所有层次大小的总和，所以我们应该尽量精简每次构建所产生镜像的大小。

然后，修改 NewRelic 配置文件。

# 覆盖 NewRelic 配置文件
RUN sed -i 's/"REPLACE_WITH_REAL_KEY"/\${NEW_RELIC_LICENSE_KEY}/g' \
    /usr/local/etc/php/conf.d/newrelic.ini
RUN sed -i 's/"PHP Application"/\${NEW_RELIC_APP_NAME}/g' \
    /usr/local/etc/php/conf.d/newrelic.ini

主要将 newrelic.appname 和 newrelic.license 按照 DaoCloud 最佳实践通过环境变量的方式暴露出来。

至此，我们 NewRelic 的配置全部完成了,将代码复制到指定目录，并执行构建镜像命令完成我们镜像构建的最后一步

1 2	# /var/www/html/ 为 Apache 目录 COPY src/ /var/www/html/

docker build -t php-newrelic-image .

启动 php-newrelic 容器（本地）

最后，我们将构建好的镜像运行起来

docker run \
    --name php-newrelic \
    -e NEW_RELIC_LICENSE_KEY=my-newrelic-license \
    -e NEW_RELIC_APP_NAME=my-app-name \
    -d \
    php-newrelic-image

使用 --name 参数，指定容器的名称。
使用 -e 参数，容器启动时会将环境变量注入到容器中。
使用 -d 参数，容器在启动时会进入后台运行。
php-newrelic-image 是由我们上面的 Dockerfile 构建出来的镜像。

启动 php-newrelic 容器（云端）

比起本地创建，在云端创建会更简单。

在 GitHub 上 Fork DaoCloud/php-newrelic-sample 或者添加自己的代码仓库。
注册成为 DaoCloud 用户。
在 DaoCloud 「控制台」中选择「代码构建」。
创建新项目，选择代码源，开始构建镜像。
将构建的应用镜像部署在云端并指定 NEW_RELIC_APP_NAME 和 NEW_RELIC_LICENSE_KEY 环境变量。

DaoCloud 使用图文介绍

了解如何用 DaoCloud 进行代码构建：参考代码构建。
了解如何用 DaoCloud 进行持续集成：参考持续集成。
了解如何部署一个刚刚构建好的应用镜像：参考应用部署。

NewRelic Dashboard 截图

开发一个 Laravel + MySQL 框架的 Docker 化应用

目标：基于主流的 PHP 框架，用 Docker 镜像的方式搭建一个 Laravel + MySQL 的应用。

创建 Laravel 应用容器

因所有官方镜像均位于境外服务器，为了确保所有示例能正常运行，DaoCloud 提供了一套境内镜像源，并与官方源保持同步。

首先，选择官方的 PHP 镜像作为项目的基础镜像。

1	FROM daocloud.io/php:5.6-apache

其次，通过安装脚本安装 Laravel 应用所需要的 PHP 依赖。

# 安装 PHP 相关的依赖包，如需其他依赖包在此添加
RUN apt-get update \
    && apt-get install -y \
        libmcrypt-dev \
        libz-dev \
        wget \

    # 官方 PHP 镜像内置命令，安装 PHP 依赖
    && docker-php-ext-install \
        mcrypt \
        mbstring \
        pdo_mysql \
        zip \


    # 用完包管理器后安排打扫卫生可以显著的减少镜像大小
    && apt-get clean \
    && apt-get autoclean \
    && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* \

    # 安装 Composer，此物是 PHP 用来管理依赖关系的工具
    && curl -sS https://getcomposer.org/installer \
        | php -- --install-dir=/usr/local/bin --filename=composer

依赖包通过 docker-php-ext-install 安装，如果依赖包需要配置参数则通过 docker-php-ext-configure 命令。
Docker 镜像采用分层数据存储格式，镜像的大小等于所有层次大小的总和，所以我们应该尽量精简每次构建所产生镜像的大小。
Composer 为 Laravel 下载第三方 Vendor 包所必需的插件，Composer 同时也是 PHP 最流行的包管理工具。

接着，创建 Laravel 目录结构：

# 开启 URL 重写模块
# 配置默认放置 App 的目录
RUN a2enmod rewrite \
    && mkdir -p /app \
    && rm -fr /var/www/html \
    && ln -s /app/public /var/www/html

WORKDIR /app

Laravel 是通过统一的项目的入口文件进入应用系统的。进而需要 Apache 开启链接重写模块。
Apache 默认的文档目录为 /var/www/html，将 /app 定义为 Laravel 应用目录，而 Laravel 的项目入口文件位于 /app/public。为了方便管理，把 /var/www/html 软链接到 /app/public。

紧接着，根据 DaoCloud 的最佳实践，我们需要把第三方依赖预先加载好。

# 预先加载 Composer 包依赖，优化 Docker 构建镜像的速度
COPY ./composer.json /app/
COPY ./composer.lock /app/
RUN composer install  --no-autoloader --no-scripts

复制 composer.json 和 composer.lock 到 /app, composer.lock 会锁定 Composer 加载的依赖包版本号，防止由于第三方依赖包的版本不同导致的应用运行错误。
--no-autoloader 为了阻止 composer install 之后进行的自动加载，防止由于代码不全导致的自动加载报错。
--no-scripts 为了阻止 composer install 运行时 composer.json 所定义的脚本，同样是防止代码不全导致的加载错误问题。

然后，将 Laravel 应用程序复制到 /app：

# 复制代码到 App 目录
COPY . /app

# 执行 Composer 自动加载和相关脚本
# 修改目录权限
RUN composer install \
    && chown -R www-data:www-data /app \
    && chmod -R 0777 /app/storage

composer install 执行之前阻止的操作，完成自动加载及脚本运行
修改 /app 与 /app/storage 的权限，保证 Laravel 在运行中有足够的权限
因为基础镜像内已经声明了暴露端口和启动命令，此处可以省略。

至此，包含 Laravel 应用的 Docker 容器已经准备好了。Laravel 代码中访问数据库所需的参数，是通过读取环境变量的方式声明的。

config/database.php 修改变量为更贴近 Docker 的方式：

'host'      => env('MYSQL_PORT_3306_TCP_ADDR', 'localhost'),
'database'  => env('MYSQL_INSTANCE_NAME', 'forge'),
'username'  => env('MYSQL_USERNAME', 'forge'),
'password'  => env('MYSQL_PASSWORD', ''),

绑定 MySQL 数据容器（本地）

首先，需要创建一个 MySQL 容器。

1	docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:5.5

之后，通过 Docker 容器间的 link 机制，便可将 MySQL 的默认端口 (3306) 暴露给应用容器。

1	docker run --name some-app --link some-mysql:mysql -d app-that-uses-mysql

绑定 MySQL 数据服务（云端）

比起本地创建，在云端创建和绑定 MySQL 数据服务会更简单。

在 GitHub 上 Fork DaoCloud/php-laravel-mysql-sample 或者添加自己的代码仓库。
注册成为 DaoCloud 用户。
在 DaoCloud 「控制台」中选择「代码构建」。
创建新项目，选择代码源，开始构建镜像。
在「服务集成」创建 MySQL 服务实例。
将构建的应用镜像关联 MySQL 服务实例并部署在云端。

DaoCloud 使用图文介绍

了解如何用 DaoCloud 进行代码构建：参考代码构建。
了解如何用 DaoCloud 进行持续集成：参考持续集成。
了解如何用为应用准备一个数据库服务：参考服务集成。
了解如何部署一个刚刚构建好的应用镜像：参考应用部署。

DaoCloud 使用视频介绍

php-laravel-mysql-sample 应用截图

参考 DaoCloud

M

PHP应用Docker开发

制作一个定制PHP环境Docker镜像

制作基础镜像

完整 Dockerfile

开发一个PHP的Docker化应用

基于官方镜像

开发一个PHP+MySQL Docker化应用

创建 PHP 应用容器

绑定 MySQL 数据容器（本地）

绑定 MySQL 数据服务（云端）

应用截图

Dockerfile

配置Docker化持续集成的PHP环境

利用 PHPUnit 编写单元测试（本地）

利用 DaoCloud 配置持续集成环境（云端）

开发一个 PHP + NewRelic 的生产级 Docker 化应用

创建 PHP 应用容器

启动 php-newrelic 容器（本地）

启动 php-newrelic 容器（云端）

NewRelic Dashboard 截图

开发一个 Laravel + MySQL 框架的 Docker 化应用

创建 Laravel 应用容器

绑定 MySQL 数据容器（本地）

绑定 MySQL 数据服务（云端）

php-laravel-mysql-sample 应用截图