旗下导航:搜·么
当前位置:网站首页 > PHP教程 > 正文

避坑!用 Docker 搞定 PHP 开辟环境搭建【php教程】,Docker

作者:搜教程发布时间:2019-12-01分类:PHP教程浏览:23评论:0


导读:避坑!用Docker搞定PHP开辟环境搭建(Mac、Docker、Nginx、PHP-FPM、XDebug、PHPStorm、VSCode)由于近来换电脑的原因须要...
避坑!用 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 接见来检察。

6、装置 Chrome 浏览器插件 xdebug helper

能够会被墙,请自行解决。

7、PhpStorm 调试环境设置

竖立 / Users/yourname/Workspace/www/xdebug/demo.php,php 文件内里随便写点 php 代码,也能够经由过程 PhpStorm 新竖立一个空项目,然则位置要在我们和 php-fpm 容器绑定的目次。

菜单:PhpStorm->Preferences… 进入偏好设置,依据下图举行设置。

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

继承设置 Debug 相干设置,以下图:

进入主界面,挑选右上的 “Add Configuration...”

进入 debug 设置窗口后挑选 “+”,挑选 “PHP Web Page“,设置称号后进入 Servers 设置,同时设置 Start URL:“/xdebug/demo.php”

进入主窗口,在顺序中打几个断点,然后点击谁人绿色的甲虫就能够了。

8、VSCode 调试环境设置

起首装置 PHP Debug 插件,然后翻开上面建立的 xdebug 目次。以下图所示,进入调试面板,点齿轮挑选 PHP,然后会建立一个 launch.json 文件,修正这个文件到场 pathMappings 设置,这个设置参数用于设置服务器途径与当地途径的对应关联,低版本运用的是 localSourceRoot 和 serverSourceRoot,现在已被取销。别的记得将端口改成 9001。

进入 demo.php,随便设置两个断点,然后点左边的运转按钮,进入调试形式,接下来革新 http://localhost/xdebug/demo.php 会返回到 VSCode 的调试窗口,左边已列出调试信息,可挑选单步实行跟踪顺序的运转。

末端:实际上此次布置环境踩了不少坑,重要原因是网上的材料都比较陈腐,许多文章也没有后续的更新,或许方向和我不太一致,比方 hub 中直接就有 xdebug 的镜像,然则我照样想只管用官方供应的镜像本身建立,为了防止踩坑,人人最好照样多多参考官方文档,平常都写的比较清楚了。

以上就是避坑!用 Docker 搞定 PHP 开辟环境搭建的细致内容,更多请关注ki4网别的相干文章!

标签:Docker


欢迎 发表评论: