Laradock 快速搭建PHP开发环境

可能你并不清楚 Docker 是什么，更不了解 Laradock是什么，送上语句自己特别喜欢的一句话 Use Docker First And Learn About It Later 大概意思就是 先去使用它，然后再去学习它，

要求

• Git
• Docker >= 1.12

附带一个安装参考教程腾讯云课堂地址，

安装

选择最适合您需要的设置。

• A) 单个项目的设置

  • A.1) 已经有一个 PHP 项目

    • A.2) 还没有 PHP 项目
• B) 多个项目的设置

A) 单个项目的设置

（如果您希望每个项目都有单独的Docker环境，请按照以下步骤操作）

A.1) 已经有一个 PHP 项目:

1 - 在项目根目录中克隆laradock:

```git submodule add https://github.com/Laradock/laradock.git
```

注意：如果您尚未将 Git 用于项目，则可以使用git clone而不是git submodule。

为了跟踪您的Laradock更改，您的项目之间，并保持Laradock更新检查这些文档

您的文件夹结构应如下所示：

+ project-a
  + laradock-a
+ project-b
  + laradock-b

（如果要为每个项目运行 laradock，重要的是将 laradock 文件夹重命名为每个项目中的唯一名称）。

现在跳到用法部分。

A.2) 还没有 PHP 项目：:

1 - 在您的计算机上的任何位置克隆此存储库：

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

您的文件夹结构应如下所示：

+ laradock
+ project-z

2 - 编辑Web服务器站点配置。

我们现在需要跳到用法章节的第1步，用于实现这一点。

cp env-example .env

在顶部，将 APPLICATION 变量更改为项目路径。

APPLICATION=../project-z/

确保替换 project-z 为项目文件夹名称。

现在跳转到 用法 章节。

B) 多个项目的设置：

（如果您想为所有项目使用单个Docker环境，请执行以下步骤）

1 - 在您的机器上的任何位置克隆此仓库 (类似于 上面A.2步骤):

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

您的文件夹结构应如下所示：

+ laradock
+ project-1
+ project-2

2 - 访问nginx/sites并创建配置文件，在访问不同的域时指向不同的项目目录。

Laradock 默认包含 app.conf.example，laravel.conf.example 并 symfony.conf.example 作为工作样本。

3 - 更改默认名称*.conf：

您可以随意重命名配置文件、项目文件夹和域，只需确保配置文件中的“根”指向正确的项目文件夹名称。

4 - 将域添加到 hosts 文件。

127.0.0.1  project-1.test
127.0.0.1  project-2.test
...

如果您使用的是Chrome 63或以上，请不要使用.dev。为什么?。相反，可以使用.localhost、.invalid、.test或.example。

现在跳转到用法 章节。

用法

开始之前:

如果您正在使用Docker Toolbox (VM)，请执行以下操作:

• 升级到 Docker 本机的 Mac/Windows (推荐)。查看升级 Laradock
• 使用Laradock v3.*。参观Laradock-ToolBox分支。(已过时，不推荐)

我们建议使用比1.13更新的 Docker 版本。

警告： 如果您使用旧版本的Laradock，强烈建议您重建需要使用的容器，了解如何重建容器以防止尽可能多的错误。

1 - 输入laradock文件夹并复制 env-example到 .env

```cp env-example .env
```

您可以编辑该.env文件以选择要在您的环境中安装的软件。您始终可以参考该docker-compose.yml文件以查看这些变量的使用方式。

根据主机的操作系统，您可能需要更改给定的值COMPOSE_FILE。在 Mac OS 上运行 Laradock 时，要使用的文件分隔符是正确的:。从 Windows 环境运行Laradock时，必须用多个文件分隔;。

默认情况下，将创建的容器具有当前目录名称作为后缀（例如laradock_workspace_1）。如果在多个项目中使用 laradock，这可能会导致容器卷内的数据混合。在这种情况下，请阅读多个项目的指南或将变量更改为COMPOSE_PROJECT_NAME与项目名称相同的唯一内容。

2 - 构建环境并使用它运行 docker-compose

在这个例子中，我们将看到如何运行NGINX（Web服务器）和MySQL（数据库引擎）来托管PHP Web脚本：

```docker-compose up -d nginx mysql
```

注意： 所有Web服务器容器nginx，apache..依赖于php-fpm，这意味着如果您运行其中任何一个，它们将自动php-fpm为您启动容器，因此无需在 up 命令中明确指定它。如果必须这样做，您可能需要按如下方式运行它们：docker-compose up -d nginx php-fpm mysql。

您可以从此列表中选择自己的容器组合。

请注意，有时我们忘记更新文档，因此请检查 docker-compose.yml 文件以查看所有可用容器的更新列表）。

3 - 进入Workspace容器，执行命令，如（Artisan，Composer，PHPUnit，Gulp，...）

```docker-compose exec workspace bash
```

或者，对于Windows PowerShell用户：执行以下命令以输入任何正在运行的容器：

```docker exec -it {workspace-container-id} bash
```

注意： 您可以添加--user=laradock以将文件创建为主机的用户。例：

```docker-compose exec --user=laradock workspace bash
```

您可以从.env文件中更改PUID（用户ID）和PGID（组ID）变量）

4 - 更新项目配置使其可以使用数据库

打开PHP项目的 .env 文件或您正在读取的任何配置文件，并将数据库主机 DB_HOST 设置为 mysql：

DB_HOST=mysql
```

如果要安装 Laravel框架作为PHP项目，请参阅如何在Docker容器中安装Laravel。
5 - 打开浏览器并访问您的本地主机地址http://localhost/。如果您按照多个项目设置，您可以访问http://project-1.test/和http://project-2.test/。
原文地址：https://segmentfault.com/a/1190000016042715