搭建docker化的php开发环境

php-docker-env

帮助初次接触 docker 的 php 开发者,快速构建 docker 化的 php 开发环境。

包涵的组件

  • mysql : 5.7.18
  • php : 7.1.7
  • xdebug : 2.5.5
  • apache : 2.4.10

关于镜像源

mysql 与 php-apache 均使用网易蜂巢从 DockerHub 拉取的官方镜像

  • 浏览网易蜂巢可能需要登录

快速开始

请确保已经安装 docker

  • Mac 安装 docker
  • Windows 安装 docker
  • 其它用户
  • docker 快速入门

拉取镜像

执行以下命令,获取mysql镜像

docker pull hub.c.163.com/library/mysql:5.7.18

执行以下命令,获取php-apache镜像

docker pull hub.c.163.com/library/php:7.1.7-apache

构建自己的镜像

以上,我们已经获取到了两个基础镜像,使用 docker run 命令就能使用了。但开发环境中,我们还需为PHP安装xdebug插件以方便调试,以及配置 php 和 apache。所以我们要在 php-apache 这个镜像的基础上自定义一个镜像。./docker/Dockerfile 中已经定义好 docker 该如何构建这个镜像。我们只需:

docker build -t webserver ./docker/

就能构建一个名为 webserver 的镜像。(构建镜像可能需要一些时间)

创建容器(运行镜像)

启动 mysql

第一次启动 mysql 需执行以下命令:

docker run --name mydb -v "$PWD"/mysql:/var/lib/mysql -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=root hub.c.163.com/library/mysql:5.7.18

命令详解:

  • 这条命令根据 hub.c.163.com/library/mysql:5.7.18 镜像,创建并运行了一个名为 mydb 的容器。
  • 将此目录下的 mysql 目录挂载到 ./mydb 容器的 /var/lib/mysql 目录,mydb 运行时所产生的数据将得到保存。
  • 将主机的 3306 端口映射到 mydb 容器中的 3306 端口。
  • 将 mysql 的 root 用户密码设置为root。以后在 ./mysql/ 目录运行 mysql 镜像 将不用带 -e MYSQL_ROOT_PASSWORD=root 参数。
    可直接执行:
docker run --name mydb -v "$PWD"/mysql:/var/lib/mysql -p 3306:3306 -d -e MYSQL_ROOT_PASSWORD=root hub.c.163.com/library/mysql:5.7.18

启动 php-apache

也就是我们构建的 webserver 镜像:

docker run --name myserver -v "$PWD"/src:/var/www/html -p 8080:80  -e XDEBUG_CONFIG="remote_host=192.168.1.102" -d webserver

命令详解:

  • 这条命令根据我们自定义的 webserver 镜像,创建并运行了一个名为 myserver 的容器。
  • 将此目录下的 ./src 目录挂载到 myserver 容器的 /var/www/html 目录,你的 php 项目代码放入 ./src 目录即可。
  • 将主机的 8080 端口映射到 myserver 容器的 80 端口。
  • -e XDEBUG_CONFIG="remote_host=192.168.1.102" 此参数中的 ip 地址请更改为你主机的 ip 地址。它设置了 xdebug 插件的 remote_host。

至此,我们已经成功启动了我们的 php 开发环境

进行项目开发

将你的 php 项目代码放入 ./src/ 目录,编辑代码,将可得到 myserver 容器的实时响应。
这里我们以 ThinkPHP5框架 为例子:
浏览器输入 http://localhost:8080/pulbic/ 即可访问到ThinkPHP5框架的欢迎页面。

配置文件

文件位置

  • apache 主配置文件位于主机 ./docker/conf/apache2.conf 对应于容器的 /etc/apache2/apache2.conf
  • xdebug 配置文件位于主机 ./docker/conf/docker-php-ext-xdebug.ini 对应于容器的 /usr/local/etc/php/conf.d/docker-php-ext-xdebug.ini
  • php 主配置文件位于 ./docker/conf/php.ini 对应于容器的 /usr/local/etc/php/php.ini
  • 虚拟域名配置文件统一放置于 ./docker/vhost/ 对应于容器的 /etc/apache2/sites-enabled/

配置生效

由于配置文件在docker容器创建时就被打包到容器中,所以无法动态更改。
当更改配置后,需要停止并删除当前运行的容器,重新创建容器即可:

docker stop myserver 
docker rm myserver
docker build -t webserver ./docker/
docker run --name myserver -v "$PWD"/src:/var/www/html -p 8080:80  -e XDEBUG_CONFIG="remote_host=192.168.1.102" -d webserver

与容器交互

docker exec [容器名] [容器执行的命令]
  • 以上命令可在主机中,让容器执行一条特定的命令。
  • 加入 -i 标志可保持主机对容器对输入。
  • 加入 -t 标志可让容器打开一个伪终端。
  • 更多用法请执行命令 docker exec --help

所以我们可以这样与 mysql 交互:

docker exec -it mydb mysql -h 127.0.0.1 -u root -p

此命令将打开一个终端,输入 mysql root 用户密码后,可连接 mysql。

exit

可退出终端。

进入容器执行更多命令

docker exec -it myserver /bin/bash

以上命令可进入 myserver 容器,并可在容器内执行更多命令,如 ls, cd, ps ...

更多请参阅 docker 快速入门

互相学习交流可加 QQ:568499182

学习愉快!

你可能感兴趣的:(搭建docker化的php开发环境)