遇見 Laravel 的午後(Part 10)

很感謝很多公司給我機會，雖然很多公司願意給我offer，但有時候就是一個緣分，畢竟多方面會去衡量，畢竟有錢的壓力。
未來我還是會不斷的學習，學習是為了成就更多的事物，但如果不先學好、不先理解，怎麼去成就這些事物？先學如何使用輪子，再去學習怎麼造一個輪子，加以改進輪子等。

控制(Controller)

控制 Controller 的存在，就為了處理各項請求，達到各MVC分層的結構。

建立Controller

在建立Controller的時候，有人一定會問說，難道我不行複製改檔名就好嗎？其實也是可以的，但是我個人建議使用Artisan的指令去產生檔案，畢竟影響的東西就是名稱及Namespace(詳細內容請觀看PSR-4: Autoloader)。

$ php artisan make:controller MemberController

建立好以後，開啟 MemberController.php，以下為產生的檔案內容。

專案 > app > Http > Controllers > MemberController.php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class MemberController extends Controller
{

}

可以來牛刀小試，搭配Route 做一個關聯。
專案 > app > Http > Controllers > MemberController.php

將 MemberController.php 寫兩個簡單的 function，分別是index、new 這兩個，而 new 這個 function 我們做一個簡單的傳值，以下只是隨便寫的，請各位別介意。

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class MemberController extends Controller
{
    public function index(){
        return "會員首頁";
    }

    public function new($page){
        return "這是一個新的頁面，第" . $page . "頁";
    }
}

之後我們設定兩個Route去跟Controller做請求或要求。第二個Route，我們要設定一個參數做一個接值及傳值，讓MemberController 可以接到URL所丟的值。
專案 > routes > web.php

// GET URL給的路徑要求交給 MemberController 的 index 方法處理。
Route::get('/member', 'MemberController@index');

// GET URL給的路徑要求交給 MemberController 的 new 方法處理。
// 一併將URL給的參數值傳遞出去。
Route::get('/member/{page}', 'MemberController@new');

用 artisan 指令執行專案

$ php artisan serve

分別輸入以下兩個網址，當Route找Controller以後，Controller會吐值回頁面上。

• http://127.0.0.1:8000/member/

• http://127.0.0.1:8000/member/50
  網址後方有個/50，在URL GET傳值到Controller的時候會將所得到的值傳回頁面。
  

使用artisan提供的指令去看專案內有哪些Route存在。

$ php artisan route:list

+--------+----------+---------------+------+---------------------------------------------+------------+
| Domain | Method   | URI           | Name | Action                                      | Middleware |
+--------+----------+---------------+------+---------------------------------------------+------------+
|        | GET|HEAD | api/user      |      | Closure                                     | api        |
|        |          |               |      |                                             | auth:api   |
|        | GET|HEAD | member        |      | App\Http\Controllers\MemberController@index | web        |
|        | GET|HEAD | member/{page} |      | App\Http\Controllers\MemberController@new   | web        |
+--------+----------+---------------+------+---------------------------------------------+------------+

建立Resource Controller

為什麼要說是建立 Resource Controller？因為 resource 提供了CURD的方法或者說是提供了Action，所以 Resource Controller 可以方便開發者更快速的將CURD做好做滿。但在專案中，可能會有不會使用到的Action，其實可以把不需要的拿掉。

• 使用--resource 這個參數，就是方便建立CURD的Action。
• Controller 要跟Model進行溝通，所以我們後面會帶上model的指令 --model=Model名稱

  $ php artisan make:controller MemberController --resource --model=Member

開啟MemberDataController.php，因為在建立Resource Controller以後，就會帶出7個Action(或稱方法function)，接下來我們就可以針對我們的需求，在這7個做需求的邏輯處理。

專案 > app > Http > Controllers > MemberDataController.php

<?php

namespace App\Http\Controllers;

use App\Member;
use Illuminate\Http\Request;

class MemberDataController extends Controller
{
    /**
     * Display a listing of the resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function index()
    {
        //
    }

    /**
     * Show the form for creating a new resource.
     *
     * @return \Illuminate\Http\Response
     */
    public function create()
    {
        //
    }

    /**
     * Store a newly created resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function store(Request $request)
    {
        //
    }

    /**
     * Display the specified resource.
     *
     * @param  \App\Member  $member
     * @return \Illuminate\Http\Response
     */
    public function show(Member $member)
    {
        //
    }

    /**
     * Show the form for editing the specified resource.
     *
     * @param  \App\Member  $member
     * @return \Illuminate\Http\Response
     */
    public function edit(Member $member)
    {
        //
    }

    /**
     * Update the specified resource in storage.
     *
     * @param  \Illuminate\Http\Request  $request
     * @param  \App\Member  $member
     * @return \Illuminate\Http\Response
     */
    public function update(Request $request, Member $member)
    {
        //
    }

    /**
     * Remove the specified resource from storage.
     *
     * @param  \App\Member  $member
     * @return \Illuminate\Http\Response
     */
    public function destroy(Member $member)
    {
        //
    }
}

將兩部分做個修改測試

1、index 回傳數值

public function index()
{
    return '這裡是首頁';
}

2、show 回傳文字，並接收傳值

public function show($id)
{
    return '我顯示在 show 這裡，傳值'.$id;
}

Route對應的Action，我們可以透過 resource 將所有請求及需求指定給MemberDataController，可以統一為我們處理CURD的Action。
專案 > routes > web.php

Route::resource('/memberData', 'MemberDataController');

用 artisan 指令執行專案

$ php artisan serve

以下兩個網址，當Route找Controller以後….

• http://127.0.0.1:8000/memberData/
  這個對上index這個方法
  

• http://127.0.0.1:8000/memberData/123
  這個就會對上show的方法
  

查看路由(Route)列表，就可以很清楚看到 resource 處理7種不同的要求。

$ php artisan route:list

+--------+-----------+-------------------------------+--------------------+---------------------------------------------------+------------+
| Domain | Method    | URI                           | Name               | Action                                            | Middleware |
+--------+-----------+-------------------------------+--------------------+---------------------------------------------------+------------+
|        | GET|HEAD  | api/user                      |                    | Closure                                           | api        |
|        |           |                               |                    |                                                   | auth:api   |
|        | GET|HEAD  | memberData                    | memberData.index   | App\Http\Controllers\MemberDataController@index   | web        |
|        | POST      | memberData                    | memberData.store   | App\Http\Controllers\MemberDataController@store   | web        |
|        | GET|HEAD  | memberData/create             | memberData.create  | App\Http\Controllers\MemberDataController@create  | web        |
|        | GET|HEAD  | memberData/{memberDatum}      | memberData.show    | App\Http\Controllers\MemberDataController@show    | web        |
|        | PUT|PATCH | memberData/{memberDatum}      | memberData.update  | App\Http\Controllers\MemberDataController@update  | web        |
|        | DELETE    | memberData/{memberDatum}      | memberData.destroy | App\Http\Controllers\MemberDataController@destroy | web        |
|        | GET|HEAD  | memberData/{memberDatum}/edit | memberData.edit    | App\Http\Controllers\MemberDataController@edit    | web        |
+--------+-----------+-------------------------------+--------------------+---------------------------------------------------+------------+

工程師在開發的時候，可能7個方法(Action)不一定都用的到，Laravel 本身就提供了 only 和 except 可以做篩選及排除。
專案 > routes > web.php

Partial Resource Routes

// 只用到 index、show
Route::resource('memberData', 'MemberDataController')->only([
    'index', 'show'
]);

// 排除create、store、update、destroy這些方法
Route::resource('memberData', 'MemberDataController')->except([
    'create', 'store', 'update', 'destroy'
]);

建立單一方法的Controller

單一方法也可以說是單一的Action，官方稱為Single Action Controllers，開發階段可能很單純只用到單一的方法，其他都不需要，所以Laravel提供另一個參數 --invokable 。

$ php artisan make:controller CarController --invokable

開啟 CarController.php ，建立完成裡面就只有 __invoke 方法。

專案 > app > Http > Controllers > CarController.php

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class CarController extends Controller
{
    /**
     * Handle the incoming request.
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function __invoke(Request $request)
    {
        //
    }
}

將上方的方法修改成下面的程式，做一個小測試。

public function __invoke($id)
{
    return '這是一個單一的方法，第'.$id.'筆資料';
}

因為只有單一方法，所以在設定Route的時候也不用指定轉到哪一些方法去。
專案 > routes > web.php

Route::get('car/{id}', 'CarController');

__invoke 在 PHP 5.3.0 的時候就現世，他並非laravel 所提供，只是laravel 他將__invoke 做整合而已，當你在使用Class類別的時候，如果__invoke存在，就會被執行。

__invoke 的資訊，請參考：Magic Methods

完整指令

$ php artisan make:controller {ControllerName} --{option 1} -- {option 2}

建立空的Controller

$ php artisan make:controller {Controller Name}

建立帶有CURD 7個function的Controller，並帶入model

$ php artisan make:controller {Controller Name} --resource --model=Member

建立單一方法的Controller

$ php artisan make:controller {ControllerName} --invokable

提供API給別人使用的Controller

$ php artisan make:controller {ControllerName} --api

專案 > routes > web.php

Route::apiResource('/URL', 'ControllerName');

結論

其實 Controller 做的事情，其實很單純的CURD，雖然還有一些比較深入的部分，但這個部分以後會再提到，但如果就單純以一個官方網站，其實這樣很足夠。

標籤: w3HexSchool PHP Laravel