月份: 2016 年 11 月

【本文同步於CodeData】PHP Laravel 開發入門(四) – 路由(Routes)

任何一個網站框架最基本的功能就是透過http(s)取得客戶端的需求後並且回覆相關資訊，這意味著在學習框架中首要的是定義路由，如果沒有路由也就無法完成與客戶端互動。
在本章我們將瞭解Laravel的框架以及如何定義路由，並且熟悉如何使用Laravel的路由工具去處理各種路由的需求。

在Laravel的框架中，你可以透過 routes/web.php 定義 web相關的 routes，並透過 routes/api.php 定義 api相關的 routes。也就是說你可以將api與web做區隔建立對應的route。(如果是 5.3之前的版本，routes則存在 app/Http/routes.php中。)在這邊我們主要討論的是 web.php為主。

基本路由

在web.php中有一個為根目錄(‘/’)且附帶閉包函數的預設路由。這個路由預設是使用者造訪根目錄時，就會回傳 welcome.blade.php 的內容。

1
2
3
Route::get('/', function () {
return view('welcome');
});

除此之外，我們也可以不透過echo或print回傳字串。例如：

1
2
3
Route::get('/', function () {
return 'Hello World!';
});

假設我們要設定一個回傳about的路由，可以透過

1
2
3
Route::get('about', function () {
return 'this is about!';
});

或顯示 resource/views/about.blade.php

1
2
3
Route::get('about', function () {
return view('about');
});

路由動詞

在HTTP通訊協定中制定了幾種動詞(Verbs)與伺服器溝通，在上一節中我們使用GET用來讀取資料。那其他PUT、POST、DELETE該如何定義？

1
2
3
4
5
Route::post('/', function () {});
Route::put('/', function () {});
Route::delete('/', function () {});

如果要符合所有通詞，則使用any

1
Route::any('/', function () {});

另外，要符合部分動詞，則使用match

1
Route::match(['get', 'post'], '/', function () {});

如果要路由至特定的控制器(Controller)，下面的例子會對應到 app/Http/Controllers/WelcomeController.php的index函數

1
Route::get('/', 'WelcomeController@index');

路由參數

如果你的路由需要傳遞參數的話，，該如何傳遞呢?

1
2
3
Route::get('users/{id}', function ($id) {
//
});

如果傳遞的參數要有預設值的話，

1
2
3
Route::get('users/{id}', function ($id='123') {
//
});

另外，參數也可以透過正規式讓裡頭的函數只能接收相 對應的值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// id只能輸入 0-9
Route::get('users/{id}', function ($id) {
//
})->where('id', '[0-9]+');
// username只能輸入大小寫的英文字母
Route::get('users/{username}', function ($username) {
//
})->where('username', '[A-Za-z]+');
// id只能輸入數字;slug只能輸入英文字母
Route::get('posts/{id}/{slug}', function ($id, $slug) {
Route Definitions | 27
//
})->where(['id' => '[0-9]+', 'slug' => '[A-Za-z]+']);

路由命名

在url Helper可以透過 url()去轉向，而在laravel框架中更允許你對每個路由做命名。

例如我們要顯示某一位會員的資料，可以先將會員資料做處理，

1
2
3
4
// 定義members/ID為members.show
Route::get('members/{id}', 'MembersController@show')->name('members.show');
// 在View
<a href="<?php echo route('members.show', ['id' => 14]); ?>">

路由群組

在Laravel裡有一個好用的路由群組，舉例來說，我有一個api相關的群組，一開始的定義可能如下：

1
2
3
4
5
6
Route::get('/api', function () {
});
Route::get('/api/users', function () {
});

我們透過路由群組可以簡化成

1
2
3
4
5
6
7
8
Route::group(['prefix' => 'api'], function () {
Route::get('/', function () {
});
Route::get('users', function () {
});
});

子網域路由

在網址裡，可能會有不同的子網域，我們也可以透過子網域的路由來完成

1
2
3
4
5
Route::group(['domain' => 'admin.codedata.com.tw'], function () {
Route::get('/', function () {
//
});
});

同樣的，也可以透過參數帶入不同的子網域

1
2
3
4
5
6
7
Route::group(['domain' => '{account}.codedata.com.tw'], function () {
Route::get('/', function ($account) {
//
});
Route::get('article/{id}', function ($account, $id) {
//
});

這樣大家對路由有沒有基本的瞭解了呢？下一次我們來解說Controller(控制器)。

PhpStorm 2016.3版本釋出了！


PhpStorm是目前PHP開發工具中最強也最完整的一套，11/24推出2016.3的正式版本了！

  • 工具和框架：在遠程解釋程序中支持 Docker、支持 PHPSpec 測試框架、自動檢測和配置 PHPUnit、Behat 和 composer.json 內的 PHPSpec、在一個框架中打開多個項目，以及支持 Codeigniter 代碼風格。
  • 新的編輯體驗：語意突顯變量和參數、無需函數和 var 關鍵字即可完成重載方法和屬性，以及改進對 PSR-0/PSR-4 的支持。
  • 代碼質量分析：項目範圍的 PHP 7 嚴格類型、新的命名約定檢查，並改進運行時錯誤預防。

該版本還對頂尖 web 技術的支持進行了重大改進，如：支持流(flow)、改進對 TypeScript 的支持、支持 PostCSS、Stylelint 等。

原始連結：　https://blog.jetbrains.com/phpstorm/2016/11/phpstorm-2016-3-is-now-released/

下載: https://www.jetbrains.com/phpstorm/download/#section=windows-versionphpstorm_debugging2x

Laravel 回傳 json的亂碼解決方式

在Laravel中我們要產出json格式的話，一般只要
[php]
Route::get(‘json’, function () {
$users = DB::table(‘users’)->get();
return Response::json($users);
}
[/php]
但是遇到中文時，會出現有亂碼的問題，解決很簡單
[php]
Route::get(‘json’, function () {
$headers = array(‘Content-Type’ => ‘application/json; charset=utf-8’);
$users = DB::table(‘users’)->get();
return Response::json($users, 200, $headers, JSON_UNESCAPED_UNICODE);
});
[/php]