避坑！用Docker搞定PHP开发环境搭建（Mac、Docker、Nginx、PHP-FPM、XDebug、PHPStorm、VSCode）

文章版本：2019.7

因为最近换电脑的缘故需要重新部署一下本地的开发环境，之前采用的虚拟机方案，占用磁盘空间实在是太大，心疼SSD那么点地方，所以这次采用了Docker的方案来部署。

关于这次部署的原则，我的想法是尽量使用官方的镜像来实现，尽量不改动或少改动镜像。因为是本地的开发环境，所以想多尝尝鲜，尽量使用高版本的软件来实现。

从结果上来说，希望能给同样有需要搭建环境的同学起到一些帮助，少踩一些坑，如果能按照这篇文章的步骤一次搞定那是最好了。

先来说一下环境：

Docker 18.09.2

Nginx 1.17.1

PHP 7.3.7

XDebug 2.7.2

PhpStorm 2019.1.3

VSCode 1.36.1

1、Docker的安装

这里大家直接在Docker官网下载Docker for Mac就好了，直接按照提示操作即可，此处就不赘述了。

2、安装Nginx

地址：https://hub.docker.com/_/nginx

直接执行 docker pull nginx 拉取最新的镜像；

根据上面的地址我们可以看到官方提供的一些文档，我们按照操作即可，我个人采用的方案是先将nginx的整个配置目录copy到本地一份，然后在运行的时候将目录绑定到nginx容器的配置目录，这样修改配置更加方便一些。

将nginx配置目录copy到本地：

$ docker run --name tmp-nginx -d nginx

$ docker cp tmp-nginx:/etc/nginx /Users/yourname/Workspace/etc/nginx

$ docker rm -f tmp-nginx

说明：/Users/yourname/Workspace/etc，这个是我个人的工作目录，到时候根据情况换成自己的就行；命令的作用就是启一个后台运行的nginx容器，将配置目录copy出来之后终止运行并删除容器。

可以先运行一下看看效果：

$ docker run --name run-nginx -d -p 80:80 -v /Users/yourname/Workspace/www:/usr/share/nginx/html:ro nginx

说明：-v参数绑定本地的一个目录到nginx容器中的web目录，这里面没有绑定配置目录，大家可以在web目录下建立一个hello.html，通过浏览器访问http://localhost/hello.html看看效果，这之后可以大家可以先删除容器，后面我们改完配置再来启动它。

删除方法：

$ docker rm -f run-nginx

3、安装php-fpm

地址：https://hub.docker.com/_/php

因为这里我们需要安装一些开发时用到的PHP扩展，所以最好的办法是根据Dockerfile生成我们自己的镜像，如下是我的Dockerfile，大家可以参考，可以根据情况删减不需要的扩展，否则生成的镜像会比较大。

Dockerfile内容如下：

# 从官方基础版本构建

FROM php:7.3.7-fpm

# 官方版本默认安装扩展:

# Core, ctype, curl

# date, dom

# fileinfo, filter, ftp

# hash

# iconv

# json

# libxml

# mbstring, mysqlnd

# openssl

# pcre, PDO, pdo_sqlite, Phar, posix

# readline, Reflection, session, SimpleXML, sodium, SPL, sqlite3, standard

# tokenizer

# xml, xmlreader, xmlwriter

# zlib

# 更新为国内镜像

RUN mv /etc/apt/sources.list /etc/apt/sources.list.bak \

    && echo 'deb http://mirrors.163.com/debian/ stretch main non-free contrib' > /etc/apt/sources.list \

    && echo 'deb http://mirrors.163.com/debian/ stretch-updates main non-free contrib' >> /etc/apt/sources.list \

    && echo 'deb http://mirrors.163.com/debian-security/ stretch/updates main non-free contrib' >> /etc/apt/sources.list \

    && apt-get update

# bcmath, calendar, exif, gettext, sockets, dba,

# mysqli, pcntl, pdo_mysql, shmop, sysvmsg, sysvsem, sysvshm 扩展

RUN docker-php-ext-install -j$(nproc) bcmath calendar exif gettext sockets dba mysqli pcntl pdo_mysql shmop sysvmsg sysvsem sysvshm iconv

# GD 扩展

RUN apt-get install -y --no-install-recommends libfreetype6-dev libjpeg62-turbo-dev libpng-dev \

&& rm -r /var/lib/apt/lists/* \

    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \

    && docker-php-ext-install -j$(nproc) gd

# imagick 扩展

RUN export CFLAGS="$PHP_CFLAGS" CPPFLAGS="$PHP_CPPFLAGS" LDFLAGS="$PHP_LDFLAGS" \

    && apt-get install -y --no-install-recommends libmagickwand-dev \

&& rm -r /var/lib/apt/lists/* \

    && pecl install imagick-3.4.4 \

    && docker-php-ext-enable imagick

# mcrypt 扩展

RUN apt-get install -y --no-install-recommends libmcrypt-dev \

&& rm -r /var/lib/apt/lists/* \

    && pecl install mcrypt-1.0.2 \

    && docker-php-ext-enable mcrypt

# Memcached 扩展

RUN apt-get install -y --no-install-recommends libmemcached-dev zlib1g-dev \

&& rm -r /var/lib/apt/lists/* \

    && pecl install memcached-3.1.3 \

    && docker-php-ext-enable memcached

# redis 扩展

RUN pecl install redis-5.0.0 && docker-php-ext-enable redis

# opcache 扩展

RUN docker-php-ext-configure opcache --enable-opcache && docker-php-ext-install opcache

# xdebug 扩展

RUN pecl install xdebug-2.7.2 && docker-php-ext-enable xdebug

# swoole 扩展

RUN pecl install swoole-4.4.0 && docker-php-ext-enable swoole

# 镜像信息

LABEL Author="Stone"

LABEL Version="2019.7"

LABEL Description="PHP 7.3.7 开发环境镜像.

说明：这个Dockerfile我参考了//www.greatytc.com/p/20fcca06e27e作者的内容，并做了一些调整，大家可以根据自己情况增减，因为是开发环境所以最好把xdebug留着，咱们后面也会用到；

下面是将RUN串联起来的Dockerfile，这样生成的镜像能小一些，但是依然有636M，官方的php:7.3.7-fpm的镜像是371M，如果想优化也可以从官方提供的Alpine镜像生成，咱们这里就先简单粗暴了。

FROM php:7.3.7-fpm

RUN mv /etc/apt/sources.list /etc/apt/sources.list.bak \

    && echo 'deb http://mirrors.163.com/debian/ stretch main non-free contrib' > /etc/apt/sources.list \

    && echo 'deb http://mirrors.163.com/debian/ stretch-updates main non-free contrib' >> /etc/apt/sources.list \

    && echo 'deb http://mirrors.163.com/debian-security/ stretch/updates main non-free contrib' >> /etc/apt/sources.list \

    && apt-get update \

    && export CFLAGS="$PHP_CFLAGS" CPPFLAGS="$PHP_CPPFLAGS" LDFLAGS="$PHP_LDFLAGS" \

    && apt-get install -y --no-install-recommends libfreetype6-dev libjpeg62-turbo-dev libpng-dev libmagickwand-dev libmcrypt-dev libmemcached-dev zlib1g-dev \

    && rm -rf /var/lib/apt/lists/* \

    && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \

    && docker-php-ext-install -j$(nproc) bcmath calendar exif gettext sockets dba mysqli pcntl pdo_mysql shmop sysvmsg sysvsem sysvshm iconv gd \

    && pecl install imagick-3.4.4 mcrypt-1.0.2 memcached-3.1.3 redis-5.0.0 xdebug-2.7.2 swoole-4.4.0\

    && docker-php-ext-enable imagick mcrypt memcached redis xdebug swoole \

    && docker-php-ext-configure opcache --enable-opcache && docker-php-ext-install opcache

LABEL Author="Stone"

LABEL Version="2019.7"

LABEL Description="PHP 7.3.7 开发环境镜像. "

说一下踩的坑：apt-get的源最好换成国内的源，否则可能会在构建镜像的时候卡死；因为默认情况下官方容器是基于Debian的，查找源的时候很多都是过时的，如当前的Debian代号是stretch，却使用了jessie的包那肯定是会报错的，“E: Unable to correct problems, you have held broken packages.”；大家直接按照我上面的Dockerfile生成镜像即可，测试通过。

在Dockerfile所在目录下执行：

docker build -t my-php-fpm:2019.7 .

-t参数设置镜像名称和标签，请根据自己情况命名，镜像创建完成之后，可以像上面我们copy出nginx配置一样，将php的相关配置也copy到本地。

$ docker run --name tmp-my-php-fpm -d my-php-fpm:2019.7

$ docker cp tmp-my-php-fpm:/usr/local/etc /Users/yourname/Workspace/etc/php

$ docker rm -f tmp-my-php-fpm

4、修改nginx、php-fpm、xdebug的配置文件

修改nginx配置文件，打开/Users/yourname/Workspace/etc/nginx/default.conf，加入下面的内容：

location ~ \.php$ {

        fastcgi_pass  php-fpm-container:9000;

        fastcgi_index  index.php;

        fastcgi_param  SCRIPT_FILENAME  /var/www/html$fastcgi_script_name;

        fastcgi_param  SCRIPT_NAME      $fastcgi_script_name;

        include        fastcgi_params;

    }

增加的内容里面有一处需要说明，“php-fpm-container”这个是咱们自己创建的php-fpm容器的别名，具体是在运行时候指定的，之后咱们会提到。

修改php相关配置文件，进入/Users/yourname/Workspace/etc/php下，将php.ini-development复制改名为php.ini，配置内容根据自己情况修改即可。

修改xdebug的配置文件，/Users/yourname/Workspace/etc/php/conf.d/docker-php-ext-xdebug.ini，加入如下内容

xdebug.remote_enable = On

xdebug.remote_handler = dbgp

xdebug.remote_host = host.docker.internal

xdebug.remote_port = 9001

xdebug.remote_log = /var/log/php/xdebug.log

xdebug.idekey = PHPSTOR

以上设置主要是开启xdebug的远程调试模式，因为php-fpm使用了9000端口，所以这里我们把xdebug的端口改为了9001；“host.docker.internal”是docker 18.03新加入的，可以解析获得宿主机的ip地址，这样就不用写死ip地址了。

5、启动php-fpm、nginx容器

$ docker run --name run-my-php-fpm \

-v /Users/yourname/Workspace/www:/var/www/html \

-v /Users/yourname/Workspace/etc/php:/usr/local/etc \

-v /Users/yourname/Workspace/log/php:/var/log/php \

-d my-php-fpm:2019.7

$ docker run --name run-nginx \

-p 80:80 \

--link run-my-php-fpm:php-fpm-container \

-v /Users/yourname/Workspace/www:/usr/share/nginx/html \

-v /Users/yourname/Workspace/etc/nginx:/etc/nginx \

-v /Users/yourname/Workspace/log/nginx:/var/log/nginx \

-d nginx

说明：我将配置目录、日志目录和web目录都分别进行了绑定，方便在本地环境中修改。还记得上面提到的nginx中有个配置填写的“php-fpm-container”吗？实际上就是在这里指定的，连接两个容器，并给php-fpm容器起了个别名，配置中通过别名访问。

在/Users/yourname/Workspace/www中创建一个phpinfo.php文件，输出php信息，通过http://localhost/phpinfo.php访问来查看。

6、安装Chrome浏览器插件xdebug helper

可能会被墙，请自行解决。

7、PhpStorm调试环境配置

建立/Users/yourname/Workspace/www/xdebug/demo.php，php文件里面随便写点php代码，也可以通过PhpStorm新建立一个空项目，但是位置要在我们和php-fpm容器绑定的目录。

菜单：PhpStorm->Preferences… 进入偏好设置，按照下图进行设置。

根据上图提示进入CLI Interpreter设置窗口，点“+”添加配置。

继续配置Debug相关设置，如下图：

进入主界面，选择右上的“Add Configuration…”

进入debug配置窗口后选择“+”，选择“PHP Web Page“，设置名称后进入Servers设置，同时设置Start URL：“/xdebug/demo.php”

进入主窗口，在程序中打几个断点，然后点击那个绿色的甲虫就可以了。

8、VSCode调试环境配置

首先安装PHP Debug插件，然后打开上面创建的xdebug目录。如下图所示，进入调试面板，点齿轮选择PHP，然后会创建一个launch.json文件，修改这个文件加入pathMappings配置，这个配置参数用于设置服务器路径与本地路径的对应关系，低版本使用的是localSourceRoot和serverSourceRoot，目前已经被废除。另外记得将端口改为9001。

进入demo.php，随意设置两个断点，然后点左侧的运行按钮，进入调试模式，接下来刷新http://localhost/xdebug/demo.php会返回到VSCode的调试窗口，左侧已经列出调试信息，可选择单步执行跟踪程序的运行。

结尾：实际上这次部署环境踩了不少坑，主要原因是网上的资料都比较陈旧，很多文章也没有后续的更新，或者方向和我不太一致，例如hub中直接就有xdebug的镜像，但是我还是想尽量用官方提供的镜像自己创建，为了避免踩坑，大家最好还是多多参考官方文档，一般都写的比较清楚了。得益于docker的便利，我会不定期的更新这篇文章，这也是我在文章开头设置了一个版本号的原因，希望对大家有所帮助。

最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 206,602评论 6赞 481
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 88,442评论 2赞 382
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 152,878评论 0赞 344
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 55,306评论 1赞 279
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 64,330评论 5赞 373
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 49,071评论 1赞 285
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,382评论 3赞 400
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 37,006评论 0赞 259
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 43,512评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,965评论 2赞 325
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,094评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,732评论 4赞 323
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,283评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,286评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,512评论 1赞 262
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,536评论 2赞 354
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,828评论 2赞 345