laradock/README-zh.md

23 KiB
Raw Blame History

LaraDock

forthebadge

Gitter

LaraDock能够帮你在Docker上快速搭建Laravel应用。
就像Laravel Homestead一样但是Docker替换了Vagrant。

先在Docker上使用LaraDock然后再学习它们。


## 目录

介绍

LaraDock努力简化创建开发环境过程。 它包含预包装Docker镜像提供你一个美妙的开发环境而不需要安装PHP,NGINX,MySQL和其他任何软件在你本地机器上。

使用概览:

让我们了解使用它安装NGINX, PHP, Composer, MySQLRedis,然后运行Laravel

  1. 将LaraDock放到你的Laravel项目中
    git clone https://github.com/LaraDock/laradock.git.
  2. 进入LaraDock目录然后运行这些容器。
    docker-compose up -d nginx mysql redis
  3. 打开你的.env文件,然后设置mysqlDB_HOSTredisREDIS_HOST
  4. 打开浏览器访问localhost

特点

  • 在PHP版本7.05.6.5.5...之中可以简单切换。
  • 可选择你最喜欢的数据库引擎比如MySQL, Postgres, MariaDB...
  • 可运行自己的软件组合比如Memcached, HHVM, Beanstalkd...
  • 所有软件运行在不同的容器之中比如PHP-FPM, NGINX, PHP-CLI...
  • 通过简单的编写dockerfile容易定制任何容器。
  • 所有镜像继承自一个官方基础镜像Trusted base Images
  • 可预配置Laravel的Nginx环境
  • 容易应用容器中的配置
  • 干净的结构化的Docker配置文件dockerfile
  • 最新的Docker Compose 版本(docker-compose
  • 所有的都是可视化和可编辑的
  • 快速的镜像构建
  • 每周都会有更新...

支持的软件 (容器)

  • 数据库引擎:
    • MySQL
    • PostgreSQL
    • MariaDB
    • MongoDB
    • Neo4j
  • 缓存引擎:
    • Redis
    • Memcached
  • PHP 服务器:
    • NGINX
    • Apache2
    • Caddy
  • PHP 编译工具:
    • PHP-FPM
    • HHVM
  • 消息队列系统:
    • Beanstalkd (+ Beanstalkd Console)
  • 工具:
    • Workspace (PHP7-CLI, Composer, Git, Node, Gulp, SQLite, Vim, Nano, cURL...)

如果你找不到你需要的软件,构建它然后把它添加到这个列表。你的贡献是受欢迎的。

Docker是什么?

Docker 是一个开源项目,自动化部署应用程序软件的容器,在Linux, Mac OS and Windows提供一个额外的抽象层和自动化的操作系统级的虚拟化

Laravel是什么?

额,这很认真的!!!

为什么使用Docker而不是Vagrant!?

Vagrant构建虚拟机需要几分钟然而Docker构建虚拟容器只需要几秒钟。 而不是提供一个完整的虚拟机,就像你用Vagrant,Docker为您提供轻量级虚拟容器,共享相同的内核和允许安全执行独立的进程。

除了速度,Docker提供大量的Vagrant无法实现的功能。

最重要的是Docker可以运行在开发和生产(相同环境无处不在)。Vagrant是专为开发,(所以在生产环境你必须每一次重建您的服务器)。

LaraDock Homestead 对比

LaraDock and Homestead 给你一个完整的虚拟开发环境。(不需要安装和配置软件在你自己的每一个操作系统)。

Homestead 是一个工具,为你控制虚拟机(使用Homestead特殊命令)。Vagrant可以管理你的管理虚容器。

运行一个虚拟容器比运行一整个虚拟机快多了LaraDock 比 Homestead快多了

演示视频

还有什么比演示视频好:

  • LaraDock v4.0 (即将到来的...)
  • LaraDock v2.2
  • LaraDock v0.3
  • LaraDock v0.1

依赖

安装

1 - 克隆 LaraDock 仓库:

A) 如果你已经有一个Laravel项目,克隆这个仓库在到Laravel根目录

git submodule add https://github.com/LaraDock/laradock.git

如果你不是使用Git管理Laravel项目,您可以使用 git clone 而不是git submodule

B) 如果你没有一个Laravel项目,你想Docker安装Laravel,克隆这个源在您的机器任何地方上:

git clone https://github.com/LaraDock/laradock.git

使用

请在开始之前阅读: 如果你正在使用Docker Toolbox (VM),选择以下任何一个方法:

  • 更新到Docker Native Mac/Windows版本 (建议). 查看 Upgrading Laradock
  • 使用 LaraDock v3.* (访问 LaraDock-ToolBox 分支). 如果您使用的是Docker Native(Mac / Windows版本)甚至是Linux版本,通常可以继续阅读这个文档LaraDock v4以上版本将仅支持Docker Native


1 - 运行容器: *(在运行`docker-compose`命令之前,确认你在 `laradock` 目录中*

例子: 运行 NGINX 和 MySQL:

docker-compose up -d  nginx mysql

你可以从以下列表选择你自己的容器组合:

nginx, hhvm, php-fpm, mysql, redis, postgres, mariadb, neo4j, mongo, apache2, caddy, memcached, beanstalkd, beanstalkd-console, workspace.

说明: workspacephp-fpm 将运行在大部分实例中, 所以不需要在 up 命令中加上它们.


2 - 进入 Workspace 容器, 执行像 (Artisan, Composer, PHPUnit, Gulp, ...)等命令
docker-compose exec workspace bash

增加 `--user=laradock` (例如 `docker-compose exec --user=laradock workspace bash`) 作为您的主机的用户创建的文件. (你可以从 `docker-compose.yml`修改 PUID (User id) 和 PGID (group id) 值 ).
3 - 编辑 Laravel 的配置.

如果你还没有安装Laravel项目请查看 How to Install Laravel in a Docker Container.

打开 Laravel的 .env 文件 然后 配置 你的mysqlDB_HOST:

DB_HOST=mysql

4 - 打开浏览器访问localhost (`http://localhost/`).
**调试**: 如果你碰到任何问题,请查看 [调试](#debugging) 章节 如果你需要特别支持,请联系我,更多细节在[帮助 & 问题](#Help)章节
## 文档

[Docker]

列出正在运行的容器

docker ps

你也可以使用以下命令查看某项目的容器

docker-compose ps

### 关闭所有容器 ```bash docker-compose stop ```

停止某个容器:

docker-compose stop {容器名称}

### 删除所有容器 ```bash docker-compose down ```

小心这个命令,因为它也会删除你的数据容器。(如果你想保留你的数据你应该在上述命令后列出容器名称删除每个容器本身):*


### 进入容器 (通过SSH 进入一个运行中的容器)

1 - 首先使用 docker ps命令查看正在运行的容器

2 - 进入某个容器使用:

docker-compose exec {container-name} bash

例如: 进入 MySQL 容器

docker-compose exec mysql bash

3 - 退出容器, 键入 exit.


### 编辑默认容器配置 打开 `docker-compose.yml` 然后 按照你想的修改.

例如:

修改 MySQL 数据库名称:

  environment:
    MYSQL_DATABASE: laradock

修改 Redis 默认端口为 1111:

  ports:
    - "1111:6379"

### 编辑Docker镜像

1 - 找到你想修改的镜像的 dockerfile ,
例如: mysqlmysql/Dockerfile.

2 - 按你所要的编辑文件.

3 - 重新构建容器:

docker-compose build mysql

更多信息在容器重建中 点击这里.


### 建立/重建容器

如果你做任何改变dockerfile确保你运行这个命令,可以让所有修改更改生效:

docker-compose build

选择你可以指定哪个容器重建(而不是重建所有的容器):

docker-compose build {container-name}

如果你想重建整个容器,你可能需要使用 --no-cache 选项 (docker-compose build --no-cache {container-name}).


### 增加更多软件 (Docker 镜像)

为了增加镜像(软件), 编辑 docker-compose.yml 添加容器细节, 你需要熟悉 docker compose 文件语法.


### 查看日志文件 Nginx的日志在 `logs/nginx` 目录

然后查看其它容器日志(MySQL, PHP-FPM,...) 你可以运行:

docker logs {container-name}

### [Laravel]

从Docker镜像安装Laravel

1 - 首先你需要进入 Workspace 容器.

2 - 安装 Laravel.

例如 使用 Composer

composer create-project laravel/laravel my-cool-app "5.2.*"

我们建议使用 composer create-project 替换Laravel 安装器去安装Laravel.

关于更多Laravel安装内容请 点击这儿.

3 - 编辑 docker-compose.yml 映射新的应用目录: 系统默认LaraDock假定Laravel应用在LaraDock的父级目录中 By default LaraDock assumes the Laravel application is living in the parent directory of the laradock folder.

自新Laravel应用在 my-cool-app 目录中, 我们需要用 ../my-cool-app/:/var/www/laravel替换 ../:/var/www/laravel , 如下:

    application:
        build: ./application
        volumes:
            - ../my-cool-app/:/var/www/laravel

4 - 进入目录下继续工作..

cd my-cool-app

5 - 回到LaraDock安装步骤,看看如何编辑env的文件。


### 运行 Artisan 命令 你可以从Workspace容器运行artisan命令和其他终端命令

1 - 确认Workspace容器已经运行.

docker-compose up -d workspace // ..and all your other containers

2 - 找到Workspace容器名称:

docker-compose ps

3 - 进入Workspace容器:

docker-compose exec workspace bash

增加 --user=laradock (例如 docker-compose exec --user=laradock workspace bash) 作为您的主机的用户创建的文件.

4 - 运行任何你想的 :)

php artisan
Composer update
phpunit

### 使用 Redis 1 - 首先务必用 `docker-compose up` 命令运行 (`redis`)容器.
docker-compose up -d redis

2 - 打开你的Laravel的 .env 文件 然后 配置redisREDIS_HOST

REDIS_HOST=redis

如果在你的.env 文件没有找到REDIS_HOST变量。打开数据库配置文件config/database.php然后用redis替换默认IP127.0.0.1,例如:

'redis' => [
    'cluster' => false,
    'default' => [
        'host'     => 'redis',
        'port'     => 6379,
        'database' => 0,
    ],
],

3 - 启用Redis缓存或者开启Session管理也在.env文件中用redis替换默认file设置CACHE_DRIVERSESSION_DRIVER

CACHE_DRIVER=redis
SESSION_DRIVER=redis

4 - 最好务必通过Compose安装 predis/predis(~1.0):

composer require predis/predis:^1.0

5 - 你可以用以下代码在Laravel中手动测试

\Cache::store('redis')->put('LaraDock', 'Awesome', 10);

### 使用 Mongo

1 - 首先在Workspace和PHP-FPM容器中安装mongo:
a) 打开 docker-compose.yml 文件
b) 在Workspace容器中找到INSTALL_MONGO选项:


c) 设置为 `true`
d) 在PHP-FPM容器中找到`INSTALL_MONGO`
e) 设置为 `true`

相关配置项如下:

    workspace:
        build:
            context: ./workspace
            args:
                - INSTALL_MONGO=true
    ...
    php-fpm:
        build:
            context: ./php-fpm
            args:
                - INSTALL_MONGO=true
    ...

2 - 重建Workspace、PHP-FPM容器 docker-compose build workspace php-fpm

3 - 使用docker-compose up 命令运行MongoDB容器 (mongo)

docker-compose up -d mongo

4 - 在config/database.php 文件添加MongoDB的配置项:

'connections' => [

    'mongodb' => [
        'driver'   => 'mongodb',
        'host'     => env('DB_HOST', 'localhost'),
        'port'     => env('DB_PORT', 27017),
        'database' => env('DB_DATABASE', 'database'),
        'username' => '',
        'password' => '',
        'options'  => [
            'database' => '',
        ]
    ],

	// ...

],

5 - 打开Laravel的 .env 文件 然后 更新以下字段:

  • 设置 DB_HOSTmongo的主机IP.
  • 设置 DB_PORT27017.
  • 设置 DB_DATABASEdatabase.

6 - 最后务必通过Composer安装jenssegers/mongodb添加服务提供者Laravel Service Provider

composer require jenssegers/mongodb

更多细节内容 点击这儿.

7 - 测试:

  • 首先让你的模型继承Mongo的Eloquent Model. 查看 文档.
  • 进入Workspace容器.
  • 迁移数据库 php artisan migrate.

### [PHP]

安装PHP拓展

安装PHP扩展之前,你必须决定你是否需要FPMCLI,因为他们安装在不同的容器上,如果你需要两者,则必须编辑两个容器。

PHP-FPM拓展务必安装在 php-fpm/Dockerfile-XX. (用你PHP版本号替换 XX).
PHP-CLI拓展应该安装到workspace/Dockerfile.


### 修改PHP-FPM版本 默认运行**PHP-FPM 7.0**版本.

PHP-FPM负责服务你的应用代码,如果你是计划运行您的应用程序在不同PHP-FPM版本上则不需要更改PHP-CLI版本。

A) 切换版本 PHP 7.0 到 PHP 5.6

1 - 打开 docker-compose.yml

2 - 在PHP容器的 Dockerfile-70文件。

3 - 修改版本号, 用Dockerfile-56替换 Dockerfile-70 , 例如:

php-fpm:
    build:
        context: ./php-fpm
        dockerfile: Dockerfile-70

4 - 最后重建PHP容器

docker-compose build php

更多关于PHP基础镜像, 请访问 PHP Docker官方镜像.

B) 切换版本 PHP 7.05.6 到 PHP 5.5

我们已不在本地支持PHP5.5,但是你按照以下步骤获取:

1 - 克隆 https://github.com/LaraDock/php-fpm.

3 - 重命名 Dockerfile-56Dockerfile-55.

3 - 编辑文件 FROM php:5.6-fpmFROM php:5.5-fpm.

4 - 从 Dockerfile-55构建镜像.

5 - 打开 docker-compose.yml 文件.

6 - 将 php-fpm 指向你的 Dockerfile-55 文件.


### 修改 PHP-CLI 版本 默认运行**PHP-CLI 7.0**版本

说明: PHP-CLI只用于执行Artisan和Composer命令不服务于你的应用代码这是PHP-FPM的工作所以编辑PHP-CLI的版本不是很重要。 PHP-CLI安装在Workspace容器改变PHP-CLI版本你需要编辑workspace/Dockerfile. 现在你必须手动修改PHP-FPM的Dockerfile或者创建一个新的。 (可以考虑贡献功能).


### 安装 xDebug

1 - 首先在Workspace和PHP-FPM容器安装 xDebug:
a) 打开 docker-compose.yml 文件
b) 在Workspace容器中找到 INSTALL_XDEBUG 选项
c) 改为 true
d) 在PHP-FPM容器中找到 INSTALL_XDEBUG 选项
e) 改为 true

例如:

    workspace:
        build:
            context: ./workspace
            args:
                - INSTALL_XDEBUG=true
    ...
    php-fpm:
        build:
            context: ./php-fpm
            args:
                - INSTALL_XDEBUG=true
    ...

2 - 重建容器 docker-compose build workspace php-fpm


### [Misc]
### 使用自定义域名 (替换Docker的IP)

假定你的自定义域名是 laravel.dev

1 - 打开 /etc/hosts 文件 添加以下内容映射你的localhost 地址 127.0.0.1laravel.dev 域名

127.0.0.1    laravel.dev

2 - 打开你的浏览器访问 {http://laravel.dev}

你可以在nginx配置文件自定义服务器名称,如下:

server_name laravel.dev;

### 安装全局Composer命令

为启用全局Composer Install在容器构建中允许你安装composer的依赖然后构建完成后就是可用的。

1 - 打开 docker-compose.yml 文件

2 - 在Workspace容器找到 COMPOSER_GLOBAL_INSTALL 选项并设置为 true

例如:

    workspace:
        build:
            context: ./workspace
            args:
                - COMPOSER_GLOBAL_INSTALL=true
    ...

3 - 现在特价你的依赖关系到 workspace/composer.json

4 - 重建Workspace容器 docker-compose build workspace


### 安装 Prestissimo

Prestissimo 是一个平行安装功能的composer插件。 1 - 在安装期间使全局Composer Install 正在运行:

点击这个 启用全局Composer构建安装 然后继续步骤1、2.

2 - 添加 prestissimo 依赖到 Composer:

a - 现在打开 workspace/composer.json 文件

b - 添加 "hirak/prestissimo": "^0.3" 依赖

c - 重建Workspace容器 docker-compose build workspace


### 安装 Node + NVM

在Workspace 容器安装 NVM 和 NodeJS 1 - 打开 docker-compose.yml 文件

2 - 在Workspace容器找到 INSTALL_NODE 选项设为 true

例如:

    workspace:
        build:
            context: ./workspace
            args:
                - INSTALL_NODE=true
    ...

3 - 重建容器 docker-compose build workspace


### Debugging

这里是你可能面临的常见问题列表,以及可能的解决方案.

看到空白页而不是Laravel的欢迎页面!

在Laravel根目录运行下列命令:

sudo chmod -R 777 storage bootstrap/cache

看到 "Welcome to nginx" 而不是 Laravel 应用!

在浏览器使用 http://127.0.0.1 替换 http://localhost.

看到包含 address already in use 的错误

确保你想运行的服务端口(80, 3306, etc.)不是已经被其他程序使用,例如apache/httpd服务或其他安装的开发工具


### LaraDock 升级

从Docker Toolbox (VirtualBox)移动到Docker Native (for Mac/Windows),需要从 LaraDock v3.* 升级到 v4.*:

  1. 停止Docker虚拟机 docker-machine stop {default}
  2. 安装 Docker MacWindows.
  3. 升级 LaraDock 到 v4.*.* (git pull origin master)
  4. 像之前一样使用LaraDock: docker-compose up -d nginx mysql.

说明: 如果你面临任何上面的问题的最后一步:重建你所有的容器 docker-compose build --no-cache "警告:容器数据可能会丢失!"


## 贡献 这个小项目是由一个有一个全职工作和很多的职责的人建立的,所以如果你喜欢这个项目,并且发现它需要一个bug修复或支持或新软件或升级任何容器,或其他任何. . 你是非常欢迎,欢迎毫不不犹豫地贡献吧:)

阅读我们的 贡献说明

帮助 & 问题

从聊天室 Gitter 社区获取帮助和支持.

你也可以打开Github上的 issue (将被贴上问题和答案) 或与大家讨论 Gitter.

Docker或Laravel的特别帮助你可以在Codementor.io上直接和项目创始人在线沟通

关于作者

创始人:

主要 贡献者:

优秀的人:

许可证

MIT License (MIT)