配置

介绍

与 Laravel 不同的是, Lumen 只使用单一的 .env 配置文件, 你阅读下 .env.example 文件, 看下有哪些选项需要配置.

注意: 如果你想要使用 vlucas/phpdotenv 库来加载你的环境变量, 请把 bootstrap/app.php 文件里面的 Dotenv::load 这个调用去掉注释.

安装后的配置

Lumen 基本上不需要配置, 但是, 安装后的第一件事情是在 .env 文件里面设置你的 APP_KEY, 此值应该为随机的 32 位字符串.

你可以查看其他的文档, 如下:

注意: 请注意千万不要在生产环境下把 APP_DEBUG 选项设置为 true。

权限

Lumen 框架有一个目录需要额外配置权限: storage 和 bootstrap/cache 目录要让服务器有写入的权限。

配置文件

默认情况下, Lumen 使用单一的 .env 文件来配置你的应用, 然而, 你也可以使用 Laravel 风格 的配置方法。只需要把 vendor/laravel/lumen-framework/config 文件夹下对应的配置文件复制到根目录下的 config 文件夹里面就行.

使用这种方法, 能有更多的配置灵活度.

自定义配置文件

你可以创建自定义的配置文件, 并使用 $app->configure() 方法进行加载.

举个栗子, 把自定义配置文件放置于 config/options.php, 可以这样加载:

  1. $app->configure('options');

优雅链接

Apache

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

假设 Lumen 附带的 .htaccess 文件在 Apache 无法生效的话，请尝试下面的方法：

  1. Options +FollowSymLinks
  2. RewriteEngine On
  4. RewriteCond %{REQUEST_FILENAME} !-d
  5. RewriteCond %{REQUEST_FILENAME} !-f
  6. RewriteRule ^ index.php [L]

Nginx

Nginx 上，在配置中增加下面的配置，就可以使用「优雅链接」了: 

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

当然，如果你使用 Homestead 的话，优雅链接会自动的帮你配置完成。