你会用 Docker 搭建 PHP 开发环境吗?

docker搭建php环境，因为是本地的开发环境，所以想多尝尝鲜，尽量使用高版本的软件来实现。

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

先来说一下环境：

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 的安装，我这里是Mac版的。

这里大家直接在 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 访问来查看。

相关推荐

C# 13 和 .NET 9 全知道 :13 使用 ASP.NET Core 构建网站 (1)

因果推断Matching方式实现代码因果推断模型

git pull命令使用实例 git pull--rebase

面试官:git pull是哪两个指令的组合?

git 执行pull错误如何撤销 git pull fail

git fetch 和git pull 的异同 git中fetch和pull的区别

git pull 和git fetch 命令分别有什么作用?二者有什么区别?

git pull 之后本地代码被覆盖解决方案

还可以这样玩?Git基本原理及各种骚操作，涨知识了

git命令之pull git.pull