Docker快速搭建一套PHPNginxMySQLRedisXdebugMemcached-开发环境并演进

42次阅读

共计 4487 个字符，预计需要花费 12 分钟才能阅读完成。

痛点

笔者在尝试起一个新 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 项目后的目录直接替换即可。

如果你也使用了虚拟机，那么你需要 ~/ 要替换为 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

启动

  1. 从 gitee 下载配置
  2. 根据自己的环境调整配置
  3. 准备好镜像
  4. 启动

启动命令

## 当前线程运行，要停止时，键入 `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 容器的那种方案。

正文完
docker mysql nginx php redis
发表至：无分类
2019-06-02
 0