使用 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,通过浏览器访问 看看效果,这之后可以大家可以先删除容器,后面我们改完配置再来启动它。
删除方法:
地址: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 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 # 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 开发环境镜像.