memcached php mysql_Docker快速搭建一套PHP、Nginx、MySQL、Redis、Xdebug、Memcached 开发环境并演进...

痛点

如何简单迅速地初始化一个全新的PHP开发环境呢？

笔者在尝试起一个新web项目时，往往会陷入重新建立一套Docker环境的繁琐事当中。我想大家在开始做一个新项目时，或者快速为了和以前的项目做完全的隔离，也会起一套新docker环境。

从这篇文章你会得到

采用docker-compose容器编排技术，一步启动全部服务。php容器在官方的基础上还打包了一些常用拓展(附带build源码，动手能力强可以自己打包)，php，nginx，mysql都附带有自定义配置文件(便于开发测试的配置调整)，都供下载。

架构

本片文章搭建出来的环境如上图。

环境说明

运行环境

Mac OS 10.13.6

Virtual Box 5.2.14

Ubuntu 16.04.4

Docker 17.07.0-ce

容器

Nginx 1.12.1-alpine

PHP-fpm 5.6

MySQL 5.7

Redis 3.2

Memcached 1.4.27

这里说明一下笔者运行环境，采用了在Mac机上安装vbox虚拟机，在虚拟机里面的debian环境安装了Docker环境，文件放在Mac环境，通过文件挂载方式，达到Mac环境编辑，Docker环境实时更新效果。你要问为啥不在Mac下直接装Docker，历史原因～

运行材料

.

├── build ## docker 镜像build 材料

│   ├── php5.6 ## php 5.6

│   │   ├── Dockerfile

│   │   ├── imagick-3.4.3.tgz

│   │   ├── memcached-2.2.0.tgz

│   │   ├── redis-4.0.2.tgz

│   │   ├── sources.list

│   │   └── xdebug-XDEBUG_2_5_5.tar.gz

│   └── php-cli ## php cli 的自建镜像

│   ├── amqp-1.9.3.tgz

│   ├── Dockerfile

│   ├── Dockerfile-php-swoole

│   ├── memcached-3.0.4.tgz

│   ├── redis-4.1.1.tgz

│   ├── sources.list.jessie

│   ├── swoole-4.0.4.tgz

│   ├── swoole-4.2.6.tgz

│   ├── xdebug-2.6.1.tgz

│   └── yaf-3.0.7.tgz

├── config ## 配置文件

│ ├── apt ## 由于使用的debian系列，所以命名apt

│ │ └── sources.list ## 更新为国内源

│ ├── memcached ## memchached的配置

│ │ └── memcached.conf

│ ├── mysql ## mysql 的配置

│   │   ├── conf.d

│   │   │   └── mysqld_safe_syslog.cnf

│   │   └── my.cnf

│ ├── nginx ## nginx 的配置

│   │   ├── conf.d

│   │   │   ├── default

│   │   │   └── xiuno

│   │   ├── mime.types

│   │   ├── nginx.conf

│   │   └── sites-enabled

│ ├── php ## php的配置，分cli，和fpm配置

│   │   ├── cli

│   │   │   ├── conf.d

│   │   │   │   ├── 05-opcache.ini

│   │   │   │   ├── 10-pdo.ini

│   │   │   │   ├── 20-curl.ini

│   │   │   │   ├── 20-gd.ini

│   │   │   │   ├── 20-imagick.ini

│   │   │   │   ├── 20-json.ini

│   │   │   │   ├── 20-memcache.ini

│   │   │   │   ├── 20-mysqli.ini

│   │   │   │   ├── 20-mysql.ini

│   │   │   │   ├── 20-pdo_mysql.ini

│   │   │   │   ├── 20-readline.ini

│   │   │   │   ├── 20-redis.ini

│   │   │   │   ├── 20-xdebug.ini

│   │   │   │   └── swoole.ini

│   │   │   └── php.ini

│   │   ├── fpm

│   │   │   ├── conf.d

│   │   │   │   ├── docker.conf

│   │   │   │   ├── www.conf

│   │   │   │   └── zz-docker.conf

│   │   │   ├── docker-php-fpm.conf

│   │   │   ├── php-fpm.conf

│   │   │   ├── php.ini

│   │   │   └── pool.d

│   │   │   └── www.conf

│   │   └── mods-available

│   │   ├── curl.ini

│   │   ├── gd.ini

│   │   ├── imagick.ini

│   │   ├── json.ini

│   │   ├── memcache.ini

│   │   ├── mysqli.ini

│   │   ├── mysql.ini

│   │   ├── opcache.ini

│   │   ├── pdo.ini

│   │   ├── pdo_mysql.ini

│   │   ├── readline.ini

│   │   ├── redis.ini

│   │   └── xdebug.ini

│ └── redis ## redis 配置

│   ├── redis.conf

│   ├── redis-server.sh

│   └── sentinel.conf

├── data ## 为了数据持久化

│ ├── mysql ## mysql 文件挂载

│ └── redis ## redis 持久化数据文件夹

├── docker-compose.yaml ## 容器编排 ！！！

├── log ## 各个容器产生的日志

│ ├── mysql ## mysql日志

│ │ ├── error.log

│ │ └── mysql.log

│ ├── nginx ## nginx 日志

│   │   ├── access.log

│   │   ├── access_xiuno.log

│   │   ├── error.log

│   │   └── error_xiuno.log

│   └── php

├── php ## php代码存放目录

│ └── xiunobbs ## php项目

└── tool ## php 一些工具

├── composer.phar

└── phpunit-4.8.36.phar

配置文件下载

git clone https://gitee.com/xupaul/docker_fast_init

配置说明

目前笔者还没有写相关自动化脚本自动适配用户的使用环境，所以这里需要先调整一下下载后的配置文件。

docker-compose.yml 文件调整

这个文件有大量的文件挂载配置，这块就需要调整，拿一个举例。

version: "2"

services:

http:

image: nginx:1.12.1-alpine

volumes:

- ./config/nginx/nginx.conf:/etc/nginx/nginx.conf:rw

ports:

- "8080:80"

environment:

TZ : "Asia/Shanghai"

networks:

tasker_net:

ipv4_address: "192.63.0.11"

在例子中最后volumes的下一行，是将宿主机的nginx.conf配置文件挂载并覆盖容器内的nginx.conf文件，./文件路径就是clone git项目后的目录。

如果你也使用了vbox虚拟机，那么你需要./要替换为docker的运行环境的路径！

在ports这里，http服务为了不和本机的80端口冲突，以及sudo权限才能申请的小于1024的端口，这里我以8080作为默认值。其他容器的端口配置也遵循以上的规则，为的是能一个命令就能启动起来。

为每个容器都配置了时区。

网络ip这部分，为了便于配置就手动分配ip了。

Nginx 配置

配置好了php-fpm之间tcp通讯，以及php路由的rewrite。配置了静态资源缓存。

MySQL 配置

开启记录了一般性的查询日志，便于debug程序。注意这里挂载的配置文件读写权限要配置只读！

PHP 配置

php:

image: paulxu/php:5.6-fpm-jessis-pdo-xdebug-mysqli-gd-mb-zip-2

volumes:

- ./config/php/cli/php.ini:/usr/local/etc/php/php.ini/:rw

ports:

- "9000"

environment:

PHP_IDE_CONFIG: "serverName=bs"

XDEBUG_CONFIG: "remote_host=10.0.2.2 remote_port=9000"

我为php一起打包了一些常用拓展，其中xdebug需要调整一下remote_host的的ip(docker-compose.yaml, ~/config/php/cli/20-xdebug.ini 两个文件内的都需要调整). server_name 需要结合开发IDE一起调整，如PHPStorm里Preferences | Languages & Frameworks | PHP | Servers配置路径下有什么可用的记录，那么这里填什么。

Redis 配置

没有特殊配置

Memecached 配置

没有特殊配置

镜像构建

php镜像

可以通过如下命令拉取：

docker pull paulxu/php:5.6-fpm-jessis-pdo-xdebug-mysqli-gd-mb-zip-2

或者在到 ～/build/php5.6 下自行打包：

docker build -t paulxu/php:5.6-fpm-jessis-pdo-xdebug-mysqli-gd-mb-zip-2 -f dockerfile .

如果自定义tag name，需要一并调整docker-compose.yml

启动

从gitee下载配置

根据自己的环境调整配置

准备好镜像，镜像也可直接拉，我已上传了官方了。

启动

启动命令

## 当前线程运行，要停止时，键入`Ctrl+C`

docker-comose -f ./docker-compose.yaml up

## 后台运行

docker-comose -f ./docker-compose.yaml up -d

摧毁

docker-comose -f ./docker-compose.yaml down

常见问题

MySQL 挂载的配置文件被忽略，不起作用

MySQL 要求配置文件的权限为只能读，你需要已只读方式挂载

不知道remote_host怎么办

禁用xdebug，搭建好环境并启动，在IDE运行的环境(因为xdebug需要和IDE通讯)访问以http(在浏览器访问，注意端口映射)的方式访问php容器内代码，在Nginx的access.log里查看访问的ip就是remote_host.

docker build 时报错导致打包镜像失败

遇到这种情况，如果时一些不要紧的报错，可以选择忽略他们。可以在命令后面追加 exit 0 来屏蔽错误

最后

祝愿大家能一步到位，有问题留言，遇到疑难杂可以试试本地起虚拟机里跑docker容器的那种方案。