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 通路來檢視。
![](https://img.laitimes.com/img/9ZDMuAjOiMmIsIjOiQnIsIyZuBHL0FWby9mZvwVZnFWbp1zczV2YvJHctM3cv1Ce-EUTwkleMJkTqFFasJzY6RmVjl3cHV2MWhlUZlTbXRjRqplRkhFZMJkbSxEctlFcoVlUup1aZBHa6RGR5IjWqxmbkNTTYJleot2V3l0VhZkSYZlM5c1TXp0RPVlQ6FWNShUZShXbR9kVyMVNk1mYZJFSPlEZINWeGRUVNp0VhJVO5pVdCNDW2wWbZRXMywUdO1GTqx2RjhXNpVGcKdlY0lTeMZTTINGMShUYvwlbj5yZtlmbkN3YuQnclZnbvN2Ztl2Lc9CX6MHc0RHaiojIsJye.jpg)