動態(tài)頁面
在頁面模板的“ Twig”部分內(nèi),您可以使用october提供的任何功能,過濾器和標簽。任何動態(tài)頁面都需要變量。在october頁面變量可以通過頁面或布局PHP部分或組件來準備。在本文中,我們將介紹如何在PHP部分中準備變量。
頁執(zhí)行生命周期
可以在頁面和布局PHP部分來定義特殊功能:onInit,onStart和onEnd。
- onInit當所有組件被初始化并且處理AJAX請求之前,該函數(shù)被執(zhí)行。
- onStart函數(shù)在頁面執(zhí)行開始時執(zhí)行。
- onEnd函數(shù)在頁面呈現(xiàn)之前和頁面組件執(zhí)行之后執(zhí)行。
- onStart、onEnd函數(shù)中,您可以向Twig環(huán)境注入變量、使用數(shù)組或標記將變量傳遞到頁面:
url = "/"
==
function onStart()
{
$this['hello'] = "Hello world!";
}
==
<h3>{{ hello }}</h3>
書寫代碼,在模板中可以通過{{hello}}輸出變量
下一個例子比較復雜。它顯示如何從數(shù)據(jù)庫加載博客文章集合并顯示在頁面上(Acme \ Blog插件是虛構(gòu)的)。
url = "/blog"
==
use Acme\Blog\Classes\Post;
function onStart()
{
$this['posts'] = Post::orderBy('created_at', 'desc')->get();
}
==
<h2>Latest posts</h2>
<ul>
{% for post in posts %}
<h3>{{ post.title }}</h3>
{{ post.content }}
{% endfor %}
</ul>
在php代碼區(qū)獲取所有帖子信息,并注入到模板中的posts變量中,可以在模板中使用
october提供的默認變量和Twig擴展在“標記指南”中有描述。在動態(tài)布局文章中介紹了執(zhí)行處理程序的整體順序。
發(fā)送自定義響應
在執(zhí)行生命周期中定義的所有方法都有能力停止進程并返回響應。只需返回生命周期功能的響應。下面的示例將不會加載任何頁面內(nèi)容并返回字符串Hello world!瀏覽器:
function onStart()
{
return 'Hello world!';
}
可以使用laravel的Redirect門面觸發(fā)重定向:
public function onStart()
{
return Redirect::to('http://google.com');
}
處理表單
您可以使用頁面或布局PHP部分中定義的處理程序方法處理標準表單(處理AJAX請求在AJAX框架文章中解釋)。使用form_open()函數(shù)定義引用事件處理程序的窗體。例:
{{ form_open({ request: 'onHandleForm' }) }}
Please enter a string: <input type="text" name="value"/>
<input type="submit" value="Submit me!"/>
{{ form_close() }}
<p>Last submitted value: {{ lastValue }}</p>
在代碼部分可以
function onHandleForm() {
$this['lastValue'] = input('value');
}
function onHandleForm()
{
$this['lastValue'] = post('value');
}
注意:如果在頁面布局中定義了具有相同名稱的處理程序,則頁面和頁面組件 october將執(zhí)行頁面處理程序。如果在組件和布局中定義了處理程序,則將執(zhí)行布局處理程序。處理程序的優(yōu)先級是:頁面,布局,組件。
如果要引用特定組件中定義的處理程序,請在處理程序引用中使用組件名稱或別名:
{{ form_open({ request: 'myComponent::onHandleForm' }) }}
404頁
如果主題包含具有URL的頁面,則/404在系統(tǒng)找不到請求的頁面時顯示該頁面。
錯誤頁面
默認情況下,將顯示包含錯誤發(fā)生的文件內(nèi)容,行號和堆棧跟蹤的詳細錯誤頁面您可以通過在腳本中將配置值設置debug為falseconfig/app.php并創(chuàng)建帶有該URL的頁面來顯示自定義錯誤頁面/error。
頁面變量
代碼中
function onEnd()
{
$this->page->title = 'A different page title';
}
模板中
<p>The title of this page is: {{ this.page.title }}</p*>
//this.page
this.page.layout
this.page.id
this.page.title
this.page.description
this.page.meta_title
this.page.meta_description
this.page.hidden //判斷是否登錄可見
以編程方式注入頁面資源
如果需要,您可以使用控制器addCss和addJs方法將資源(CSS和JavaScript文件)注入頁面。它可以在頁面或布局模板onStart的PHP部分定義的函數(shù)中完成。例:
function onStart()
{
$this->addCss('assets/css/hello.css');
$this->addJs('assets/js/app.js');
}
如果在指定的路徑addCss和addJs方法參數(shù)與斜線(/)開始那么這將是相對于網(wǎng)站根。如果資產(chǎn)路徑不以斜杠開頭,那么它與主題相關。
注入資產(chǎn)可以通過將它們作為數(shù)組傳遞
function onStart()
{
$this->addCss(['assets/css/hello.css', 'assets/css/goodbye.css']);
$this->addJs(['assets/js/app.js', 'assets/js/nav.js']);
}
LESS和SCSS資產(chǎn)可以使用組合器進行注入和編譯:
function onStart()
{
$this->addCss(['assets/less/base.less']);
}
為了在頁面或布局上輸出注入的資產(chǎn),請使用{%styles%}和{%scripts%}標簽。例:
<head>
...
{% styles %}
</head>
<body>
...
{% scripts %}
</body>