从零构建一个基于 Docker 的 Laravel 应用

Docker 简介#

其实在这样的一个云计算时代,Docker 早就已被人众所周知了,它改变了传统物理机的虚拟化方式,使得机器的资源得到了高效的利用。因为运行在 Docker 中的应用实际上就是运行在宿主机上的,所以它是不需要进行硬件层面的虚拟化以及运行一个完整操作系统来支持。于是在应用代码的执行效率,内存的使用以及文件的读取速度都比传统虚拟化的方式来的强。而且它的启动速度非常快,往往都是在毫秒级的,可以大大的节约了开发测试以及部署的时间.
其实对于开发人员来说,Docker 一个更大的意义就是可以保证拥有一致的运行环境,程序员最常见的就是在开发测试部署环境不一致的情况下,经常会触发一些莫名奇妙的 BUG, 为了杜绝「这段代码在我机器上没问题啊」这类的问题,这也是我们要去学习 Docker 的理由之一.

如何学习 Docker?#

网上充斥着大量的关于 Docker 各个方面的教程和资料,而且由于 Docker 的飞速发展,很多教程其实都过时了,对于初学者来说很难去分辨把握,随之而来的就是一系列的坑与问题,渐渐的磨灭了学习者的动力。其实学习一门新技术最好的永远都是从官方的文档入手,然后就是 GitHub 上面一个技术人员的学习笔记,最重要的是要去摸索实践,并且做好学习笔记。其实学习一门新技术,如果有正确的学习方法是可以少走很多弯路的,这个有机会会写一篇心得.

快速入门#

这里限制于篇幅和作者水平,不会大谈 Docker 底层原理以及技术实现,也不会教你如何写一个繁琐的 Dockerfile, 而是会从一个普通开发者的身份入手,带你从零搭建一个基于 Docker 的 Laravel 应用。我们的系统环境使用的是 Ubuntu17.04, 其他系统也差不多,当然 Window 的话可能就要另当别论了.

安装 Docker#

在 Ubuntu 下 Docker 的安装和常规的软件一样,但是由于中国特色,还有有很多要注意的点,待会会详细说明. Docker 的安装方式有很多种,这里建议使用官方的一键安装脚本来,避免一系列繁琐的操作。

1. 下载安装#

  curl -fsSL get.docker.com -o get-docker.sh

然后安装,并且选择从阿里镜像源下载:

sudo sh get-docker.sh --mirror Aliyun

2. 基本配置#

其实安装后基本上就可以使用了,主要是配置一些镜像源和用户组。配置镜像源的目的不多说,用户组主要是为了再使用的时候不用使用超级管理员权限即可运行。

  • 加入用户组

    sudo usermod -aG docker $USER

    PS. 配置用户组后,可能还是会出现还是提示没有权限的情况,这时重启机器即可

  • 配置镜像源

    sudo mkdir -p /etc/docker
    sudo tee /etc/docker/daemon.json <<-'EOF'
    {
    "registry-mirrors": ["https://be62qq2e.mirror.aliyuncs.com"]
    }
    EOF

    PS. 这里的镜像源是我自己阿里云的,同学们可以自行去阿里云获取专有镜像源地址

  • 重启

    sudo systemctl daemon-reload
    sudo systemctl restart docker

3. 安装 docker-compose#

docker-compose 类似一个包管理工具,方便我们管理镜像。

curl -L https://github.com/docker/compose/releases/download/1.17.1/run.sh > /usr/local/bin/docker-compose
chmod +x /usr/local/bin/docker-compose

基本概念#

Docker 有两个很重要的基本概念就是镜像和容器。这两个其实就类似面向对象中的类和实例。镜像构建起来后就是容器,然后容器可以启动停止,对于运行于容器中的应用在运行过程中产生的数据,实际上是可以保留下来的,只要不销毁容器。如果销毁或者重新构建容器后数据自然就不存在了,所以官方建议用挂载的方式来持久化,接下来会说到.

docker-compose#

docker-compose 可以说是真正的让 Docker 现代化了。它就类似于 PHP 的 Composer 包管理工具一样,是用来管理多个镜像的。它极大的降低了学习 Docker 的难度。我们在日常的开发中,经常会碰到需要多个容器相互配合来完成某项任务的情况,比如 Web 容器和数据库容器之间的通信,我们可以单独的把一个项目中需要的所有容器和配置写到一个 docker-compose.yml 文件中,来统一管理。来看一下一个简单的配置文件格式:

version: '3'
services:
  nginx:
    build: .
    ports:
     - "80:80"

  redis:
    image: "redis:alpine"

一个项目可以由多个服务 (容器) 工程,而 docker-compose 是面向项目进行管理.

文件系统和网络#

这是 Docker 比较复杂的一块,简单介绍一下. Docker 里面的文件系统其实很真实宿主机的一样,可以用同样的命令去操作,只是要注意的一点就是我们在容器中运行的应用配置文件的路径全部都是基于 Docker 的,不是基于宿主机的,很多文件不存在的问题都是这个引起来的。比如我们在运行一个 Nginx 容器和 PHP-FPM 容器的时候,不仅要把宿主机的项目路径映射到 Nginx 容器中,还要映射到 PHP-FPM 容器中,否则就会是一系列的 File not found.
Docker 中的网络是有多种模式的,在默认情况下是会创建一个虚拟网桥的,实际上是 Linux 的一个 bridge,它会在挂载到它的网口之间进行转发。并且会随机分配一个本地未被使用的属于 172.17.0.0/16 网段的 IP 到各个容器中.

部署 Laravel 应用#

基本介绍后我们会通过一个简单的实例来加深理解,就是部署一个 Laravel 应用. Web 服务器我们会使用 Nginx, 并且通过 PHP-FPM 来处理动态请求,用 MySQL 来存储数据,Redis 作为我们的缓存和队列驱动。不同于网上的通过 Supervisor 来把所有服务运行在同一个容器中,我们会把这四个服务运行在四个容器中,这也是官方推荐的一种做法,然后我们会通过 docker-compose 来管理所有的服务 (容器).

Nginx#

直接上配置文件:

version: '2'
services:
    nginx:
        image: nginx
        ports:
            - "8090:80"
        links:
            - php-fpm
        volumes:
          - ./nginx/www:/var/www/html
          - ./nginx/sites:/etc/nginx/sites-enabled
          - ./nginx/nginx.conf:/etc/nginx/nginx.conf
        command: [nginx-debug, '-g', 'daemon off;']

其中的 services 节点下每一个表示一个服务;然后 nginx 这是个服务名可以随便取;image 指定使用哪个镜像来构建;ports 表示要暴露的端口,其中 8090 是指宿主机的端口,80 是指容器中的端口;volumes 表示挂载的目录和文件,我们这里挂载了代码目录,虚拟主机目录以及配置文件;command 表示容器启动后要运行的命令。我们还要在当前目录下创建一个 nginx 的目录,用来存放一系列的文件,还需要把配置文件新建并且写入配置内容 (具体配置内容可以去官网查看,这里不说明),最后的目录结构是这样

Docker
    - docker-compose.yml
    - nginx
        - www
        - sites
        - nginx.conf

可以把日志一起挂载,这里没有表述出来

然后执行启动容器的命令:

docker-compose up nginx

以上不会在后台启动,而是会直接在当前的 shell 上,然后我们访问应该就可以看到 Welcome to nginx!

PHP-FPM MySQL Redis#

同理我们再次配置 PHP-FPM,MySQL 以及 Redis 的容器了,具体过程不多讲,这里贴出配置:

  php-fpm:
    image: 'bitnami/php-fpm:7.1'
    volumes:
      - ./nginx/www:/var/www/html
      - ./php-fpm/php.ini:/bitnami/php/conf/php.ini
    links:
      - mysql
      - redis

  mysql:
    image: mysql
    restart: always
    environment:
        MYSQL_ROOT_PASSWORD: example
    volumes:
      - /var/lib/mysql:/var/lib/mysql

  redis:
    image: redis

有一点要注意的是,在配置 PHP-FPM 容器的时候是需要把代码目录也挂载到容器里面的,这一点很容易被遗忘,网上很多教程都没提到,导致最后虽然按照步骤走了但就是跑不起来。其中的 links 就是配置要连接到哪个容器中。比如配置了 Nginx 容器连接到 PHP-FPM 的容器,这样我们在 Nginx 的容器中就可以直接 ping php-fpm, 在配置的时候也可以这样 php-fpm:9000 来配置了。

配置文件#

Nginx 的配置文件,然后还要修改一下本地的 hosts 文件。

server {
    listen 80;
    listen [::]:80;
    root /var/www/html/laravel/public;
    index index.html index.php;
    server_name laravel-docker.app;
    location / {
            try_files $uri $uri/ /index.php?$query_string;
    }
    location ~ \.php$ {
            fastcgi_split_path_info ^(.+\.php)(/.+)$;
            fastcgi_pass php-fpm:9000;
            fastcgi_index index.php;
            include fastcgi_params;
            fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

运行访问#

传图麻烦,自行想象一下 Laravel 的运行图

附录#

贴一些常用的 docker-compose 命令,其中的 dc 表示 docker-compose 命令。

dc  stop            停止所有容器
dc  stop    nginx   停止指定容器
dc  up      -d      启动容器后台运行
dc  ps              查看当前容器
dc  logs    kafka   查看指定容器日志

订阅号,欢迎关注 :smile:
file

本作品采用《CC 协议》,转载必须注明作者和本文链接
本帖由系统于 7年前 自动加精
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
《G01 Go 实战入门》
从零开始带你一步步开发一个 Go 博客项目,让你在最短的时间内学会使用 Go 进行编码。项目结构很大程度上参考了 Laravel。
讨论数量: 10
Jourdon

其它做开发的不需要去对 DOCKER 了解那么多。可以使用 laralock , 好用的很。即开即用,

7年前 评论

@王东哲 确实是,不过我一直都是不建议去使用 laradock, 他就像 xampp 这样的软件,虽然很方便但是也隐藏了很多细节。而这些正是我们应该学习的

7年前 评论
Jourdon

@翁航 嗯。确实,laralock 的 bug 也很多,有些问题作者没有更新也要自己解决,不过学习 docker 基本上就是学习 linux 下的很多东西,所以有兴趣可以研究下,我个人还是觉得有了轮子就没有必要再自已造轮子了。当前,听说很多老司机都会有一个个人专属的 Dockerfile,羡慕中。。

7年前 评论

请问如果想加 2 个不同版本的 php 容器该怎么弄?

7年前 评论
Toiu

请问 laradocker 构建的服务器环境 如何使用其他数据库软件访问数据库 比如 heidiSQL 我是用 laradocker 在云服务器构建的环境

7年前 评论

@klgd 新增一个容器即可

7年前 评论

@刘滔 要让其他也可以访问,可以把容器端口映射到宿主机 上面去,这样其他软件就可以按照正常的方法来连接

7年前 评论
Toiu

@翁航 嗯 默认是做了映射的。只是当时 laradock 默认安装的 mysql8 , 有些问题 后来我换到 mysql5.7 清空了 8.0 的数据之后 就可以用啦~

7年前 评论