Laravel教程 七:表單驗證 Validation
此文章為原創文章,未經同意,禁止轉載。
終於要更新這個Laravel系列教程的第七篇了,期間去寫了一點其他的東西。
就不 說廢話了吧,直接進入Form Validation的部分吧。幾乎在每一個web應用當中都會有表單,而有表單基本就離不開表單驗證。在laravel中,其實可以說是有兩種方式來進行表單驗證:使用Request和使用Validation。下面將分開講這兩部分的內容,而且我會更着重第一種,也更推薦大家使用第一種
Request表單驗證
為什么說是會把精力都放在講解第一種驗證方式呢?因為個人覺得第一種方式在相同的驗證條件下,更加易於維護和可以進行代碼重用。而且寫代碼的形式 更適 用於Laravel和我個人的使用習慣:可以使用命令行來生成代碼。也就是可以使用artisan這個工具:
php artisan make:request StoreArticleRequest
在項目目錄下使用artisan的make:request
命令就可以生成一個用於表單驗證Request
類了,這個類我們在這里命名為StoreArticleRequest
,你也可以以你自己喜歡的方式來命名,但我還是推薦大家在命名的時候盡量使得名字比較人性化一點,這樣會比較對於后期再看代碼的時候有很多好處。這個命令生成的文件位於app/Http/Requests/
這個文件夾當中,我們打開這個文件來看:
class StoreArticleRequest extends Request { /** * Determine if the user is authorized to make this request. * * @return bool */ public function authorize() { return false; } /** * Get the validation rules that apply to the request. * * @return array */ public function rules() { return [ // ]; } }
實現驗證
可以看到里面會有兩個方法:authorize()
和 rules()
。authorize()
可以這樣簡單地理解:我們在處理這個表單請求(通常是一個post請求)的時候是否是需要進行身份驗證,這種驗證是指:比如A發表的評論,B能不能進行編輯。如果不能,則保留返回false
,如果可以,則修改返回true
。那么我們這里的邏輯是:既然是發表文章,在我們這個站點注冊的用戶(如果開放注冊的話)都是可以發表文章的,所以我們首先修改authorize()
方法,將其返回值改為:return true;
。
然后對於rules()
方法,我們需要在這里設置我們的驗證規則,比如我們可以設置下面這個的驗證規則:
public function rules() { return [ 'title' => 'required', 'content' => 'required' ]; }
因為我們在創建文章的時候,我們會有兩個提交過來的字段:title
和content
。這是我們在設計articles
表的時候設置的兩個字段。
然后,上面的驗證規則是:對於title
和content
兩個字段,我們需要用戶為其填充內容,不能為空。
既然這里的規則設置好之后,我們該怎么應用起來呢?也就是我們怎么在將文章存入數據庫之前進行驗證呢?很簡單,我們只需要稍微修改ArticleController
的store()
方法:
public function store(Requests\StoreArticleRequest $request) { $input = $request->all(); //下面增加兩行,順便看看Request::get的使用 $input['intro'] = mb_substr($request->get('content'),0,64); }
我們將整個StoreArticleRequest
類的實例以$request
變量傳入store()
方法,這個時候,laravel 就會自動檢查我們是否需要進行表單驗證(rules方法有沒有定義驗證規則),如果有需要驗證的話,laravel會首先走驗證這條路,如果驗證沒有通過,store()
方法內的代碼不會被執行,而是直接跳轉到提交表單的頁面,這里是:http://blog.dev/article/create 這個頁面。如果所有的驗證都通過之后,才會執行store()
內部的代碼,也就是才會執行到$input = $request->all()
;這里以及往下的代碼。。。比如我們來試試留空的時候是什么樣的情況:
##反饋錯誤
上面的圖片中好像沒有什么變化,但其實是已經提交了一次了,但是又馬上跳轉回來了。我們可以使用下面的方式來驗證一下:
@if($errors->any()) <ul class="alert alert-danger"> @foreach($errors->all() as $error) <li>{{ $error }}</li> @endforeach </ul> @endif
在create.blade.php
這個視圖文件中增加上面的代碼,我這里是放在{!! Form::close() !!}
后面。這里的意思大概就是,如果有任何表單驗證的錯誤消息,我們就講這個信息打印出來反饋給用戶。如果沒有,則不會顯示信息。我們再來試一下:
這時候可以看到,我們在表單驗證沒有通過的時候,在頁面顯示了相對應的錯誤信息。如果沒有錯誤,就創建一篇文章。
tips:如果你不想錯誤信息為英文,可以到resources/lang/en/validation.php
修改,或者你直接創建一個新的語言文件包。
多個驗證規則
OK,這里,我們基本是將這個這個驗證流程走通了。但是,在實際的開發中,我們的驗證並不都是這個簡單:要是我們要對一個字段設置多個驗證規則呢?比如我們希望文章的title
最少不能少於三個字節長度呢?我們可以這樣,在rules()
方法中:
'title' => 'required|min:3',
在laravel中,我們使用|
將多個規則分開,:
表示規則的值。其實這里你也可以使用數組的,但是我還是推薦大家像上面這樣寫,簡潔明了。
其他常用驗證規則
至於更多地驗證規則,比如注冊的時候,驗證一個email
和確認密碼的時候,我們怎么需要怎么寫的呢?
'email'=>'required|email', 'password'=>'required|min:6|confirmed', 'password_confirmation' => 'required|min:6'
上面我直接給出這兩個常用場景的最常見的寫法,email
就代表驗證所填的信息是否是一個正確地郵箱格式了,至於確認密碼就使用confirmed
來指定,這里注意是confirmed
而不是confirme
。而且第二次輸入密碼的字段需要寫成password_confirmation
這個形式,也就是在視圖中,我們會有類似這樣的input表單:
<input type="password" name="password" /> <input type="password" name="password_confirmation" />
關於更多驗證規則,參考官方文檔:
http://laravel.com/docs/5.1/validation
使用Validation
使用這個之前可以將
store(Requests\StoreArticleRequest $request)
中的變量去掉
使用Validation的時候,多用於驗證一些簡單的表單驗證。這里演示直接寫於ArticleController
當中,直接使用Validator::make()
,使用方式為Validator::make(array $request,array $rules)
,比如說我們的例子可以在store()
中寫成:
$input = Request::all(); $validator = Validator::make($input, [ 'title' => 'required|min:3', 'body' => 'required', ]);
然后可以使用下面這樣的方式來檢查驗證有沒有通過:
if ($validator->fails()) { }
驗證通過之后,我們才進行下一步操作,比如將數據存入數據庫。一個基本的Validation流程就完成了,而且關於Validation的部分,我也只想介紹到這里,因為我會安利大家使用第一種方式:Request。
tips:這兩種方式的背后都是使用一樣的驗證機制。
##總結
這里就基本將基礎的表單驗證說完了,下一節我准說說queryScope和SetAttributes的使用,這兩個對於我們的數據入庫的預處理和代碼重用都很有幫助,所以下次會先說這兩個知識點:我們會先對published_at這個字段的設置和使用發揮出來,到時候你就知道設置這個字段的好處了。
最后:Happy Hacking