Docker 搭建 PHP 开发环境

淩亂°似流年 2023-06-26 05:52 10阅读 0赞

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 访问来查看。

![format_png][]

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly9tbWJpei5xcGljLmNuL21tYml6X3BuZy9RaWJMUDFycHdIOHRYbmd5S2VOQmxReHR5azBUOGJWOW92VXJFaWIwWkhzRXM3dnljZ29DdzhpYkZnRUhpYmpLRnBLdXdFZjF4Wm9YRXV3eGsycVdzc2lhQjNBLzY0MA?x-oss-process=image/format,png