攏簍6攏漏脢盲脠毛潞脥脩茅脰隴 · tp5文檔

現在我們來進一步使用表單提交數據完成模型的對象操作，主要內容包含： - - [表單提交](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147289#u8868u5355u63D0u4EA4) - [表單驗證](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147289#u8868u5355u9A8Cu8BC1) - [錯誤提示](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147289#u9519u8BEFu63D0u793A) - [自定義驗證規則](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147289#u81EAu5B9Au4E49u9A8Cu8BC1u89C4u5219) - [控制器驗證](http://www.hmoore.net/thinkphp/thinkphp5_quickstart/147289#u63A7u5236u5668u9A8Cu8BC1) ## 表單提交首先創建一個視圖模板文件 `application/index/view/user/create.html`，內容如下： ``` <pre class="calibre18"> ``` <!doctype html><html><head><meta charset="UTF-8"><title>創建用戶</title><style>body { font-family:"Microsoft Yahei","Helvetica Neue",Helvetica,Arial,sans-serif; font-size:16px; padding:5px; }.form{ padding: 15px; font-size: 16px; }.form .text { padding: 3px; margin:2px 10px; width: 240px; height: 24px; line-height: 28px; border: 1px solid #D4D4D4; }.form .btn{ margin:6px; padding: 6px; width: 120px; font-size: 16px; border: 1px solid #D4D4D4; cursor: pointer; background:#eee; }a{ color: #868686; cursor: pointer; }a:hover{ text-decoration: underline; } h2{ color: #4288ce; font-weight: 400; padding: 6px 0; margin: 6px 0 0; font-size: 28px; border-bottom: 1px solid #eee; }div{ margin:8px; }.info{ padding: 12px 0; border-bottom: 1px solid #eee; }.copyright{ margin-top: 24px; padding: 12px 0; border-top: 1px solid #eee; }</style></head><body><h2>創建用戶</h2><FORM method="post" class="form" action="{:url('index/user/add')}"> 昵稱：<INPUT type="text" class="text" name="nickname"><br/> 郵箱：<INPUT type="text" class="text" name="email"><br/> 生日：<INPUT type="text" class="text" name="birthday"><br/><input type="hidden" name="__token__" value="{$Request.token}" /><INPUT type="submit" class="btn" value=" 提交 "></FORM><div class="copyright"><a title="官方網站" href="http://www.thinkphp.cn">ThinkPHP</a><span>V5</span><span>{ 十年磨一劍-為API開發設計的高性能框架 }</span></div></body></html> ``` ``` User控制器增加新的操作方法`create`如下： ``` <pre class="calibre18"> ``` // 創建用戶數據頁面public function create(){ return view(); } ``` ``` `view`方法是系統封裝的助手函數用于快速渲染模板文件，這里沒有傳入模板文件，則按照系統默認的解析規則會自動渲染當前操作方法對應的模板文件，也就是默認視圖目錄（`application/index/view`）下面的`user/create.html`文件，所以如果改成下面的方式是相同的： ``` <pre class="calibre18"> ``` // 創建用戶數據頁面public function create(){ return view('user/create'); } ``` ``` 并且修改之前的`add`方法如下： ``` <pre class="calibre18"> ``` // 新增用戶數據public function add(){ $user = new UserModel; if ($user->allowField(true)->save(input('post.'))) { return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } else { return $user->getError(); } } ``` ``` > #### 注意 > > - - - - - - > > 這里使用`allowField(true)`是為了避免表單令牌驗證的字段被寫入數據表，如果你已經在模型里面定義了field屬性的話，可以不需要。我們訪問URL地址： ``` <pre class="calibre18"> ``` http: //tp5.com/user/create ``` ``` 頁面輸出如圖： ![](https://img.kancloud.cn/f8/e3/f8e34e6389cb4323a94410c2d84bd574_644x364.png) 輸入用戶信息后，點擊提交按鈕： ![](https://img.kancloud.cn/02/9a/029a16213a903f640c9e306aed5b3129_654x362.png) 頁面顯示結果為： ``` <pre class="calibre18"> ``` 用戶[ 流年:30 ]新增成功 ``` ``` ## 表單驗證永遠不要相信用戶的數據，所以現在給表單提交添加數據驗證。我們添加一個`User`驗證器，如下： ``` <pre class="calibre18"> ``` <?php namespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ 'nickname' => 'require|min:5|token', 'email' => 'require|email', 'birthday' => 'dateFormat:Y-m-d', ]; } ``` ``` `User`驗證器添加了三個屬性的驗證規則，分別表示： - 昵稱必須，而且最小長度為5 - 郵箱必須，而且必須是合法的郵件地址 - 生日可選，如果填寫的話必須為 `Y-m-d`格式的日期格式對屬性可以使用多個驗證規則，除非使用了`require`開頭的規則，否則所有的驗證都是可選的（也就是說有值才驗證），多個驗證之間用`|`分割，并且按照先后順序依次進行驗證，一旦某個規則驗證失敗，后續的規則就不會再進行驗證（除非設置批量驗證方式則統一返回所有的錯誤信息）。更多的內置規則可以參考完全開發手冊的[內置規則](http://www.hmoore.net/manual/thinkphp5/129356)一節。如果我們的驗證規則里面使用了`|`，為了避免混淆則必須用數組方式定義驗證規則，驗證規則定義修改如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ 'nickname' => ['require', 'min'=>5, 'token'], 'email' => ['require', 'email'], 'birthday' => ['dateFormat' => 'Y|m|d'], ]; } ``` ``` 然后對控制器的`add`方法則稍加修改，在`save`方法之前添加一個`validate`方法即可： ``` <pre class="calibre18"> ``` // 新增用戶數據public function add(){ $user = new UserModel; if ($user->allowField(true)->validate(true)->save(input('post.'))) { return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } else { return $user->getError(); } } ``` ``` 當我們沒有輸入任何表單數據就直接提交的話，頁面會輸出結果： ``` <pre class="calibre18"> ``` nickname不能為空 ``` ``` 當我們輸入昵稱為`wo`的時候點擊提交 ![](https://img.kancloud.cn/31/fb/31fb0c11efa60349efb95cbcc5d713fe_640x366.png) 頁面輸出結果為： ``` <pre class="calibre18"> ``` nickname長度不能小于 5 ``` ``` 當輸入一個錯誤的郵箱格式后提交 ![](https://img.kancloud.cn/74/07/7407dbf4585df5326c778c2c63bc7f52_672x363.png) 頁面提示錯誤信息為： ``` <pre class="calibre18"> ``` email格式不符 ``` ``` 當輸入一個 1990/08/09 的生日時候 ![](https://img.kancloud.cn/57/25/5725d53d0fb53af1dfef73fe1a61b0cb_674x362.png) 頁面提示的錯誤信息是： ``` <pre class="calibre18"> ``` birthday必須使用日期格式：Y-m-d ``` ``` ## 錯誤提示目前為止，提示的錯誤信息都是系統默認的，接下來我們來定義提示信息。首先，如果只是希望修改屬性名稱的話，可以直接使用下面的驗證規則定義方式： ``` <pre class="calibre18"> ``` <?php namespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ 'nickname|昵稱' => 'require|min:5', 'email|郵箱' => 'require|email', 'birthday|生日' => 'dateFormat:Y-m-d', ]; } ``` ``` 現在我們提交一個錯誤的郵箱， ![](https://img.kancloud.cn/2d/67/2d67370c41637ecf2209ff0982e5df10_626x362.png) 提示的錯誤信息為： ``` <pre class="calibre18"> ``` 郵箱格式不符 ``` ``` 輸入錯誤的生日格式的時候，提示的錯誤信息為： ``` <pre class="calibre18"> ``` 生日必須使用日期格式：Y-m-d ``` ``` 如果希望完整定義錯誤提示信息的話，可以使用： ``` <pre class="calibre18"> ``` <?php namespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ ['nickname', 'require|min:5', '昵稱必須|昵稱不能短于5個字符'], ['email', 'email', '郵箱格式錯誤'], ['birthday', 'dateFormat:Y-m-d', '生日格式錯誤'], ]; } ``` ``` 現在我們提交一個錯誤的郵箱，提示的錯誤信息為： ``` <pre class="calibre18"> ``` 郵箱格式錯誤 ``` ``` 提交一個錯誤的生日格式后，提示的錯誤信息變成： ``` <pre class="calibre18"> ``` 生日格式錯誤 ``` ``` 系統提供了豐富的內置驗證規則，具體可以參考完全開發手冊。 ## 自定義驗證規則系統的驗證規則可以滿足大部分的驗證場景，但有時候我們也需要自定義特殊的驗證規則，例如我們需要驗證郵箱必須為`thinkphp.cn`域名的話，可以在`User`驗證器中添加驗證規則如下： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ ['nickname', 'require|min:5', '昵稱必須|昵稱不能短于5個字符'], ['email', 'checkMail:thinkphp.cn', '郵箱格式錯誤'], ['birthday', 'dateFormat:Y-m-d', '生日格式錯誤'], ]; // 驗證郵箱格式是否符合指定的域名protected function checkMail($value, $rule){ return 1 === preg_match('/^\w+([-+.]\w+)*@' . $rule . '$/', $value); } } ``` ``` 自定義驗證規則也支持返回動態的錯誤信息，只需要在驗證方法里面返回錯誤信息字符串即可，例如： ``` <pre class="calibre18"> ``` <?phpnamespace app\index\validate; use think\Validate; class User extends Validate{ // 驗證規則protected $rule = [ ['nickname', 'require|min:5', '昵稱必須|昵稱不能短于5個字符'], ['email', 'checkMail:thinkphp.cn', '郵箱格式錯誤'], ['birthday', 'dateFormat:Y-m-d', '生日格式錯誤'], ]; // 驗證郵箱格式是否符合指定的域名protected function checkMail($value, $rule){ $result = preg_match('/^\w+([-+.]\w+)*@' . $rule . '$/', $value); if (!$result) { return '郵箱只能是' . $rule . '域名'; } else { return true; } } } ``` ``` 如果輸入了一個不是`thinkphp.cn`域名的郵箱地址，會提示如下錯誤信息： ``` <pre class="calibre18"> ``` 郵箱只能是thinkphp.cn域名 ``` ``` ## 控制器驗證前面我們講了在模型中使用驗證器進行數據驗證的方法，下面來講下如何在控制器中進行數據驗證。驗證器類的定義不變，現在修改下控制器類： ``` <pre class="calibre18"> ``` namespace app\index\controller; use app\index\model\User as UserModel; use think\Controller; class User extends Controller{ // 創建用戶數據頁面public function create(){ return view(); } public function add(){ $data = input('post.'); // 數據驗證$result = $this->validate($data,'User'); if (true !== $result) { return $result; } $user = new UserModel; // 數據保存$user->allowField(true)->save($data); return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } } ``` ``` 然后訪問 ``` <pre class="calibre18"> ``` http: //tp5.com/user/create ``` ``` 當輸入一個錯誤的郵箱格式后提交 ![](https://img.kancloud.cn/74/07/7407dbf4585df5326c778c2c63bc7f52_672x363.png) 頁面提示錯誤信息為： ``` <pre class="calibre18"> ``` email格式不符 ``` ``` 如果有一些個別的驗證沒有在驗證器里面定義，也可以使用靜態方法單獨處理，例如下面對birthday字段單獨驗證是否是一個有效的日期格式： ``` <pre class="calibre42"> ``` namespace app\index\controller; use app\index\model\User as UserModel; use think\Controller; use think\Validate; class User extends Controller{ // 創建用戶數據頁面public function create(){ return view(); } public function add(){ $data = input('post.'); // 驗證birthday是否有效的日期$check = Validate::is($data['birthday'],'date'); if (false === $check) { return 'birthday日期格式非法'; } $user = new UserModel; // 數據保存$user->save($data); return '用戶[ ' . $user->nickname . ':' . $user->id . ' ]新增成功'; } } ``` ```