動態新增新聞

你現在知道如何使用 CodeIgniter 從資料庫中讀取資料,但資料庫中尚未寫入任何資訊。 在這一章節你將會擴充你先前做的 news 控制器及模型來增加這個功能。

建立一個表單

為了要輸入資料到資料庫當中,你需要建立一個表單讓你可以輸入要儲存的資訊。 這代表你需要一個有兩個欄位的表單,一個用來輸入標題,另一個輸入內文。 你將會在模型中將標題製成 slug,現在到 application/views/news/create.php 建立新的檢視。

<h2><?php echo $title ?></h2>

<?php echo validation_errors(); ?>

<?php echo form_open('news/create') ?>

    <label for="title">Title</label>
    <input type="input" name="title" /><br />

    <label for="text">Text</label>
    <textarea name="text"></textarea><br />

    <input type="submit" name="submit" value="Create news item" />

</form>

裡面只有兩個東西你可能不熟悉:``form_open()`` 函式以及 validation_errors() 函式。

第一個函式是由 Form 輔助函式 所提供的,它將會顯示表單元素並增加一些額外功能。 例如增加一個隱藏的 CSRF 預防欄位 。第二個函式則是當表單驗證錯誤時,用來顯示錯誤訊息。

回到你的 news 控制器。在這邊你將要做兩件事情,檢查是否有表單被送出,以及送出的資料是否通過驗證規則。 我們將使用 Form 驗證 程式庫來做這件事。

public function create()
{
    $this->load->helper('form');
    $this->load->library('form_validation');

    $data['title'] = 'Create a news item';

    $this->form_validation->set_rules('title', 'Title', 'required');
    $this->form_validation->set_rules('text', 'text', 'required');

    if ($this->form_validation->run() === FALSE)
    {
        $this->load->view('templates/header', $data);
        $this->load->view('news/create');
        $this->load->view('templates/footer');

    }
    else
    {
        $this->news_model->set_news();
        $this->load->view('news/success');
    }
}

上面這段程式增加了許多功能。 開頭前幾行用來載入 Form 輔助函式以及 Form Validation 程式庫。 接著是設定表單驗證的規則。 set_rules() 方法需要三個參數,輸入欄位的名稱,用來顯示在錯誤訊息中的名稱,以及規則。 在這個例子中使用的規則,用來表示標題及內文都是必要的欄位。

如上面的範例, CodeIgniter 有一個強力的表單驗證程式庫。 你可以在這邊閱讀 更多關於表單驗證的資訊

繼續往下看,你可以看到一個條件式用來檢查表單驗證是否成功。 若是沒有,就會顯示表單,若是表單已被送出 並且 通過了驗證,模型就會被呼叫。 接著一個檢視會被載入並顯示成功訊息。 請在 application/view/news/success.php 建立一個檢視並寫入成功訊息。

模型(Model)

最後一件事就是寫一個方法來將資料存進資料庫。 你將會使用 Active Record 類別來新增這資訊,並使用 Input 程式庫來取得表單送出的資料。 打開之前建立的模型,並加入下列程式碼:

public function set_news()
{
    $this->load->helper('url');

    $slug = url_title($this->input->post('title'), 'dash', TRUE);

    $data = array(
        'title' => $this->input->post('title'),
        'slug' => $slug,
        'text' => $this->input->post('text')
    );

    return $this->db->insert('news', $data);
}

這個新方法用來新增資料到資料庫中。 在第三行有個新的 url_title() 函式。 這個函式 - 由 URL 輔助函式 提供 - 會讀取你傳入的字串,使用破折號 (-) 來替換掉空白,並將所有字串轉為小寫。 最後會產生一個很好的 slug ,非常適合用來建立 URI 。

我們繼續處理待會要存入的資料,將其放進 $data 陣列中。 陣列中的每個元素都對應到我們建立的資料庫中的欄位。 你可能注意到這邊有個新的函式叫做 post() ,它來自 Input 函式庫 。 這個方法用來確保資料已經被消毒,可以避免你受到令人討厭的攻擊。而這個程式庫預設就會被自動載入。 最後,我們將 $data 存入資料庫當中。

路由(Routing)

在你開始新增項目進去你的 CodeIgniter 應用程式之前,你需要在 config/routes.php 中增加額外的規則。 確認你的檔案中含有下列項目。這讓 CodeIgniter 看到 ‘create’ 時,當作是一個方法,而不是一個新聞的 slug 。

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

現在打開你的瀏覽器並輸入你的 CodeIgniter 根目錄網址,並在後面加上 index.php/news/create 。 恭喜你,你剛剛建立了你的第一個 CodeIgniter 應用程式!增加一些新聞並逛一逛你所建立的其它頁面。