分享我的发现、想法与心得

0%

使用docker搭建laravel开发环境

为何用docker?

在电脑还是window系统的时候,经常需要基于vm服务搭建一套环境才能更好地(应该是更贴近线上环境)进行开发,而现在在docker的神秘光环底下已经能实现用最小的资源搭建本地开发环境,同时能更好地迁移到其他地方。

前置知识

  • 了解docker安装及使用
  • 了解docker-compose命令行的使用
  • 了解laravel安装及使用

本文主要使用laradock进行本地的docker配置。laradock已经集成laravel需要使用的环境,只需要简单修改配置就能搭建环境提供开发,对开发及管理来说真是一味良方。

简单说明一下,在docker环境下我们需要运行laravel项目,实际会建立下几个容器(container):

  • workspace (开发环境)
  • php-fpm (php支持)
  • nginx (web服务)
  • mysql (数据库)

这些都是基于laradock再处理后的生成的容器,可参考laradock目录下相应名字的目录,里面包含Dockerfile及相关配置,感兴趣的同学可以尽情阅读学习 :)

更加深入的内容建议移步至laradock官方文档

准备

在window系统下先安装docker

docker-download

等多次重启后运行docker命令测试一下。

docker-test

然后在你项目的平级目录使用git拉取https://github.com/laradock/laradock.git这个包。

1
2
3
4
5
# 平级目录

D:/www/
- /laradock
- /my-project

这样准备就绪进入下一步。

配置

这里配置的环境按常用环境进行配置

  • nginx
  • php-fpm 5.6
  • mysql 5.6

接着需要修改laradock/.env文件

1
2
/www/laradock
- .env

进入laradock目录会发现并不存在.env文件,这里需要我们从env-example复制一份进行修改。

1
2
3
# /www/laradock

$ cp env-example .env

修改PHP版本

进入.env文件找到 PHP_VERSION 修改php版本为56(默认71,可选71, 70, 56)。

1
2
3
4
# /www/laradock/.env
### PHP Version

PHP_VERSION=56

修改Mysql版本及配置

进入.env文件找到 MYSQL 修改mysql版本为56(默认8,可选8, 5, 5.6, 5.5)。

其他的设置根据个人需要填写,一般情况下需要修改MYSQL_USER, MYSQL_PASSWORD, MYSQL_ROOT_PASSWORD 来确保链接。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
# /www/laradock/.env
### MYSQL

MYSQL_VERSION=5.6

# MYSQL_DATABASE 可选,填写后会默认创建同名数据库
MYSQL_DATABASE=default

# MYSQL_USER 用户,填写后会创建用户,默认为 default
MYSQL_USER=packy

# MYSQL_PASSWORD 密码,填写后作为新建用户的密码,默认为 secret
MYSQL_PASSWORD=123456-

# MYSQL_PORT 访问端口,默认是3306,建议不要修改
MYSQL_PORT=3306

# MYSQL_ROOT_PASSWORD root用户密码,建议使用严谨的密码,默认为 root
MYSQL_ROOT_PASSWORD=23333-
MYSQL_ENTRYPOINT_INITDB=./mysql/docker-entrypoint-initdb.d

关于Mysql版本选择

mysql使用的是官方镜像,所以我们可以使用hub.docker.com查询mysql官方镜像包含哪些版本。具体如何选择得看各自的需求。

docker hub 的mysql页面说明

修改nginx配置

一般情况下并不需要修改什么,使用默认的便可。关于网站的配置需要进入laradock/nginx/sites

如需要修改端口可以进入.env文件找到 NGINX进行修改。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
# /www/laradock/.env
### NGINX

NGINX_HOST_HTTP_PORT=80
NGINX_HOST_HTTPS_PORT=443

# NGINX_HOST_LOG_PATH log存放位置,默认位置在laradock/logs/nginx/
NGINX_HOST_LOG_PATH=./logs/nginx/

# NGINX_SITES_PATH 网站配置, 默认位置在laradock/nginx/sites/
NGINX_SITES_PATH=./nginx/sites/

NGINX_PHP_UPSTREAM_CONTAINER=php-fpm
NGINX_PHP_UPSTREAM_PORT=9000

关于Nginx的配置

nginx的配置文件存放在laradock/nginx/sites下,需要新建网站的可通过复制对应的.example并重命名为.conf进行修改。注:只用.conf文件才会在nginx下加载。

这里我复制laravel.conf.example作为例子重命名为my-project.conf

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# laradock/nginx/sites/my-project.conf
server {

listen 80;
listen [::]:80;

# 域名,改为你的域名
server_name my-project.com;
# 项目目录,均以 /var/www/ 开头。这个约定后续会说明
root /var/www/my-project;
index index.php index.html index.htm;

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

location ~ \.php$ {
try_files $uri /index.php =404;
fastcgi_pass php-upstream;
fastcgi_index index.php;
fastcgi_buffers 16 16k;
fastcgi_buffer_size 32k;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}

location ~ /\.ht {
deny all;
}

location /.well-known/acme-challenge/ {
root /var/www/letsencrypt/;
log_not_found off;
}

error_log /var/log/nginx/laravel_error.log;
access_log /var/log/nginx/laravel_access.log;
}

同时修改宿主机(就是window本地机子)的hosts

1
2
3
# C:\Windows\System32\drivers\etc\hosts

127.0.0.1 my-project.com

尝试运行

到这步准备工作差不多完成了。

运行以下命令进行安装及使用,因为是国外源拉取时间比较慢请耐心等待。

1
docker-compose up -d nginx mysql

docker--container-up

完成后输入docker ps参看容器运行情况。一切正常!!!

docker--ps

尝试访问http://my-project.com看看效果。目前能正常访问php文件。

docker--ps

运行laravel

这里就不得说workspace这个容器,它作为工作区提供各类工具使用(包含:PHP CLI, Composer, Git, Linuxbrew, Node, V8JS, Gulp, SQLite, xDebug, Envoy, Deployer, Vim, Yarn等)。

那如何使用这些功能呢?

首先进入workspace容器

1
2
# /www/laradock
docker-compose exec workspace bash

composer换国内源

进到容器后默认就是项目目录/var/www,由于composer用的是国外源比较慢,这里需要切换成国内源。

1
composer config -g repo.packagist composer https://packagist.phpcomposer.com

安装laravel

这里我们需要在my-project目录安装laravel。

*注:需要提前把my-project里的所有内容清空

1
2
3
composer create-project laravel/laravel my-project2 "5.2.*" && \
cd my-project && \
php artisan key:generate

配置并重启nginx

安装完成后,把laradock/nginx/sites/my-project.conf文件下的网站目录地址稍微改一下

1
2
3
4
5
6
7
8
9
10
11
12
server {

listen 80;
listen [::]:80;

server_name my-project.com;
# 加上public目录
root /var/www/my-project/public;
index index.php index.html index.htm;

...
}

重启nginx容器

1
2
# /www/laradock
docker-compose restart nginx

docker--ps

关于数据库服务

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# .env
DB_CONNECTION=mysql

# mysql的容器网络已经解析至"mysql"域,所以这里配置"mysql"域便能访问
DB_HOST=mysql

# 默认3306,一般不需要改动,如要改动端口应该与laradock/.env中的MYSQL_PORT一致
DB_PORT=3306

# 数据库
DB_DATABASE=default

# 用户
DB_USERNAME=packy

# 密码
DB_PASSWORD=123456-

一些问题:

Q:运行失败,提示ERROR: for laradock_mysql_1 Cannot create container for service mysql: Drive sharing seems blocked by a firewall

A:先暂停你本机杀毒程序的防御进程。


Q:运行失败,提示ERROR: for laradock_nginx_1 Cannot start service nginx: driver failed programming external connectivity on endpoint laradock_nginx_1 (6e4f4761d30f4cd80c44c6b0fddfbd4ef0324529099aace02bee6a6653ce453a): Error starting userland proxy: Bind for 0.0.0.0:443 failed: port is already allocated

A:建议你切换端口,我已尝试改为1443能正常运行,目前只能以这种方式处理。


1
2
3
4
# .env
### NGINX

NGINX_HOST_HTTPS_PORT=1443

Q:为何网站目录必须以/var/www开头?

A:网站访问进入的是nginx容器,/var/www目录就是容器内网站目录存放的位置。由于配置在创建容器时,会将本地目录挂载至/var/www目录,所以就能访问到本地的代码。这块设置在laradock/.env中找到APPLICATION可自行设置。