站長資訊網
        最全最豐富的資訊網站

        使用 Docker 搭建 PHP 開發環境

        使用 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,通過瀏覽器訪問 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 訪問來查看。

        使用 Docker 搭建 PHP 開發環境

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

        可能會被墻,請自行解決。

        7、PhpStorm 調試環境配置

        建立 / Users/yourname/Workspace/www/xdebug/demo.php,php 文件里面隨便寫?? php 代碼,也可以通過 PhpStorm 新建立一個空項目,但是位置要在我們和 php-fpm 容器綁定的目錄。

        菜單:PhpStorm->Preferences… 進入偏好設置,按照下圖進行設置。

        使用 Docker 搭建 PHP 開發環境

        根據上圖提示進入 CLI Interpreter 設置窗口,點 “+” 添加配置。

        使用 Docker 搭建 PHP 開發環境

        使用 Docker 搭建 PHP 開發環境

        繼續配置 Debug 相關設置,如下圖:

        使用 Docker 搭建 PHP 開發環境

        進入主界面,選擇右上的 “Add Configuration…”

        使用 Docker 搭建 PHP 開發環境

        進入 debug 配置窗口后選擇 “+”,選擇 “PHP Web Page“,設置名稱后進入 Servers 設置,同時設置 Start URL:“/xdebug/demo.php”

        使用 Docker 搭建 PHP 開發環境

        使用 Docker 搭建 PHP 開發環境

        進入主窗口,在程序中打幾個斷點,然后點擊那個綠色的甲蟲就可以了。

        使用 Docker 搭建 PHP 開發環境

        8、VSCode 調試環境配置

        首先安裝 PHP Debug 插件,然后打開上面創建的 xdebug 目錄。如下圖所示,進入調試面板,點齒輪選擇 PHP,然后會創建一個 launch.json 文件,修改這個文件加入 pathMappings 配置,這個配置參數用于設置服務器路徑與本地路徑的對應關系,低版本使用的是 localSourceRoot 和 serverSourceRoot,目前已經被廢除。另外記得將端口改為 9001。

        使用 Docker 搭建 PHP 開發環境

        使用 Docker 搭建 PHP 開發環境

        進入 demo.php,隨意設置兩個斷點,然后點左側的運行按鈕,進入調試模式,接下來刷新 http://localhost/xdebug/demo.php 會返回到 VSCode 的調試窗口,左側已經列出調試信息,可選擇單步執行跟蹤程序的運行。

        使用 Docker 搭建 PHP 開發環境

        使用 Docker 搭建 PHP 開發環境

        結尾:實際上這次部署環境踩了不少坑,主要原因是網上的資料都比較陳舊,很多文章也沒有后續的更新,或者方向和我不太一致,例如 hub 中直接就有 xdebug 的鏡像,但是我還是想盡量用官方提供的鏡像自己創建,為了避免踩坑,大家最好還是多多參考官方文檔,一般都寫的比較清楚了。得益于 docker 的便利,我會不定期的更新這篇文章,這也是我在文章開頭設置了一個版本號的原因,希望對大家有所幫助。

        贊(0)
        分享到: 更多 (0)
        網站地圖   滬ICP備18035694號-2    滬公網安備31011702889846號
        主站蜘蛛池模板: 国产91精品一区二区麻豆亚洲| 国产伦精品一区二区三区视频猫咪| 久久er热视频在这里精品| 麻豆国产高清精品国在线| 麻豆精品成人免费国产片| 久久久久成人精品无码中文字幕| 欧美日韩精品系列一区二区三区国产一区二区精品 | 56prom精品视频在放免费| 日韩精品久久无码人妻中文字幕| 久久99精品久久久久久野外| 亚洲国产精品自在在线观看| 国产精品成熟老女人视频| 亚洲精品狼友在线播放| 欧美精品在线免费| 精品精品国产高清a毛片| 日韩精品无码一区二区三区不卡| 国产一区二区三区久久精品| 精品调教CHINESEGAY| 亚洲一区精品无码| 欧美日韩精品系列一区二区三区| 精品国产国产综合精品| 国产精品99| 国产成人精品久久| 国产成人精品怡红院在线观看| 四虎国产精品免费入口| 国产在线精品一区二区在线观看| 久久精品夜夜夜夜夜久久| 无码国产精品一区二区免费式芒果| 香港三级精品三级在线专区 | 亚洲国产成人精品女人久久久 | 华人亚洲欧美精品国产| 3D动漫精品啪啪一区二区下载| 国产精品亚洲精品日韩已满| 久久精品国产亚洲av麻豆色欲| 无码精品视频一区二区三区| 无码人妻精品一区二区三区66| 少妇人妻偷人精品免费视频| 色欲精品国产一区二区三区AV| 无码人妻精品一区二区三区东京热| 人人妻人人澡人人爽人人精品| 日本VA欧美VA精品发布|