百度360必应搜狗淘宝本站头条
mysql distinctjenkins官网mysql 子查询vba splitpython list sort
当前位置：网站首页 > IT技术 > 正文

你会用 Docker 搭建 PHP 开发环境吗?

wptr33 2025-02-10 14:37 26 浏览

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

相关推荐

什么是Java中的继承?如何实现继承?

什么是继承？...

Java 继承与多态:从基础到实战的深度解析

在面向对象编程（OOP）的三大支柱中，继承与多态是构建灵活、可复用代码的核心。无论是日常开发还是框架设计，这两个概念都扮演着至关重要的角色。本文将从基础概念出发，结合实例与图解，带你彻底搞懂Java...

Java基础教程:Java继承概述_java的继承

继承概述假如我们要定义如下类：学生类，老师类和工人类，分析如下。学生类属性：姓名，年龄行为：吃饭，睡觉老师类属性：姓名，年龄，薪水行为：吃饭，睡觉，教书班主任属性：姓名，年龄，薪水行为：吃饭，睡觉，管...

java4个技巧:从继承和覆盖，到最终的类和方法

日复一日，我们编写的大多数Java只使用了该语言全套功能的一小部分。我们实例化的每个流以及我们在实例变量前面加上的每个@Autowired注解都足以完成我们的大部分目标。然而，有些时候，我们必须求助于...

java:举例说明继承的概念_java继承的理解

在现实生活中，继承一般指的是子女继承父辈的财产。在程序中，继承描述的是事物之间的所属关系，通过继承可以使多种事物之间形成一种关系体系。例如猫和狗都属于动物，程序中便可以描述为猫和狗继承自动物，同理，...

从零开始构建一款开源的 Vibe Coding 产品 Week1Day4:业界调研之 Agent 横向对比

前情回顾前面两天我们重点调研了了一下Cursor的原理和Cursor中一个关键的工具edit_file的实现，但是其他CodingAgent也需要稍微摸一下底，看看有没有优秀之处，下...

学会这几个插件，让你的Notepad++使用起来更丝滑

搞程序开发的小伙伴相信对Notepad++都不会陌生，是一个占用空间少、打开启动快的文件编辑器，很多程序员喜欢使用Notepad++进行纯文本编辑或者脚本开发，但是Notepad++的功能绝不止于此，...

将 node_modules 目录放入 Git 仓库的优点

推荐一篇文章Whyyoushouldcheck-inyournodedependencies[1]...

再度加码AI编程，腾讯发布AI CLI并宣布CodeBuddy IDE开启公测

“再熬一年，90%的程序员可能再也用不着写for循环。”凌晨两点半，王工还在公司敲键盘。他手里那份需求文档写了足足六页，产品经理反复改了三次。放在过去，光数据库建表、接口对接、单元测试就得写两三天。现...

git 如何查看stash的内容_git查看ssh key

1.查看Stash列表首先，使用gitstashlist查看所有已保存的stash：...

6万星+ Git命令懒人必备!lazygit 终端UI神器，效率翻倍超顺手!

项目概览lazygit是一个基于终端的Git命令可视化工具，通过简易的TUI（文本用户界面）提升Git操作效率。开发者无需记忆复杂命令，即可完成分支管理、提交、合并等操作。...

《Gemini CLI 实战系列》(一)Gemini CLI 入门:AI 上命令行的第一步

谷歌的Gemini模型最近热度很高，而它的...

deepin IDE新版发布:支持玲珑构建、增强AI智能化

IT之家8月7日消息，深度操作系统官方公众号昨日（8月6日）发布博文，更新推出新版deepin集成开发环境（IDE），重点支持玲珑构建。支持玲珑构建deepinIDE在本次重磅更...

狂揽82.7k的star，这款开源可视化神器，轻松创建流程图和图表

再不用Mermaid，你的技术文档可能已经在悄悄“腐烂”——图表版本对不上、同事改完没同步、评审会上被一句“这图哪来的”问得哑口无言。这不是危言耸听。GitHub2025年开发者报告显示，63%的新仓...

《Gemini CLI 实战系列》(五)打造专属命令行工具箱

在前几篇文章中，我们介绍了GeminiCLI的基础用法、效率提升、文件处理和与外部工具结合。今天我们进入第五篇...

一周热门
最近发表
标签列表
赣ICP备2024040476号-12