避坑竖席！用 Docker 搞定 PHP 開發(fā)環(huán)境搭建（Mac、Docker敬肚、Nginx毕荐、PHP-FPM、XDebug艳馒、PHPStorm憎亚、VSCode）

因?yàn)樽罱鼡Q電腦的緣故需要重新部署一下本地的開發(fā)環(huán)境，之前采用的虛擬機(jī)方案弄慰，占用磁盤空間實(shí)在是太大第美，心疼 SSD 那么點(diǎn)地方，所以這次采用了 Docker 的方案來部署陆爽。

關(guān)于這次部署的原則什往，我的想法是盡量使用官方的鏡像來實(shí)現(xiàn)，盡量不改動(dòng)或少改動(dòng)鏡像慌闭。因?yàn)槭潜镜氐拈_發(fā)環(huán)境别威，所以想多嘗嘗鮮躯舔，盡量使用高版本的軟件來實(shí)現(xiàn)。

從結(jié)果上來說省古，希望能給同樣有需要搭建環(huán)境的同學(xué)起到一些幫助粥庄，少踩一些坑，如果能按照這篇文章的步驟一次搞定那是最好了豺妓。

先來說一下環(huán)境：

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 官網(wǎng)下載 Docker for Mac 就好了，直接按照提示操作即可科侈，此處就不贅述了载佳。

2、安裝 Nginx

地址：https://hub.docker.com/_/nginx

直接執(zhí)行 docker pull nginx 拉取最新的鏡像臀栈；

根據(jù)上面的地址我們可以看到官方提供的一些文檔蔫慧，我們按照操作即可，我個(gè)人采用的方案是先將 nginx 的整個(gè)配置目錄 copy 到本地一份权薯，然后在運(yùn)行的時(shí)候?qū)⒛夸浗壎ǖ?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盟蚣，這個(gè)是我個(gè)人的工作目錄黍析，到時(shí)候根據(jù)情況換成自己的就行；命令的作用就是啟一個(gè)后臺運(yùn)行的 nginx 容器屎开，將配置目錄 copy 出來之后終止運(yùn)行并刪除容器阐枣。

可以先運(yùn)行一下看看效果：

$ docker run --name run-nginx -d -p 80:80 -v /Users/yourname/Workspace/www:/usr/share/nginx/html:ro nginx

說明：-v 參數(shù)綁定本地的一個(gè)目錄到 nginx 容器中的 web 目錄，這里面沒有綁定配置目錄奄抽，大家可以在 web 目錄下建立一個(gè) hello.html蔼两，通過瀏覽器訪問 http://localhost/hello.html 看看效果，這之后可以大家可以先刪除容器逞度，后面我們改完配置再來啟動(dòng)它额划。

刪除方法：

$ docker rm -f run-nginx

3、安裝 php-fpm

地址：https://hub.docker.com/_/php

因?yàn)檫@里我們需要安裝一些開發(fā)時(shí)用到的 PHP 擴(kuò)展档泽，所以最好的辦法是根據(jù) Dockerfile 生成我們自己的鏡像俊戳，如下是我的 Dockerfile，大家可以參考馆匿，可以根據(jù)情況刪減不需要的擴(kuò)展抑胎，否則生成的鏡像會(huì)比較大。

Dockerfile 內(nèi)容如下：

# 從官方基礎(chǔ)版本構(gòu)建

FROM php:7.3.7-fpm

# 官方版本默認(rèn)安裝擴(kuò)展:

# 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

# 更新為國內(nèi)鏡像

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 擴(kuò)展

RUN docker-php-ext-install -j$(nproc) bcmath calendar exif gettextsockets dba mysqli pcntl pdo_mysql shmop sysvmsg sysvsem sysvshm iconv

# GD 擴(kuò)展

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 擴(kuò)展

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 擴(kuò)展

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 擴(kuò)展

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 擴(kuò)展

RUN pecl install redis-5.0.0 && docker-php-ext-enable redis

# opcache 擴(kuò)展

RUN docker-php-ext-configure opcache --enable-opcache && docker-php-ext-install opcache

# xdebug 擴(kuò)展

RUN pecl install xdebug-2.7.2 && docker-php-ext-enable xdebug

# swoole 擴(kuò)展

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 開發(fā)環(huán)境鏡像.

說明：這個(gè) Dockerfile 我參考了 http://www.reibang.com/p/20fcca06e27e 作者的內(nèi)容甜熔，并做了一些調(diào)整圆恤，大家可以根據(jù)自己情況增減，因?yàn)槭情_發(fā)環(huán)境所以最好把 xdebug 留著，咱們后面也會(huì)用到盆昙；

下面是將 RUN 串聯(lián)起來的 Dockerfile羽历，這樣生成的鏡像能小一些，但是依然有 636M淡喜，官方的 php:7.3.7-fpm 的鏡像是 371M秕磷，如果想優(yōu)化也可以從官方提供的 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 gettextsockets 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 開發(fā)環(huán)境鏡像. "

說一下踩的坑：apt-get 的源最好換成國內(nèi)的源澎嚣，否則可能會(huì)在構(gòu)建鏡像的時(shí)候卡死；因?yàn)槟J(rèn)情況下官方容器是基于 Debian 的瘟芝，查找源的時(shí)候很多都是過時(shí)的易桃，如當(dāng)前的 Debian 代號是 stretch，卻使用了 jessie 的包那肯定是會(huì)報(bào)錯(cuò)的锌俱，“E: Unable to correct problems, you have held broken packages.”晤郑；大家直接按照我上面的 Dockerfile 生成鏡像即可，測試通過贸宏。

在 Dockerfile 所在目錄下執(zhí)行：

docker build -t my-php-fpm:2019.7 .

-t 參數(shù)設(shè)置鏡像名稱和標(biāo)簽造寝，請根據(jù)自己情況命名，鏡像創(chuàng)建完成之后吭练，可以像上面我們 copy 出 nginx 配置一樣诫龙，將 php 的相關(guān)配置也 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姊舵，加入下面的內(nèi)容：

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;

????????includefastcgi_params;

????}

增加的內(nèi)容里面有一處需要說明晰绎，“php-fpm-container” 這個(gè)是咱們自己創(chuàng)建的 php-fpm 容器的別名寓落，具體是在運(yùn)行時(shí)候指定的，之后咱們會(huì)提到荞下。

修改 php 相關(guān)配置文件伶选，進(jìn)入 / Users/yourname/Workspace/etc/php 下，將 php.ini-development 復(fù)制改名為 php.ini尖昏，配置內(nèi)容根據(jù)自己情況修改即可仰税。

修改 xdebug 的配置文件，/Users/yourname/Workspace/etc/php/conf.d/docker-php-ext-xdebug.ini抽诉，加入如下內(nèi)容：

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

以上設(shè)置主要是開啟 xdebug 的遠(yuǎn)程調(diào)試模式陨簇，因?yàn)?php-fpm 使用了 9000 端口，所以這里我們把 xdebug 的端口改為了9001迹淌；“host.docker.internal” 是 docker 18.03 新加入的河绽，可以解析獲得宿主機(jī)的 ip 地址己单，這樣就不用寫死 ip 地址了。

5耙饰、啟動(dòng) 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 目錄都分別進(jìn)行了綁定苟跪，方便在本地環(huán)境中修改廷痘。還記得上面提到的 nginx 中有個(gè)配置填寫的 “php-fpm-container” 嗎？實(shí)際上就是在這里指定的件已，連接兩個(gè)容器笋额，并給 php-fpm 容器起了個(gè)別名，配置中通過別名訪問篷扩。

在 / Users/yourname/Workspace/www 中創(chuàng)建一個(gè) phpinfo.php 文件鳞陨，輸出 php 信息，通過 http://localhost/phpinfo.php 訪問來查看瞻惋。

6厦滤、安裝 Chrome 瀏覽器插件 xdebug helper

可能會(huì)被墻，請自行解決歼狼。

7掏导、PhpStorm 調(diào)試環(huán)境配置

建立 / Users/yourname/Workspace/www/xdebug/demo.php，php 文件里面隨便寫點(diǎn) php 代碼羽峰，也可以通過 PhpStorm 新建立一個(gè)空項(xiàng)目趟咆，但是位置要在我們和 php-fpm 容器綁定的目錄。

菜單：PhpStorm->Preferences… 進(jìn)入偏好設(shè)置梅屉，按照下圖進(jìn)行設(shè)置值纱。

根據(jù)上圖提示進(jìn)入 CLI Interpreter 設(shè)置窗口，點(diǎn) “+” 添加配置坯汤。

繼續(xù)配置 Debug 相關(guān)設(shè)置虐唠，如下圖：

進(jìn)入主界面，選擇右上的 “Add Configuration...”

進(jìn)入 debug 配置窗口后選擇 “+”惰聂，選擇 “PHP Web Page“疆偿，設(shè)置名稱后進(jìn)入 Servers 設(shè)置，同時(shí)設(shè)置 Start URL：“/xdebug/demo.php”

進(jìn)入主窗口搓幌，在程序中打幾個(gè)斷點(diǎn)杆故，然后點(diǎn)擊那個(gè)綠色的甲蟲就可以了。

8溉愁、VSCode 調(diào)試環(huán)境配置

首先安裝 PHP Debug 插件处铛，然后打開上面創(chuàng)建的 xdebug 目錄。如下圖所示，進(jìn)入調(diào)試面板撤蟆，點(diǎn)齒輪選擇 PHP篙贸，然后會(huì)創(chuàng)建一個(gè) launch.json 文件，修改這個(gè)文件加入 pathMappings 配置枫疆，這個(gè)配置參數(shù)用于設(shè)置服務(wù)器路徑與本地路徑的對應(yīng)關(guān)系爵川，低版本使用的是 localSourceRoot 和 serverSourceRoot，目前已經(jīng)被廢除息楔。另外記得將端口改為 9001寝贡。

進(jìn)入 demo.php，隨意設(shè)置兩個(gè)斷點(diǎn)值依，然后點(diǎn)左側(cè)的運(yùn)行按鈕圃泡，進(jìn)入調(diào)試模式，接下來刷新 http://localhost/xdebug/demo.php 會(huì)返回到 VSCode 的調(diào)試窗口愿险，左側(cè)已經(jīng)列出調(diào)試信息颇蜡，可選擇單步執(zhí)行跟蹤程序的運(yùn)行。

結(jié)尾：實(shí)際上這次部署環(huán)境踩了不少坑辆亏，主要原因是網(wǎng)上的資料都比較陳舊风秤，很多文章也沒有后續(xù)的更新，或者方向和我不太一致扮叨，例如 hub 中直接就有 xdebug 的鏡像缤弦，但是我還是想盡量用官方提供的鏡像自己創(chuàng)建，為了避免踩坑彻磁，大家最好還是多多參考官方文檔碍沐，一般都寫的比較清楚了。

本文轉(zhuǎn)自：https://www.php.cn/php-weizijiaocheng-427163.html