Laravel 4 入門

第一個小專案：迷你部落格

綜合前面說到的內容，就可以開始來寫我們的第一個小專案：迷你部格格。

先來描述一下功能：

A.首頁：顯示文章的標題清單。
B.文章標題：點選可開啟文章內容。
C.新增功能：點選後開啟表單頁面來新增內容。
D.編輯功能：在標題後方，點選後開啟表單頁面編輯內容。
E.刪除功能：顯示在編輯頁面中，點選後刪除內容。

開始動手。

A.首頁：顯示文章的標題清單

1.設定 Route

編輯 app/routes.php

Route::get('post', 'HomeController@index');

對應網址：

http://localhost/blog/public/post

2.設定 Controller

編輯 app/controllers/HomeController.php

public function index()
{
    $posts = Post::all();

    return View::make('home')
        ->with('title', 'My Blog')
        ->with('posts', $posts);
}

利用 Post Model 取得全部文章，回傳值會是一個陣列，所以我們的變數名稱以複數表示 $posts。最後傳送給 view 去顯示，view 的名稱是 home。

3.設定 View

編輯 app/views/home.blade.php

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ $title }}</title>
</head>
<body>
    <h1>{{ $title }}</h1>
    <div>{{ link_to("post/create", "新增") }}</div>
    @if (isset($posts))
        <ol>
        @foreach ($posts as $post)
            <li>{{ link_to("post/".$post->id, $post->title) }}
            ({{ link_to("post/".$post->id."/edit", "編輯") }})</li>
        @endforeach
        </ol>
    @endif
</body>
</html>

@if ... @endif 是 Blade 樣板系統的 if 語法；@foreach ... @endforeach 則是 foreach 迴圈，最終會被轉換成 PHP。

使用來顯示資料。使用 foreach 迴圈，逐一取出 $posts 陣列中的資料。

link_to('連結位址', '顯示的文字');

會被轉換成 HTML 中的 a 連結標籤。

4.完成

Route、Controller、Model、View 全都完成，可以來執行看看這個熱騰騰的網站了。當你新增一筆資料後，看起來會像這樣：

我們來讓"新增"的功能可以動作。

B.文章標題：點選可開啟文章內容。

文章的標題被點選後，會開啟一個頁面來顯示文章的內容。

1.設定 Route

編輯 app/routes.php

Route::get('post/{id}', 'HomeController@show');

對應網址：

http://localhost/blog/public/post/123

123 假設為文章 id。

2.設定 Controller

編輯 app/controllers/HomeController.php

public function show($id)
{
    $post = Post::find($id);

    return View::make('show')
        ->with('title', 'My Blog - '. $post->title)
        ->with('post', $post);
}

3.設定 View

新增 app/views/show.blade.php

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ $title }}</title>
</head>
<body>
    @if (isset($post))
        <h1>{{ $post->title }}</h1>
        <p>{{ $post->content }}</p>
    @endif

    {{ link_to(URL::previous(), "回上一頁") }}
</body>
</html>

最後面我們加了一個"回上一頁"的連結，使用 URL 類別來產生網址。

4.完成

點選首頁中文章清單的標題，會顯示該文章的內容，結果畫面：

C.新增功能：點選後開啟表單頁面來新增內容

在首頁中，點選[新增]連結，開啟新增頁面，送出內容後，返回首頁。

1.設定 Route

編輯 app/routes.php

Route::get('post/create', 'HomeController@create');

對應網址：

http://localhost/blog/public/post/create

2.設定 Controller

編輯 app/controllers/HomeController.php

public function create()
{
    return View::make('create')
            ->with('title', '新增文章');
}

新增一個 create() 方法，回傳一個 view 名稱為 create，這個 view 會有一個表單來新增文章。

3.設定 View

新增 app/views/create.blade.php

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ $title }}</title>
</head>
<body>
    <h1>{{ $title }}</h1>
    {{Form::open(["url"=>"post", "method"=>"post"])}}
    {{Form::label("title", "標題")}}<br>
    {{Form::text("title")}}<br>
    {{Form::label("content", "內容")}}<br>
    {{Form::textarea("content")}}<br>
    {{Form::submit("發表文章")}}
    {{Form::close()}}
</body>
</html>

這裡不要搞混了 url 和 method 的值，雖然都是 post，但一個是我們命名的網址名稱，一個則是 submit 時要使用的資料傳送方法。

4.前端部份完成

到目前為止，我們完成了前端這部份，結果畫面：

接下來要來處理後端的部份，將取得表單資料並儲存到資料庫。

5.設定 Route

編輯 app/routes.php

Route::post('post', 'HomeController@store');

這裡的 Route::post 是指 method；'post'則是 url。

6.設定 Controller

編輯 app/controllers/HomeController.php

public function store()
{
    $input = Input::all();

    $post = new Post;
    $post->title = $input['title'];
    $post->content = $input['content'];
    $post->save();

    return Redirect::to('post');
}

使用 Input 類別來取得表單資料。因為是新增資料，所以先 new 一個 Post 物件出來，接著將值指定給 $post 的屬性，最後 save() 就新增到資料庫了。

最後使用 Redirect::to('post') 導向首頁。這時首頁就會顯示剛才新增的文章標題。

D.編輯功能：在標題後方，點選後開啟表單頁面編輯內容

編輯的連結被放置在文章標題後方，點選後開啟頁面來編輯。

1.設定 Route

編輯 app/routes.php

Route::get('post/{id}/edit', 'HomeController@edit');

對應網址：

http://localhost/blog/public/post/123/edit

123 假設為文章 id。

2.設定 Controller

編輯 app/controllers/HomeController.php

public function edit($id)
{
    $post = Post::find($id);

    return View::make('edit')
            ->with('title', '編輯文章')
            ->with('post', $post);
}

使用 $id 找到這篇文章，將它送給 view。

3.設定 View

新增 app/views/edit.blade.php

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>{{ $title }}</title>
</head>
<body>
    <h1>{{ $title }}</h1>
    {{Form::open(["url"=>"post/".$post->id, "method"=>"put"])}}
    {{Form::label("title", "標題")}}<br>
    {{Form::text("title", $post->title)}}<br>
    {{Form::label("content", "內容")}}<br>
    {{Form::textarea("content", $post->content)}}<br>
    {{Form::submit("儲存")}}
    {{Form::close()}}
</body>
</html>

這裡和 create.blade.php 大同小異，但要注意 Form::open() 的參數：

url 改為 'post/id' 的型式，id 就是 Post 物件的 id 屬性。
form 的 method 要改成 put，表示由不同的 route 處理。

Form::text 及 Form::textarea 的第二個參數要給值，值就是從資料庫取出的資料。

4.前端部份完成

到目前為止，我們完成了編輯前端的部份，結果畫面：

接著就是設定後端來儲存資料。

5.設定 Route

編輯 app/routes.php

Route::put('post/{id}', 'HomeController@update');

你會看到這個 route 和顯示文章內容的很像，但是這裡要用 put ，而不是 get，要注意。

6.設定 Controller

編輯 app/controllers/HomeController.php

public function update($id)
{
    $input = Input::all();

    $post = Post::find($id);
    $post->title = $input['title'];
    $post->content = $input['content'];
    $post->save();

    return Redirect::to('post');
}

在 update($id) 方法中，使用 Post::find($id) 去找出這筆資料，並重新指定內容，save() 後就會對資料庫送出更新的動作。

快要完成了，目前什麼都有，就是不能刪除，把它加入吧～

E.刪除功能：顯示在編輯頁面中，點選後刪除內容

1.設定 Route

編輯 app/routes.php

Route::delete('post/{id}', 'HomeController@destroy');

2.設定 Controller

編輯 app/controllers/HomeController.php

public function destroy($id)
{
    $post = Post::find($id);
    $post->delete();

    return Redirect::to('post');
}

一樣，先找到這筆資料，然後刪除。

3.設定 View

編輯 app/views/edit.blade.php

刪除的做法有點麻煩，要用到表單以 delete 型式來送出。把它加在原有表單後後面：

...略
<br>
{{ Form::open(["url"=>"post/".$post->id, "method"=>"delete"]) }}
    <button type="submit">刪除</button>
{{ Form::close() }}

現在你已經可以刪除內容了。

總結

一路寫下來，你會發現 Route -> Controller (Model) -> View 這樣的開發流程，所以只要一直重覆這個流程，功能就會慢慢完成。Laravel 框架的各個部份各司其職，每個部份所付的責任清清楚楚，不僅開發容易、迅速，在日後的維護上也不會陷入混亂。