Minor【 PHP框架】3.路由、控制器、视图
框架Github地址:github.com/Orlion/Minor
(如果觉得还不错给个star哦(^-^)V)
框架作者: Orlion
知乎:https://www.zhihu.com/people/orlion
Github: https://github.com/Orlion
漂亮的URL绝对是一个严肃的web应用程序必须做到的,这种方式使index.php?article_id=57这类的丑陋URL被隐藏,由更受欢迎的像 /read/intro-to-symfony 来替代。
配置文件为app/Config/routes.php
<?php return [ '/demo/{productName}' => [ 'name' => 'test1', 'controller' => 'App\Modules\Demo\Controller\FooController', 'action' => 'bar', 'required' => ['productName' => '\w+'], ], ];
以上边代码为例详述一下如何配置一个优雅(laravel病上身...)的路由
'/demo/{productName}'是路由的匹配规则,其中配置中的required制定的就是productName必须满足的正则条件,在框架的实际运行过程中会将路由规则+required解析为正则表达式/demo/(\w+) ,当url(eg: xxx.xxx.xxx/demo/testproduct)匹配到这条正则时就会执行配置中的controller的action,具体的执行为:FooController->bar($productName);
可以看到路由规则中的大括号的内容(productName)就是就是bar这个方法的参数。所以在匹配路由时一定要注意路由规则必须与具体的控制器的方法的参数个数是一致的,不然就会抛出ControllerException。
如果我们每定义一个Controller就要配置一个路由就会导致开发效率较低,为了防止这种问题发生Minor提供了默认路由机制。当我们访问http://xxx.xxx.xxx/demo/foo/bar时就会执行App\Modules\Demo\FooController的bar方法,即默认路由为:
http://xxx.xxx.xxx/{模块名}/{控制器名}/{方法名}
正如你所见,Minor的路由并不强大。不支持请求方法的限制,不支持htttps限制,不支持过滤器。
Controller的定义非常简单,只要继承Minor\Controller\Controller基础类就可以了(当然你也可以不继承,但是基类中的方法和属性就不能使用了,这很好理解),首先创建文件夹app/Modules/Demo/Controller/,然后再创建文件FooController.php:
<?php namespace App\Modules\Demo\Controller; use Minor\Controller\Controller; // 定义一个控制器 class FooController extends Controller { // 定义一个方法 public function bar() { return 'Hello World'; } }
通过访问xxx.xxx.xxx/demo/foo/bar(默认路由,你也可以配置自己的路由)就可看到返回了Hello World。
调用Url的gen方法可以将默认路径转为符合路由规则的url
$url = Url:gen($path);
如根据3.1.1中的路由配置Url::gen('/demo/foo/bar?productName=test') 将返回 /demo/test。
Minor提供了三个跳转的方法分别是redirect、forward、forwardUrl(这三个都是Minor\Controller\Controller的protected方法)。
当跳转到另外一个url时可以在控制器这样调用:$this->redirect($url);
当转向(froward)到另外一个url时可以在控制器中这样调用: $this->forwardUrl($url);(该方法的实现其实就是通过路由解析出url请求的控制器和方法然后调用forward($controller, $action, $param))
当转向(forward)到另外一个方法时可以在控制器中这样调用: $this->forward($controller, $action, $params); (参数$controller是控制器的类名,包含命名空间)
例:
class FooController extends Controller { public function bar() { $this->redirect('www.baidu.com'); return $this->forward('App\Modules\Demo\Controller\FooController', 'bar', 'test'); return $this->forward('/demo/testpro'); } }
调用MinorRequest的get($paramName, $defaultParamValue = null) 或者 post($paramName, $defaultParamValue = null)方法就可以获取请求方法,在控制器中可以这样调用:
class FooController extends Controller { public function bar() { $minorRequest = $this->app->getMinorRequest();
$paramValue = $minorRequest->get('paramKey', 'defaultValue');
... } }
调用MinorRequest的getMethod()方法就可以获取请求的方法:
class FooController extends Controller { public function bar() { $minorRequest = $this->app->getMinorRequest(); $method = $minorRequest->getMethod(); ... } }
Minor提供了一个极其强大的模板引擎,这个模板引擎的名称就是: PHP。是的!你没看错就是PHP。为什么Minor不提供一个类似于smarty或者Twig这样的模板引擎呢? 因为没有必要,PHP本身已经足够好了,如果Minor再造一个模板引擎无疑就会使Minor更难上手,所以Minor直接使用PHP作为视图文件的语言。
在控制器中使用视图只需要调用View::render('模块名:控制器名:视图文件名', ['param1key' => 'param1value', 'param2key' => 'param2value' ...]);例:
class FooController extends Controller { public function bar() { $param1 = 'Hello'; $param2 = 'World'; return View::render('Demo:Foo:bar.php', ['param1' => $param1, 'param2' => $param2]); } }
render函数的第二个参数(['param1key' => 'param1value', 'param2key' => 'param2value' ...])就是向视图文件中传递的变量,我们可以在视图文件中使用这些变量:
文件:app/Modules/Demo/Controller/Tpl/Foo/bar.php
<?php echo $param1key;?>
<?=$param2key ?>
Minor提供了两个视图文件中可以使用的函数:
function include_tpl($module, $controller, $tpl) { require_once (!defined('APP_DIR') ? APP_DIR : realpath(__DIR__ . '/../../app/') .DIRECTORY_SEPARATOR) . 'Modules' . '/' . $module . '/Tpl/' . $controller . '/' . $tpl; } function url($path) { return Url::gen($path); }
使用:
html> <?php include_tpl('Public', 'Public', 'header.php');?> <body> <h1>Hello!</h1> <a href="<?php url('/demo/foo/bar?productName=testpro');?>"> </body> </html>
这两个函数定义在app/Resource/functions.php文件中,你可以在这个文件中自定义你需要的视图函数。
可以在控制器中通过调用App对象的getMinorResponse()方法来获取当前MinorResponse对象。 MinorResponse类提供了六个方法分别是:
public function send(); // 用于将响应对象发送给客户端
public function setHeader($header);// 设置响应头
public function setContent($content); // 设置响应对象的内容
public function beforeContent($content); // 在当前已有的内容之前添加内容
public function appendContent($content); // 在当前已有内容之后追加内容
public function getContent(); // 获取对象中的响应内容