靜態頁面

Note: 這篇教學假設你已經下載了 CodeIgniter 並且已經 安裝 在你的開發環境中。

你要做的第一件事情是設置一個 控制器（Controller） 來處理靜態頁面。控制器是一個簡單的類別來幫助委派工作。它是你的網頁應用程式中的膠水。

例如，當瀏覽器發出一個請求給:

我們可以想像那邊有個控制器名為 “news” 。而 news 控制器將會被呼叫的方法(method)為 “latest” 。 這個 latest 方法的工作可能是抓取十個新聞項目，並顯示在頁面上。這在 MVC 中很常見，你看到的 URL 格式將會是這樣:

當 URL 變得更複雜時這可能會改變。但目前來說這就是我們所需要知道的全部了。

在 application/controllers/Pages.php 創建一個檔案，填入下面的程式。

<?php
class Pages extends CI_Controller {

        public function view($page = 'home')
        {
        }
}

你創建了一個類別名為 pages，並且有一個view方法，接受一個參數名為 $page 。這個 pages 類別繼承了 CI_Controller 類別。 代表這個新的 pages 類別可以存取在 CI_Controller 類別（system/core/Controller.php）中定義的方法以及變數。

對你的網頁應用程式而言， 控制器將會成為所有請求的中心 。用 CodeIgniter 的術語來說，它可以做為超級物件來使用。 就像所有的 php 類別，你在你的控制器中可以使用 $this 來存取它。並且，當你要載入程式庫，載入檢視以及控制 CodeIgniter 時，也是使用 $this 來做。

現在你建立了你的第一個方法，是時候來建立一些基本的頁面模板了。 我們將會建立兩個 “views” （頁面模板）來做為我們頁面的 header 與 footer。

在 application/views/templates/header.php 建立 header 並且加入以下的程式碼:

<html>
        <head>
                <title>CodeIgniter Tutorial</title>
        </head>
        <body>

                <h1><?php echo $title; ?></h1>

這個 header 放的是你想要在主畫面之前顯示的基本 HTML 代碼，裡面包含了 HTML head。 它也顯示了 $title 變數，我們待會會在控制器中定義它。 現在在 application/views/templates/footer.php 建立 footer 檔案，裡面包含下列代碼:

                <em>&copy; 2015</em>
        </body>
</html>

在控制器（Controller）中增加邏輯

剛才你設置了控制器以及一個 view() 方法。這個方法接受一個參數，這個參數就是將要被讀取的頁面名稱。靜態頁面的模板將會放在 application/views/pages/ 資料夾。

在那個資料夾裡，建立兩個檔案並命名為 home.php 以及 about.php 。在這兩個檔案裡打一些字−隨便你想打什麼−然後存檔。如果你喜歡老套的，就放”Hello World!”。

在讀取這些頁面之前，你必須去確認所要求的頁面是存在的:

public function view($page = 'home')
{
        if ( ! file_exists(APPPATH.'views/pages/'.$page.'.php'))
        {
                // Whoops, we don't have a page for that!
                show_404();
        }

        $data['title'] = ucfirst($page); // Capitalize the first letter

        $this->load->view('templates/header', $data);
        $this->load->view('pages/'.$page, $data);
        $this->load->view('templates/footer', $data);
}

現在，當頁面存在時，它將會被讀取然後顯示給使用者，包含了 header 與 footer 。如果頁面不存在，將會顯示錯誤訊息”404 Page not found”。

在這個方法中的第一行檢查了頁面檔案是否存在。PHP的原生函式 file_exists() 用來檢查檔案是否在預期的地方。 show_404() 是 CodeIgniter 內建的函式，用來顯示預設的錯誤訊息頁面。

在 header 模板裡， $title 變數用來客製頁面的標題。在view方法中我們給標題設定了值，但我們不是將值設定給變數，而是設定給 $data 陣列裡面的 title 元素。

最後要做的事情是按照順序來讀取檢視。在 view() 方法中的第二個參數是用來傳值給檢視用的。$data 陣列中的每個值會依照其陣列索引鍵值來存放到同名的變數中。 所以在控制器中 $data[‘title’] 的值等同於檢視中的 $title 。

路由（Routing）

控制器現在可以運作了！打開你的瀏覽器並前往 [你的網址]index.php/pages/view 來瞧瞧你的網頁。 當你訪問 index.php/pages/view/about 時你將會看到 about 頁面，並且包含了 header 與 footer。

使用自訂的路由規則，你就擁有將任何 URI 對應到任何控制器與方法的力量，並且掙脫了這個慣例: http://example.com/[controller-class]/[controller-method]/[arguments]

就讓我們試試看。打開位於 application/config/routes.php 的路由檔案，增加下列兩行。並將其它設置 $route 陣列的程式碼都移除。

$route['default_controller'] = 'pages/view';
$route['(:any)'] = 'pages/view/$1';

CodeIgniter 由上而下讀取這個路由規則，並且將請求導向第一個符合的規則。 每一個規則都是正則表達式（位於左側），對應到由反斜線分隔的控制器與方法（位於右側）。當一個請求進來，CodeIgniter 找出第一個符合的規則，然後呼叫其控制器與方法，可能還包含了參數。

關於路由的更多資訊可以在 documentation 中找到。

在這邊， $routes 陣列中的第二條規則使用了萬用字串 (:any)，它將會符合任何的請求。並將參數傳送給 pages 類別中的 view() 方法。

現在，訪問 index.php/about 。是不是被正確的導到 pages 控制器中的 view() 方法呢？太神奇了！