当前位置:Gxlcms > PHP教程 > docker搭建laravel开发环境实例

docker搭建laravel开发环境实例

时间:2021-07-01 10:21:17 帮助过:97人阅读

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

简单说明一下,在docker环境下我们需要运行laravel项目,实际会建立下几个容器(container):在电脑还是window系统的时候,经常需要基于vm服务搭建一套环境才能更好地(应该是更贴近线上环境)进行开发,而现在在docker的神秘光环底下已经能实现用最小的资源搭建本地开发环

境,同时能更好地迁移到其他地方。

  • workspace (开发环境)

  • php-fpm (php支持)

  • nginx (web服务)

  • mysql (数据库)

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

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

准备

在window系统下先安装docker

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

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

# 平级目录

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

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

配置

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

  • nginx

  • php-fpm 5.6

  • mysql 5.6

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

/www/laradock
 - .env

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

# /www/laradock

$ cp env-example .env

修改PHP版本

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

# /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 来确保链接。

# /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官方镜像包含哪些版本。具体如何选择得看各自的需求。

修改nginx配置

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

如需要修改端口可以进入.env文件找到 NGINX进行修改。
# /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

# 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

# C:\Windows\System32\drivers\etc\hosts

127.0.0.1   my-project.com

尝试运行

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

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

docker-compose up -d nginx mysql

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

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

运行laravel

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

那如何使用这些功能呢?

首先进入workspace容器

# /www/laradock
docker-compose exec workspace bash

composer换国内源

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

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

安装laravel

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

*注:需要提前把my-project里的所有内容清空
composer create-project laravel/laravel my-project2 "5.2.*" && \
cd my-project && \
php artisan key:generate

配置并重启nginx

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

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容器

# /www/laradock
docker-compose restart nginx

关于数据库服务

# .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能正常运行,目前只能以这种方式处理。


# .env
### NGINX

NGINX_HOST_HTTPS_PORT=1443

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

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

相关推荐:

Docker的Mysql主从复制详解

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

使用docker基于daocloud自动化部署到自己的主机

以上就是docker搭建laravel开发环境实例的详细内容,更多请关注Gxl网其它相关文章!

人气教程排行