转载

Lumen 初体验

介绍

Lumen：“为速度而生的 Laravel 框架”。

Lumen 是 Laravel 的作者（Taylor Otwell）的又一力作。简单、快速、优雅的它的特点，适合用于构建微服务架构和 API 应用。

官网： http://lumen.laravel.com

介绍： https://phphub.org/topics/701

中文文档： http://lumen.laravel-china.org/docs

安装

使用 composer 安装：

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

配置

Lumen 默认使用 .env 作为配置文件。 .env.example 是官方给出的例子，直接拷贝命名为 .env 。

bashcd lumen cp .env.example .env

调试模式

修改 .env 文件：

bashAPP_DEBUG=true

如果发现还是没有效果，再修改 lumen/bootstrap/app.php 文件，将 Dotenv::load 的注释移除掉。

疑问

1.为什么提示：not be found

访问： http://127.0.0.1/lumen/public/

显示：

bashSorry, the page you are looking for could not be found.  NotFoundHttpException in Application.php line 1121:  in Application.php line 1121 at Application->handleDispatcherResponse(array('0')) in Application.php line 1091 at Application->dispatch(null) in Application.php line 1026 at Application->run() in index.php line 28

查看路由文件 lumen/app/Http/routes.php ：

php$app->get('/', function() use ($app) {     return $app->welcome(); });

感觉没有问题啊，和在 Laravel 中差不多的方式，那是哪里出了问题了？好的，先不管，尝试自己新定义一条路由规则试试看：

php$app->get('/test', function() use ($app) {     return $app->welcome(); });

再访问： http://127.0.0.1/lumen/public/test

结果和刚才一样。

2.为什么会跳转

再尝试访问一下： http://127.0.0.1/lumen/public/test/

结果跳转到： http://127.0.0.1/test

解惑

我先来解释一下第 2 个问题，因为这是一个很多 Laravel 新手也经常问的问题。

原因何在？请看 lumen/public/.htaccess 文件：

bashRewriteRule ^(.*)/$ /$1 [L,R=301]

这是一条 Apache 路由重写规则（mod_rewrite 开启的情况下才有效），当请求的 URI 带有 / ，就会匹配出 $1 ，永久重定向（HTTP 状态码是 301）到根目录下的 $1 。上面的例子中，匹配到 test（就是$1），就跳转至 /test 了。

如何来规避上面这个问题？注释这条 RewriteRule 吗？不是的。一般来说，我们应该避免使用末尾带斜杠的 URI。为什么 URI 末尾不应该带有斜杠呢？从语义是来说， test/ 表示目录， test 表示资源。还有，如果在 lumen/public 目录下真的有一个 test 目录，那么访问 http://127.0.0.1/lumen/public/test/ ，就会进入到 test 目录下面来，这不是我们想要的结果。（其实如果真的存在 test 目录并且不存在文件 test，那么，URI 末尾有没有斜杠都会进入到 test 目录中来，这是 Apache 决定的。因为它如果找不到文件，就会自动在末尾加个斜杠，尝试寻找目录下的 index.html 文件等等，具体是在 httpd.conf 中配置 DirectoryIndex。好吧，扯得太远了，拽回来）

总之，我还是建议 URI 末尾不要带 / ，如果你非不听，那就注释上面那句 RewriteRule 吧，这样就不会重定向了。

关于第 1 个问题，我们也来分析一下发生的原因，这样才能对症下药。

根据错误提示，定位到文件 lumen/vendor/laravel/lumen-framework/src/Application.php 中：

php /**   * Dispatch the incoming request.   *   * @param  SymfonyRequest|null  $request   * @return Response   */  public function dispatch($request = null)  {   if ($request) {    $this->instance('Illuminate/Http/Request', $request);    $this->ranServiceBinders['registerRequestBindings'] = true;    $method = $request->getMethod();    $pathInfo = $request->getPathInfo();   } else {    $method = $this->getMethod();    $pathInfo = $this->getPathInfo();   }     try {    if (isset($this->routes[$method.$pathInfo])) {     return $this->handleFoundRoute([true, $this->routes[$method.$pathInfo]['action'], []]);    }    return $this->handleDispatcherResponse(     $this->createDispatcher()->dispatch($method, $pathInfo)    );   } catch (Exception $e) {    return $this->sendExceptionToHandler($e);   }  }

匹配不到 route 的原因就在以上代码中。假设访问： http://127.0.0.1/lumen/public ，那么 :

phpvar_dump($method);  // string(3) "GET" var_dump($pathInfo);  // string(14) "/lumen/public/"

根据 lumen/app/Http/routes.php 中的定义，生成 $this->routes ：

phpvar_dump(array_keys($this->routes));  // array(2) { [0]=> string(4) "GET/" [1]=> string(8) "GET/test" }

由上可知， isset($this->routes[$method.$pathInfo]) 的结果就是 false ，所以提示 not be found 了。

既然已经知道了原因，那问题就好解决了。解决的前提是 不要改动框架的源代码 ，不然日后升级框架会多么蛋疼，你都把框架代码都修改，万一出了问题你咋办？你自己拆手机，官方是不保修的哦！当然，如果你是框架开发组的，你提交代码能被大家接受并被官方合并到主干代码中了，那你就改吧。

方案1：修改 DocumentRoot

修改 Apache 的配置文件 httpd.conf ，将 DocumentRoot 指向 lumen/public ：

bashDocumentRoot "/sites/lumen/public"

重启 Apache。

但是，如果我还有其他站点也在这个 Apache 下面，改 DocumentRoot 就会导致其他的站点不能访问了。怎么办？请看 方案 2 。

方案2：配置 Apache 虚拟主机

修改 httpd.conf ，将下面这行的注释移除：

bashInclude etc/extra/httpd-vhosts.conf

修改 httpd-vhosts.conf ：

bash<VirtualHost *:80>  DocumentRoot "/sites"  ServerName 127.0.0.1 </VirtualHost> <VirtualHost *:80>  DocumentRoot "/sites/lumen/public"  ServerName lumen.app </VirtualHost>

重启 Apache。

修改主机的 etc/hosts ，添加一行：

bash127.0.0.1 lumen.app

其中 127.0.0.1 应该换成你 lumen 应用存放的机器的 ip。

OK，这样就可以通过访问 http://lumen.app 来访问该 lumen 站点，通过 http://127.0.0.1 来访问其他站点。

但是，你压根不能修改 Apache 的配置，怎么办？请看 方案 3 。

方案3.修改路由规则中的路径

改不了配置，就改代码喽（再强调一下，不是修改框架的源代码）。

修改路由文件 lumen/app/Http/routes.php ：

phpdefine('ROUTE_BASE', 'lumen/public/')；  $app->get(ROUTE_BASE . '/index', function() use ($app) {     return $app->welcome(); }); $app->get(ROUTE_BASE . '/test', function() use ($app) {     return $app->welcome(); });

这样，如果以后有变化的话，你只需要修改 define('ROUTE_BASE', 'lumen/public/')； 就可以了（当然，把这个写到应用配置项中是最合适的，部署时修改配置就可以了）。

至于想以 'lumen/public/' 作为首页 URI 显然是不可以的，建议使用 'lumen/pulbic/index' 作为首页。如同上面代码定义的路由规则那样。

因为，无论你在路由规则的字符串末尾加了多少个斜杠， $this->routes 的键是不会带有斜杠的，最终还是不能匹配的。原因在框架源代码中 lumen/vendor/laravel/lumen-framework/src/Application.php ：

php    /**  * Add a route to the collection.  *  * @param  string  $method  * @param  string  $uri  * @param  mixed  $action  */     protected function addRoute($method, $uri, $action)     {     $action = $this->parseAction($action);     $uri = $uri === '/' ? $uri : '/'.trim($uri, '/');     if (isset($action['as'])) {     $this->namedRoutes[$action['as']] = $uri;     }     if (isset($this->groupAttributes)) {     if (isset($this->groupAttributes['prefix'])) {     $uri = rtrim('/'.trim($this->groupAttributes['prefix'], '/').$uri, '/');     }     $action = $this->mergeGroupAttributes($action);     }     $this->routes[$method.$uri] = ['method' => $method, 'uri' => $uri, 'action' => $action];     }

对，就是它： $uri = $uri === '/' ? $uri : '/'.trim($uri, '/'); 。

所有，URI 末尾还是不带斜杠的好。

正文到此结束