安装

安装 Composer

Lumen 利用 Composer 来管理自身的依赖。因此,在使用 Lumen 之前,请务必确认是否在你的开发机上安装了 Composer。

安装 Lumen

通过 Lumen 安装器方式

首先,利用 Composer 下载 Lumen 安装器。

composer global require "laravel/lumen-installer=~1.0"

确保将 ~/.composer/vendor/bin 目录添加到 PATH 环境变量中,以便 lumen 可执行程序能够被操作系统正确加载。

安装之后,通过 lumen new 命令就能在你指定的目录中创建一个干净的 Lumen 应用程序骨架了。例如, lumen new service 将创建一个命名为 service 的目录,此目录中包含了全新安装的 Lumen 应用程序骨架以及相关的依赖包。这种安装方式比通过 Composer 安装更快速:

lumen new service

通过 Composer Create-Project 方式

你还可以通过 Composer 的 create-project 命令来安装 Lumen:

composer create-project laravel/lumen --prefer-dist

对服务器的要求

Lumen 框架对系统环境有以下几个要求:

配置

Lumen 几乎不需要任何配置就能开箱即用。你能立即开始你的编码工作了!

你可能需要为 Lumen 的几个附加组件做一些配置工作,例如:

目录权限

需要为 Lumen 配置几个目录的写权限: storage 目录下的所有文件夹都需要有写权限。

优雅链接

Apache

Lumen 框架通过 public/.htaccess 文件来让网址中不需要 index.php。如果你的网页服务器是使用 Apache 的话,请确认是否有开启 mod_rewrite 模块。

如果 Lumen 自带的 .htaccess 文件在所安装的 Apache 环境下无法正常使用的话,请尝试下面这个方法:

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

对于 Nginx,为你的网站增加如下配置就可以使用“优雅链接”了:

location / {
	try_files $uri $uri/ /index.php?$query_string;
}

当然,如果使用的是 Homestead,优雅链接已经被自动配置好了。