资源猫
资源猫

避坑！用 Docker 搞定 PHP 开发环境搭建-php教程

资源魔 16 0
避坑！用 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

一、Docker 的装置

这里各人间接正在 Docker 官网下载 Docker for Mac 就行了，间接依照提醒操作便可，此处就没有赘述了。

二、装置 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

三、装置 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-reco妹妹ends 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-reco妹妹ends 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-reco妹妹ends 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-reco妹妹ends 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-reco妹妹ends 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

四、修正 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 地点了。

五、启动 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 拜访来查看。

1d25788e32888a8472ba146758c9fbd.png

六、装置 Chrome 阅读器插件 xdebug helper

可能会被墙，请自行处理。

七、PhpStorm 调试环境设置装备摆设

建设 / Users/yourname/Workspace/www/xdebug/demo.php，php 文件外面随意写点 php 代码，也能够经过 PhpStorm 新建设一个空名目，然而地位要正在咱们以及 php-fpm 容器绑定的目次。

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

331424dc551d95bf08a83d8f0e4e1b9.png

依据上图提醒进入 CLI Interpreter 设置窗口，点 “+” 增加设置装备摆设。

a5e0f086a3b9a10b6c51b7a75ac03bc.png

767d932873d1f256a5cad5fc5400563.png

持续设置装备摆设 Debug 相干设置，以下图：

4c6edc1a899da8ae4c08aeefc60c7ef.png

进入主界面，抉择右上的 “Add Configuration...”

6e63dd4c5cdb31183ed70cb38961f82.png

进入 debug 设置装备摆设窗口后抉择 “+”，抉择 “PHP Web Page“，设置称号落后入 Servers 设置，同时设置 Start URL：“/xdebug/demo.php”

229896e98b9d919e45cb66f4407e7eb.png

d486328f28e5288ddb4a810cfe97270.png

进入主窗口，正在顺序中打几个断点，而后点击阿谁绿色的甲虫就能够了。

e155ba48f85e4f1f9df373b1d490c53.png

八、VSCode 调试环境设置装备摆设

起首装置 PHP Debug 插件，而后关上下面创立的 xdebug 目次。以下图所示，进入调试面板，点齿轮抉择 PHP，而后会创立一个 launch.json 文件，修正这个文件退出 pathMappings 设置装备摆设，这个设置装备摆设参数用于设置效劳器门路与内陆门路的对应关系，低版本应用的是 localSourceRoot 以及 serverSourceRoot，今朝曾经被破除。另外记患上将端口改成 9001。

cda10ae26990acb600a6f8509e0b278.png

e477e4a4cff3d4ef13e9d38e7cda4a2.png

进入 demo.php，随便设置两个断点，而后点左侧的运转按钮，进入调试模式，接上去刷新 http://localhost/xdebug/demo.php 会前往到 VSCode 的调试窗口，左侧曾经列出调试信息，可抉择单步执行跟踪顺序的运转。

d1221a149abbd2b0db04f22808de5ab.png

41277a582833f84578104698be49d2f.png

末端：实际上此次部署环境踩了很多坑，次要缘由是网上的材料都比拟古老，不少文章也不后续的更新，或许标的目的以及我没有太分歧，例如 hub 中间接就有 xdebug 的镜像，然而我仍是想只管即便用民间提供的镜像本人创立，为了不踩坑，各人最佳仍是多多参考民间文档，普通都写的比拟分明了。

以上就是避坑！用 Docker 搞定 PHP 开发环境搭建的具体内容，更多请存眷资源魔其它相干文章！

标签： php开发教程 php开发资料 php开发自学 Docker

版权声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。

上一个PHP 数据加密的方法-php教程

下一个PHP之十六个魔术方法详解（总结）-php教程

相关文章

抱歉，评论功能暂时关闭!