Minor【 PHP框架】3.路由、控制器、視圖，minor框架

3.1 路由

　　漂亮的URL絕對是一個嚴(yán)肅的web應(yīng)用程序必須做到的，這種方式使index.php?article_id=57這類的丑陋URL被隱藏，由更受歡迎的像 /read/intro-to-symfony 來替代。

　　3.1.1 路由配置

　　配置文件為app/Config/routes.php

<?<span>php
</span><span>return</span><span> [
　　</span>'/demo/{productName}'            =><span>  [
        </span>'name'                =>    'test1',
        'controller'        =>    'App\Modules\Demo\Controller\FooController',
        'action'            =>    'bar',
        'required'          =>  ['productName' => '\w+'],<span>
    ]</span>,<span>
];</span>

　　以上邊代碼為例詳述一下如何配置一個優(yōu)雅(laravel病上身...)的路由

　　'/demo/{productName}'是路由的匹配規(guī)則，其中配置中的required制定的就是productName必須滿足的正則條件，在框架的實(shí)際運(yùn)行過程中會將路由規(guī)則+required解析為正則表達(dá)式/demo/(\w+) ,當(dāng)url（eg: xxx.xxx.xxx/demo/testproduct）匹配到這條正則時(shí)就會執(zhí)行配置中的controller的action，具體的執(zhí)行為:FooController->bar($productName);

　　可以看到路由規(guī)則中的大括號的內(nèi)容(productName)就是就是bar這個方法的參數(shù)。所以在匹配路由時(shí)一定要注意路由規(guī)則必須與具體的控制器的方法的參數(shù)個數(shù)是一致的，不然就會拋出ControllerException。

　　3.1.2 默認(rèn)路由配置

　 如果我們每定義一個Controller就要配置一個路由就會導(dǎo)致開發(fā)效率較低，為了防止這種問題發(fā)生Minor提供了默認(rèn)路由機(jī)制。當(dāng)我們訪問http://xxx.xxx.xxx/demo/foo/bar時(shí)就會執(zhí)行App\Modules\Demo\FooController的bar方法，即默認(rèn)路由為：

　　http://xxx.xxx.xxx/{模塊名}/{控制器名}/{方法名}

　　3.1.3 缺點(diǎn)

　　正如你所見，Minor的路由并不強(qiáng)大。不支持請求方法的限制，不支持htttps限制，不支持過濾器。

3.2 控制器

　　3.2.1 創(chuàng)建一個自己的控制器

　　Controller的定義非常簡單，只要繼承Minor\Controller\Controller基礎(chǔ)類就可以了（當(dāng)然你也可以不繼承，但是基類中的方法和屬性就不能使用了，這很好理解），首先創(chuàng)建文件夾app/Modules/Demo/Controller/，然后再創(chuàng)建文件FooController.php:

<?<span>php
namespace App\Modules\Demo\Controller;

</span><span>use</span><span> Minor\Controller\Controller;
</span><span>//</span><span> 定義一個控制器</span>
<span>class</span> FooController <span>extends</span><span> Controller
{
    </span><span>//</span><span> 定義一個方法   </span>
    <span>public</span> <span>function</span><span> bar()
    {
        </span><span>return</span> 'Hello World'<span>;
    }
}</span>

　　通過訪問xxx.xxx.xxx/demo/foo/bar(默認(rèn)路由，你也可以配置自己的路由)就可看到返回了Hello World。

　　3.2.2 Url生成

　　調(diào)用Url的gen方法可以將默認(rèn)路徑轉(zhuǎn)為符合路由規(guī)則的url

<span>$url</span> = Url:gen(<span>$path</span>);

　　如根據(jù)3.1.1中的路由配置Url::gen('/demo/foo/bar?productName=test') 將返回 /demo/test。

　　3.2.3 頁面跳轉(zhuǎn)redirect、重定向forward

　　Minor提供了三個跳轉(zhuǎn)的方法分別是redirect、forward、forwardUrl(這三個都是Minor\Controller\Controller的protected方法)。

　　當(dāng)跳轉(zhuǎn)到另外一個url時(shí)可以在控制器這樣調(diào)用：$this->redirect($url);

　　當(dāng)轉(zhuǎn)向(froward)到另外一個url時(shí)可以在控制器中這樣調(diào)用: $this->forwardUrl($url);（該方法的實(shí)現(xiàn)其實(shí)就是通過路由解析出url請求的控制器和方法然后調(diào)用forward($controller, $action, $param)）

　　當(dāng)轉(zhuǎn)向(forward)到另外一個方法時(shí)可以在控制器中這樣調(diào)用: $this->forward($controller, $action, $params); (參數(shù)$controller是控制器的類名，包含命名空間)

　　例：

<span>class</span> FooController <span>extends</span><span> Controller
{
    </span><span>public</span> <span>function</span><span> bar()
    {
        </span><span>$this</span>->redirect('www.baidu.com'<span>);
        </span><span>return</span> <span>$this</span>->forward('App\Modules\Demo\Controller\FooController', 'bar', 'test'<span>);
        </span><span>return</span> <span>$this</span>->forward('/demo/testpro'<span>);
    }
}    </span>

　　3.2.4 獲取請求參數(shù)

　　調(diào)用MinorRequest的get($paramName, $defaultParamValue = null) 或者 post($paramName, $defaultParamValue = null)方法就可以獲取請求方法，在控制器中可以這樣調(diào)用：

<span>class</span> FooController <span>extends</span><span> Controller
{
    </span><span>public</span> <span>function</span><span> bar()
    {
       $minorRequest = <span>$this->app->getMinorRequest()</span>; </span><br />　　　　$paramValue = <span>$minorRequest</span>->get('paramKey', 'defaultValue'<span>);<br />　　　　...
    }
}   </span>

　　3.2.5 獲取請求方法

　　調(diào)用MinorRequest的getMethod()方法就可以獲取請求的方法:

<span>class</span> FooController <span>extends</span><span> Controller
{
    </span><span>public</span> <span>function</span><span> bar()
    {
       </span><span>$minorRequest</span> = <span>$this</span>->app-><span>getMinorRequest(); 
　　　　</span><span>$method</span> = <span>$minorRequest</span>-><span>getMethod();
　　　　</span>...<span>
    }
}  </span>

3.3 視圖

　　Minor提供了一個極其強(qiáng)大的模板引擎，這個模板引擎的名稱就是： PHP。是的！你沒看錯就是PHP。為什么Minor不提供一個類似于smarty或者Twig這樣的模板引擎呢？ 因?yàn)闆]有必要，PHP本身已經(jīng)足夠好了，如果Minor再造一個模板引擎無疑就會使Minor更難上手，所以Minor直接使用PHP作為視圖文件的語言。

　　3.3.1 在控制器中使用視圖

　　在控制器中使用視圖只需要調(diào)用View::render('模塊名:控制器名:視圖文件名'， ['param1key' => 'param1value', 'param2key' => 'param2value' ...])；例：

<span>class</span> FooController <span>extends</span><span> Controller
{
    </span><span>public</span> <span>function</span><span> bar()
    {
        </span><span>$param1</span> = 'Hello'<span>;
        </span><span>$param2</span> = 'World'<span>; 
        </span><span>return</span> View::render('Demo:Foo:bar.php', ['param1' => <span>$param1</span>, 'param2' => <span>$param2</span><span>]);
    }
}  </span>

　　render函數(shù)的第二個參數(shù)（['param1key' => 'param1value', 'param2key' => 'param2value' ...]）就是向視圖文件中傳遞的變量，我們可以在視圖文件中使用這些變量：

文件：app/Modules/Demo/Controller/Tpl/Foo/bar.php<br /><?php echo $param1key;?><br /><?=$param2key ?>

　　3.3.2 視圖內(nèi)置函數(shù)

　　Minor提供了兩個視圖文件中可以使用的函數(shù)：

<span>function</span> include_tpl(<span>$module</span>, <span>$controller</span>, <span>$tpl</span><span>)
{
    </span><span>require_once</span> (!<span>defined</span>('APP_DIR') ? APP_DIR : <span>realpath</span>(__DIR__ . '/../../app/') .DIRECTORY_SEPARATOR) . 'Modules' . '/' . <span>$module</span> . '/Tpl/' . <span>$controller</span> . '/' . <span>$tpl</span><span>;
}

</span><span>function</span> url(<span>$path</span><span>)
{
    </span><span>return</span> Url::gen(<span>$path</span><span>);
}</span>

　　使用：

<span>html>   
    </span><span><?</span><span>php include_tpl('Public', 'Public', 'header.php');</span><span>?></span> 
    <span><</span><span>body</span><span>></span>
        <span><</span><span>h1</span><span>></span>Hello!<span></</span><span>h1</span><span>></span>
        <span><</span><span>a </span><span>href</span><span>="<?php url('/demo/foo/bar?productName=testpro');?>"</span><span>></span>
    <span></</span><span>body</span><span>></span>
<span></</span><span>html</span><span>></span>

　　這兩個函數(shù)定義在app/Resource/functions.php文件中，你可以在這個文件中自定義你需要的視圖函數(shù)。

3.4 響應(yīng)

　　可以在控制器中通過調(diào)用App對象的getMinorResponse()方法來獲取當(dāng)前MinorResponse對象。　MinorResponse類提供了六個方法分別是：

<span>public function send()； // 用于將響應(yīng)對象發(fā)送給客戶端

public function setHeader($header)；// 設(shè)置響應(yīng)頭

public function setContent($content); // 設(shè)置響應(yīng)對象的內(nèi)容

public function beforeContent($content); // 在當(dāng)前已有的內(nèi)容之前添加內(nèi)容

public function appendContent($content); // 在當(dāng)前已有內(nèi)容之后追加內(nèi)容

public function getContent()； // 獲取對象中的響應(yīng)內(nèi)容</span>

?