避坑！用 Docker 搞定 PHP 开发环境搭建

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

由于比来换电脑的原因需要从新摆设一下当地的开发环境，此前采纳的虚拟机方案，占用磁盘空间实在是太大，心疼 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 我参照 了 https://www.jianshu.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 搞定 PHP 开发环境搭建的具体内容，更多请关注百分百源码网其它相关文章！