一. 准备开发环境

最近学习 laravel，发现MVC 的概念和 Asp.net 很类似。不想把本机的环境搞得混乱，找到了 laradock 的这个好东西。（P.S. 自从有了 docker，各种开发环境的搭建就变得非常简单了。）

按照 laradock.io 的说明，很容易就把开发环境搭建好了。第一部分简单记录下搭建步骤。

我的是 Mac 系统，打开终端，进入某个目录（e.g. /Users/<user>/）。然后clone laradock。

1. git clone https://github.com/Laradock/laradock.git

进入 laradock 目录（/Users/<user>/laradock/）。后面很多命令都需要在这里运行的。

2. cp env-example .env

然后打开.env 文件，修改 APPLICATION 的值，指向希望存放代码的目录，相对路径或绝对路径都可以（e.g. /Users/<user>/projects）

3. docker-compose up -d nginx mysql redis phpmyadmin

通过 docker-compose 来启动项目需要的模块（每个模块是单独的 docker 容器）。workspace和 php-fpm 会自动运行的，所以不需要指定。这里我需要运行 nginx, mysql, redis 以及 mysql 的管理工具。

如果在浏览器输入 http://localhost 会提示404。为了测试环境是否正确，可以在 APPLICATION 指定的目录（/Users//projects）下面创建 public子目录，里面放一个 index.php 文件，这样 http://localhost 就能访问到了。

不过我们想要 laravel 框架，所以需要进入 workspace 容器里面，创建基于 laravel 的工程。

4. docker-compose exec --user=laradock workspace bash

现在你会发现已经进入了 workspace 的容器了，并且用户是 laradock。当前的目录是/var/www。这个目录正好是 host 机器里面的/Users/<user>/projects 一个映射。现在可以创建项目了，输入命令

5. composer create-project laravel/laravel coolapp

这里的 coolapp 是项目的名字，可以随意指定。如果像我一样等了很久也没有反应的话。先通过 ctrl+c 结束命令。需要先设置国内的镜像。执行如下命令：

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

composer create-project laravel/laravel coolapp

输入 exit 退出 workspace容器，你会发现/Users/<user>/projects 下面多了一个 coolapp 的目录。还是在 laradock 目录里面，执行如下命令先停止容器。

6. docker-compose down

修改一下.env 里面APPLICATION 的值为/Users/<user>/projects/coolapp。然后可以再次启动

7. docker-compose up -d nginx mysql redis phpmyadmin

再浏览器里面输入 http://localhost 就能发现 Laravel 页面了。

二. 通过 PHPStorm 调试 PHP

以前用惯了 Visual Studio，发现能调试是一件很幸福的事。laradock 本身是支持 xdebug 的，需要修改一些配置。

1. 打开.env 文件，修改下面的值。

WORKSPACE_INSTALL_XDEBUG=true

PHP_FPM_INSTALL_XDEBUG=true

2. 修改Laradock/PHP-FPM/xdebug.ini 以及 Laradock/workspace/xdebug.ini文件，修改或添加如下的内容：

xdebug.remote_enable=1

xdebug.remote_host=docker.for.mac.localhost

xdebug.remote_port=9000

xdebug.remote_autostart=1

xdebug.remote_connect_back=0

xdebug.remote_handler=dbgp

xdebug.max_nesting_level=250

xdebug.remote_log=”/var/www/xdebug_logs/xdebug_docker.log”

需要说明的是，remote_host 设置的是 docker 容器所在主机的地址。我的 host 是 Mac，所以可以用 docker.for.mac.localhost。如果是 windows，需要用 docker 中可以访问的主机 ip 地址。

3. 接下来需要重新 build 容器

docker-compose build workspace php-fpm

我在 build 的时候遇到了如下的错误，不能下载 xdebug安装。

--->

Running in 2c241ea48d1f

No releases available for package

"pecl.php.net/xdebug"

install failed

ERROR: Service 'php-fpm'

failed to build: The command '/bin/sh -c if [ ${INSTALL_XDEBUG} = true ]; then pecl install

xdebug && docker-php-ext-enable xdebug ;fi' returned a non-zero code: 1

后来发现连上 VPN 就可以了成功 build 了。

4. 重启容器

docker-compose down && docker-compose up -d nginx mysql redis phpmyadmin

5. 打开 PHPStorm，进入Preferences->Language & Frameworks->PHP->Servers，新建一个 server，这里取名 php-fpm。

Host 里面填入 laradock。这是因为laradoc/.env 文件里面有一行设置了 serverName。

### Remote Interpreter ####################################

# Choose a Remote Interpreter entry matching name. Default is `laradock`

PHP_IDE_CONFIG=serverName=laradock

然后设置 host 机器里面的代码目录以及与server 的映射( /var/www)。

6. 配置 Run->Edit Configuration如下图。