亲宝软件园·资讯

展开

利用Docker搭建Laravel开发环境的完整步骤

人气:0

前言

在这篇文章中我们将通过Docker在个人本地电脑上构建一个快速、轻量级、不依赖本地电脑所安装的任何开发套件的可复制的Laravel和Vue项目的开发环境（开发环境的所有依赖都安装在Docker构建容器里），加入Vue只是因为有的项目里会在Laravel项目中使用Vue做前后端分离开发，开发环境中需要安装前端开发需要的工具集，当然前后端也可以分成两个项目开发，这个话题不在本篇文章的讨论范围内。

所以我们的目标是：

开始前你需要先去安装一个Docker客户端，Docker的官网中有详细的安装方法。

第一步：获取Laravel的源码包

因为我们电脑上不安装Composer，所以就不能使用Composer来创建Laravel项目了， 这里我使用cURL直接从github上下载了最新的Laravel源码包，你也可以使用wget或者git clone 来获取源码包。

curl -L -O https://github.com/laravel/laravel/archive/v5.5.0.tar.gz /
&& tar -zxvf v5.5.0.tar.gz /
&& rm v5.5.0.tar.gz

上面的命令在curl下载完源码包后会解压源码压缩包，解压完成后在把源码压缩包v5.5.0.tar.gz删掉，执行完后你会看到一个laravel-5.5.0的项目目录。

第二步：添加docker-compose.yml

在项目中创建docker-compose.yml文件。

Compose 项目是 Docker 官方的开源项目，负责实现对 Docker 容器集群的快速编排。我们知道使用一个 Dockerfile 模板文件，可以让用户很方便的定义一个单独的应用容器。在这里我们会用到四个容器分别将PHP、Mysql、Nginx放在四个不同的容器中，通过compose将四个应用容器关联到一起组成项目。
编排文件的开头如下:

version: '2'
services:
  # our services will go here

在编排文件中，把每个容器叫做一个服务，services下定义整个应用中用到的所有服务（即容器）。

App服务

APP服务的容器将执行我们项目中的代码。

app:
 build:
  context: ./
  dockerfile: app.dockerfile
 working_dir: /var/www
 volumes:
  - ./:/var/www
 environment:
  - "DB_PORT=3306"
  - "DB_HOST=database"

Notes:

现在我们需要创建上面build环节中提到的app.dockerfile这个文件了，具体内容如下:

FROM php:7.1.22-fpm

# Update packages
RUN apt-get update

# Install PHP and composer dependencies
RUN apt-get install -qq git curl libmcrypt-dev libjpeg-dev libpng-dev libfreetype6-dev libbz2-dev

# Clear out the local repository of retrieved package files
# RUN apt-get clean

# Install needed extensions
# Here you can install any other extension that you need during the test and deployment process
RUN apt-get clean; docker-php-ext-install pdo pdo_mysql mcrypt zip gd pcntl opcache bcmath


# Installs Composer to easily manage your PHP dependencies.
RUN curl --silent --show-error https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# Install Node
RUN apt-get update &&\
  apt-get install -y --no-install-recommends gnupg &&\
  curl -sL https://deb.nodesource.com/setup_10.x | bash - &&\
  apt-get update &&\
  apt-get install -y --no-install-recommends nodejs &&\
  npm config set registry https://registry.npm.taobao.org --global &&\
  npm install --global gulp-cli

CMD php-fpm

Notes:

Web服务

接下来，我们需要配置一个Web服务器用，我们把这个容器在编排文件中命名成web

web:
 build:
  context: ./
  dockerfile: web.dockerfile
 working_dir: /var/www
 volumes_from:
  - app
 ports:
  - 8080:80

Notes:

Web服务器选用nginx，所以我们需要用一个nginx镜像文件来构建这个容器，在这之前我们需要在nginx镜像的基础上再设置一下项目中用到的vhost，所以我们需要一个web.dockerfile文件，它的定义如下：

FROM nginx:1.10

ADD vhost.conf /etc/nginx/conf.d/default.conf

根据镜像文件的定义，我们把项目中的vhost.conf复制到了容器的/etc/nginx/conf.d/default.conf中，这样基本的nginx配置就配置好了，vhost.conf中的定义如下:

server {
  listen 80;
  index index.php index.html;
  root /var/www/public;

  location / {
    try_files $uri /index.php?$args;
  }

  location ~ \.php$ {
    fastcgi_split_path_info ^(.+\.php)(/.+)$;
    fastcgi_pass app:9000;
    fastcgi_index index.php;
    include fastcgi_params;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PATH_INFO $fastcgi_path_info;
  }
}

Notes:

Mysql服务

接下来我们将配置Mysql服务，与上面两个服务有点不一样的是，在PHP-FPM和Nginx的容器中，我们配置本地电脑的文件可以同步到容器中供容器访问，这让我们开发时对文件作的更改能够快速的在容器中得到反馈加快我们的开发过程。但是在数据库容器中我们希望容器中创建的文件能够持久化（默认容器销毁时，容器内创建的文件也会被销毁），我们可以通过Docker的数据卷来实现上述功能，只不过这次不用再把本地电脑的文件挂在到数据卷上了，Docker客户端会管理创建的数据卷的在本地电脑上具体存储的位置。
下面是编排文件中对database服务的设置

version: '2'
services:

 database:
  image: mysql:5.7
  volumes:
   - dbdata:/var/lib/mysql
  environment:
   - "MYSQL_DATABASE=homestead"
   - "MYSQL_USER=homestead"
   - "MYSQL_PASSWORD=secret"
   - "MYSQL_ROOT_PASSWORD=secret"
  ports:
    - "33061:3306"

volumes:
 dbdata:

Notes:

将所有服务编排到一起

下面是完整的docker-compose.yml文件，通过编排文件我们将三个应用容器关联在一起组成了项目的服务端

version: '2'
services:

 # The Application
 app:
  build:
   context: ./
   dockerfile: app.dockerfile
  working_dir: /var/www
  volumes:
   - ./:/var/www
  environment:
   - "DB_PORT=3306"
   - "DB_HOST=database"

 # The Web Server
 web:
  build:
   context: ./
   dockerfile: web.dockerfile
  working_dir: /var/www
  volumes_from:
   - app
  ports:
   - 8080:80

 # The Database
 database:
  image: mysql:5.6
  volumes:
   - dbdata:/var/lib/mysql
  environment:
   - "MYSQL_DATABASE=homestead"
   - "MYSQL_USER=homestead"
   - "MYSQL_PASSWORD=secret"
   - "MYSQL_ROOT_PASSWORD=secret"
  ports:
    - "33061:3306"

volumes:
 dbdata:

启动服务

按照上面的步骤配置好编排文件还有指定的docker镜像文件后，我们就可以通过下面的命令启动服务了，执行完后会启动上面文件里定义的三个服务。

docker-compose up -d

第一次启动时，由于docker客户端要下载上面提到的三个镜像并且构建服务所以启动速度会慢一些，等到下载完镜像并构建完成后，以后的启动都会非常快。

初始化Laravel项目

启动完服务后我们可以初始化Laravel项目了，步骤跟官方文档里介绍的一样，但是需要在启动的app服务的容器里执行：

docker-compose exec app composer install
docker-compose exec app npm install // 如果包含前端项目的话再执行相关命令
docker-compose exec app cp .env.example .env
docker-compose exec app php artisan key:generate
docker-compose exec app php artisan optimize
docker-compose exec app php artisan migrate --seed
docker-compose exec app php artisan make:controller MyController

Notes：

查看nginx日志的方法:

执行完上面的命令后你就能通过http://127.0.0.1:8080/访问到项目啦。

在我的Github gist有一组参考文件方便同学们参考https://gist.github.com/kevinyan815/fa0760902d29f19a4213b4a16fe0501b

gist里的文件稍微旧一些，后来在使用的过程中又加入些新的PHP模块和Node，之前composer也单独放到了一个容器中，不过相信聪明的你看到这里应该已经会根据需求更改这些文件啦。

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，谢谢大家对的支持。

您可能感兴趣的文章:

加载全部内容
相关教程
猜你喜欢
用户评论