Klein.php - 轻量级PHP路由库

只想简单的做个带几个路由的服务,用 php 框架就有点大题小作了 。Klein.php,这个轻量级的路由库,此时是一个不错的选择 。

Klein.php - 轻量级PHP路由库

文章插图
Klein.php
简介Klein.php,是 klein 组织在 Github 上开源的 PHP 路由库,代码仓库在
https://github.com/klein/klein.php,目前版本为 2.1.2 。Klein 十分灵活,使用正则表达式进行路由匹配;接口简单,方便快速上手开发;性能优秀,每秒可处理 2500+ 请求 。
Klein.php - 轻量级PHP路由库

文章插图
Klein.php
安装Klein 需要 PHP 5.3.x,使用 Composer 进行安装:
php composer.phar require klein/klein并在主 PHP 文件中加入 autoload:
require 'vendor/autoload.php';示例Klein 的使用十分简单,以下是一个 Hello World 例子:
<?phprequire_once __DIR__ . '/vendor/autoload.php';$klein = new KleinKlein();$klein->respond('GET', '/hello-world', function () {return 'Hello World!';});$klein->dispatch();使用 respond 注册路由处理方法,并使用 dispatch 运行路由 。
Klein 对于路由匹配使用可带命名参数的正则表达式进行,而解析得到的参数可以通过 $request 参数获得:
$klein->respond('/[:name]', function ($request) {return 'Hello ' . $request->name;});下面再看一些更加复杂的例子:
/posts/[*:title][i:id]// 匹配 /posts/this-is-a-title-123/output.[xml|json:format]?// 匹配 /output,/output.xml 和 /output.json/[:controller]?/[:action]?// 匹配可选的 /controller/action 格式也可以同时匹配多种请求方法,通过传递 array 实现:
$klein->respond(array('POST','GET'), $route, $callback);对于文件上传,klein 通过回调的 $service 参数接收;而对于发送文件,则可以使用 $response 的 send 或 file 实现:
$klein->respond(function ($request, $response, $service) {$service->xml = function ($object) {// 处理XML文件}$service->csv = function ($object) {// 处理CSV文件}});$klein->respond('/report.[xml|csv|json:format]?', function ($request, $response, $service) {$send = $request->param('format', 'json');$response->$send($report);// 通过send返回对象});$klein->respond('/report/latest', function ($request, $response, $service) {$response->file('/tmp/cached_report.zip');// 通过file返回文件路径的文件});更多
  • Klein 支持路由组,可以在同一路由下定义不同的子路由以形成不同的路由命名空间 。
$klein->with('/users', function () use ($klein) {$klein->respond('GET', '/?', function ($request, $response) {// 用户列表});$klein->respond('GET', '/[:id]', function ($request, $response) {// 获取单个用户});});
  • Klein 支持服务的惰性存储,可以在首次使用时才初始化 。
  • Klein 支持参数验证,可自定义验证方法 。
$service->validateParam('key')->isHex();$service->validate($username)->isLen(4,16);$service->validateParam('key', 'The key was invalid')->isHex()->isLen(32);
  • Klein 支持对 Phtml 的带参数渲染 。
$service->render('myview.phtml', array('title' => 'My View'));
Klein.php - 轻量级PHP路由库

文章插图
Klein.php
总结Klein.php 作为一个轻量的 PHP 路由库,具备了进行微型 Web 服务应用开发的能力;其基于正则的路由匹配方法自由灵活,方便使用;接口简洁明了,易于上手使用 。
Klein.php 项目结构清晰,代码注释和文档丰富,单元测试完备,同时代码量不大,代码质量较高,是一个值得学习的PHP库 。

【Klein.php - 轻量级PHP路由库】


    推荐阅读