使用docker搭建PHP开发环境
1.安装docker和docker-compose
1.1 docker的安装
本次安装使用的Linux发行版是Ubuntu 18.04
,我们可以参照docker的官方文档进行安装,但是有些步骤需要做一些小修改。
首先,删除旧的docker版本:
$ sudo apt-get remove docker docker-engine docker.io containerd runc
接下来更新APT-GET的源头信息和安装相关的软件:
$ sudo apt-get update
$ sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common
接着添加docker的官方的GPG证书:
$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
接着可以使用下面的命令打印刚刚添加的证书:
$ sudo apt-key fingerprint 0EBFCD88
注意1:0EBFCD88是证书的后面8位字符。
注意2:上面的命令可以使用
sudo apt-key finger 0EBFCD88
或者apt-key list 0EBFCD88
代替。
接下来,我们为APT-GET添加docker的软件源,但是我们这里没有安装官方文档进行,因为官方的软件源在国内的访问非常缓慢,我们这里使用了清华大学的docker软件源:
sudo add-apt-repository \
"deb [arch=amd64] https://mirrors.tuna.tsinghua.edu.cn/docker-ce/linux/ubuntu \
$(lsb_release -cs) \
stable"
接下来就是正式安装docker:
$ sudo apt-get update
$ sudo apt-get install docker-ce docker-ce-cli containerd.io
最后,我们可以通过运行hello-world
容器来验证docker是否安装成功:
$ sudo docker run hello-world
输出如下:
1.2 安装docker-compose
因为我们搭建php的开发平台,我们需要最少PHP、MySQL、Nginx三个镜像,随着业务需求的增加,可能还需要Redis、Rabbitmq等等其他的镜像,管理这一系列的容器,如果每个容器单独管理的话,必然给工作带来不便,因此我们需要引入一个简单的容器编排工具docker-compose,下面是安装docker-compose的过程。
首先我们可以从github上面下载docker-compose运行文件,其实docker-compose是python开发的一个单文件的运行程序。
sudo curl -L "https://github.com/docker/compose/releases/download/1.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
我们用上述的命令将docker-compose文件下载到目录/usr/local/bin/
,接下来我们要给予docker-compose可执行权限。
sudo chmod +x /usr/local/bin/docker-compose
然后我们可以验证一下docker-compose是否以及正确安装:
docker-compose -v
输出:
2.编写docker-compose.yml文件
我们对于docker容器的编排,我们都可以在docker-compose.yml文件中定义,首先看一下目录结构:
- docker-compose.yml是容器编排文件
- php/Dockerfile是php镜像的构建文件
- site.conf是NGINX中的网站配置文件
- code是php代码目录
- dbdata是mysql的数据存储目录
下面是我的docker-compose.yml配置文件:
version: '3'
services:
web:
image: nginx:latest
ports:
- "8080:80"
volumes:
- ./code:/code
- ./site.conf:/etc/nginx/conf.d/site.conf
networks:
- code-network
php:
#image: php:7.2-fpm
build:
context: ./php
dockerfile: Dockerfile
image: my_php
volumes:
- ./code:/code
networks:
- code-network
mysql:
image: mysql:5.7
ports:
- 3307:3306
volumes:
- ./dbdata:/var/lib/mysql
environment:
MYSQL_DATABASE: laravel
MYSQL_ROOT_PASSWORD: 123456
SERVICE_TAGS: dev
SERVICE_NAME: mysql
networks:
- code-network
networks:
code-network:
driver: bridge
web和mysql服务都是直接使用了dockerHub中的官方镜像,但是php的官方镜像不能满足我们的需求,我们在官方php7.2的基础上做一些修改,下面是php镜像的Dockerfile:
FROM php:7.2-fpm
RUN docker-php-ext-install mysqli
RUN sed -i s/deb.debian.org/mirrors.163.com/g /etc/apt/sources.list /etc/apt/sources.list.d/buster.list
RUN sed -i s/security.debian.org/mirrors.163.com/g /etc/apt/sources.list /etc/apt/sources.list.d/buster.list
RUN apt-get update && apt-get install -y apt-utils
RUN apt-get install -y procps
RUN mkdir /code
RUN chown -R www-data:www-data /code
注意:上面配置文件中
chown -R www-data:www-data /code
改变了code
文件夹的所属的用户,但是由于code文件夹是挂载进去的,所以后面运行镜像的时候,code里面的文件的用户组全部是www-data:www-data
,这个和我们平常的情况不同,一般的情况是设置完code文件夹的用户组后,里面新创建的文件是根据创建用户来确定的,譬如root创建了一个文件,那个它的用户组就是root:root
,但是这里由于是挂载进去的,所以code下面的文件挂载的时候用户组也变为www-data:www-data
。
下面是Nginx的站点配置文件site.conf:
server {
listen 80;
server_name php-docker.local;
#charset koi8-r;
#access_log /var/log/nginx/host.access.log main;
#log_format ff '/scripts$fastcgi_script_name > $request';
#access_log /var/log/nginx/host.access.log ff;
#location / {
# root /code;
# index index.php index.html index.htm;
#}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
# proxy the PHP scripts to Apache listening on 127.0.0.1:80
#
#location ~ \.php$ {
# proxy_pass http://127.0.0.1;
#}
# pass the PHP scripts to FastCGI server listening on 127.0.0.1:9000
#
location ~ \.php$ {
root /code/public/;
fastcgi_pass php:9000;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
#fastcgi_param SCRIPT_FILENAME /scripts$fastcgi_script_name;
include fastcgi_params;
}
location / {
try_files $uri $uri/ /index.php?$query_string;
}
# deny access to .htaccess files, if Apache's document root
# concurs with nginx's one
#
#location ~ /\.ht {
# deny all;
#}
}
注意:
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
中变量$document_root
对应的就是上面的配置root /code/public/;
这样,我们在团队搭建开发环境的时候,就可以通过上述的配置配置文件实现开发环境的统一,同时由于是在docker中运行,和正式的生产环境非常的类似,简述线上不必要的bug,以及带来交付上的方便。
2.运行镜像
通过上面的配置文件,我们可以很简单的实现开发环境的搭建,现在我们只需要运行下面的命令,整个开发环境就自动搭建起来了:
$ sudo docker-compose up -d
如果希望看到输出调试信息,可以把-d
删除,同时也可以通过-f
选项选取特定的docker-compose.yml
文件:
$ sudo docker-compose -f docker-compose.yml up -d
输出:
3.容器运行过程中的调试技巧
3.1 如何进入运行中的Docker容器
首先要查出容器的的id,可以使用:
$ sudo docker ps
输出:
我们看到my_php
的container id
是4c1a
,可以使用下面命令登陆容器my_php:
$sudo docker exec -it 4c1a bash
3.2 重建docker镜像
有的时候我们修改了Dockerfile,就像我们上面的php文件夹中的Dcokerfile文件,此时我们需要手动的调用镜像重建命令,才能够使docker-compose重新去构建docker镜像:
$sudo docker-compose build
4.配置文件
可以从https://github.com/cloes/php-docker下载到本文使用的配置文件。