使用 Docker 搭建 PHP 开发环境(2)

说明：这个 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 stretch main non-free contrib' > /etc/apt/sources.list \ && echo 'deb stretch-updates main non-free contrib' >> /etc/apt/sources.list \ && echo 'deb 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 信息，通过 访问来查看。

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

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

7、PhpStorm 调试环境配置