本文實例講述了yii 框架使用forms操作。分享給大家供大家參考,具體如下:
創建模型
模型類 entryform
代表從用戶那請求的數據, 該類如下所示并存儲在 models/entryform.php
文件中。請參考類自動加載章節獲取更多關于類命名約定的介紹。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
<?php namespace app\models; use yii; use yii\base\model; class entryform extends model { public $name ; public $email ; public function rules() { return [ [[ 'name' , 'email' ], 'required' ], [ 'email' , 'email' ], ]; } } |
該類繼承自yii 提供的一個基類 yii\base\model, 該基類通常用來表示數據。
entryform
類包含 name
和 email
兩個公共成員, 用來儲存用戶輸入的數據。它還包含一個名為 rules()
的方法, 用來返回數據驗證規則的集合。上面聲明的驗證規則表示:
-
name
和email
值都是必須的 -
email
的值必須滿足email規則驗證
如果你有一個處理用戶提交數據的 entryform
對象, 你可以調用它的 validate() 方法觸發數據驗證。 如果有數據驗證失敗,將把 haserrors 屬性設為 ture, 想要知道具體發生什么錯誤就調用 geterrors。
1
2
3
4
5
6
7
8
9
10
|
<?php $model = new entryform(); $model ->name = 'qiang' ; $model ->email = 'bad' ; if ( $model ->validate()) { // 驗證成功! } else { // 失敗! // 使用 $model->geterrors() 獲取錯誤詳情 } |
創建動作
下面你得在 site
控制器中創建一個 entry
操作用于新建的模型。 操作的創建和使用已經在說一聲你好小節中解釋了。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
<?php namespace app\controllers; use yii; use yii\web\controller; use app\models\entryform; class sitecontroller extends controller { // ...現存的代碼... public function actionentry() { $model = new entryform; if ( $model ->load(yii:: $app ->request->post()) && $model ->validate()) { // 驗證 $model 收到的數據 // 做些有意義的事 ... return $this ->render( 'entry-confirm' , [ 'model' => $model ]); } else { // 無論是初始化顯示還是數據驗證錯誤 return $this ->render( 'entry' , [ 'model' => $model ]); } } } |
該操作首先創建了一個 entryform
對象。然后嘗試從 $_post
搜集用戶提交的數據, 由 yii 的 yii\web\request::post() 方法負責搜集。 如果模型被成功填充數據(也就是說用戶已經提交了 html 表單), 操作將調用 validate() 去確保用戶提交的是有效數據。
信息: 表達式
yii::$app
代表應用實例,它是一個全局可訪問的單例。 同時它也是一個服務定位器, 能提供request
,response
,db
等等特定功能的組件。 在上面的代碼里就是使用request
組件來訪問應用實例收到的$_post
數據。
用戶提交表單后,操作將會渲染一個名為 entry-confirm
的視圖去確認用戶輸入的數據。 如果沒填表單就提交,或數據包含錯誤(譯者:如 email 格式不對), entry
視圖將會渲染輸出,連同表單一起輸出的還有驗證錯誤的詳細信息。
創建視圖
最后創建兩個視圖文件 entry-confirm
和 entry
。 他們會被剛才創建的 entry
操作渲染。
entry-confirm
視圖簡單地顯示提交的 name 和 email 數據。視圖文件應該保存在 views/site/entry-confirm.php
。
1
2
3
4
5
6
7
8
9
|
<?php use yii\helpers\html; ?> <p>you have entered the following information:</p> <ul> <li><label>name</label>: <?= html::encode( $model ->name) ?></li> <li><label>email</label>: <?= html::encode( $model ->email) ?></li> </ul> |
entry
視圖顯示一個 html 表單。視圖文件應該保存在 views/site/entry.php
。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
<?php use yii\helpers\html; use yii\widgets\activeform; ?> <?php $form = activeform::begin(); ?> <?= $form ->field( $model , 'name' ) ?> <?= $form ->field( $model , 'email' ) ?> <div class = "form-group" > <?= html::submitbutton( 'submit' , [ 'class' => 'btn btn-primary' ]) ?> </div> <?php activeform:: end (); ?> |
視圖使用了一個功能強大的小部件 ActiveForm 去生成 HTML 表單。 其中的 begin() 和 end() 分別用來渲染表單的開始和關閉標簽。 在這兩個方法之間使用了 field() 方法去創建輸入框。 第一個輸入框用于 “name”,第二個輸入框用于 “email”。 之后使用 yii\helpers\Html::submitButton() 方法生成提交按鈕。
用瀏覽器訪問下面的 url 看它能否工作:
http://hostname/index.php?r=site/entry
數據首先由客戶端 javascript 腳本驗證,然后才會提交給服務器通過 php 驗證。 yii\widgets\activeform 足夠智能到把你在 entryform
模型中聲明的驗證規則轉化成客戶端 javascript 腳本去執行驗證。 如果用戶瀏覽器禁用了 javascript, 服務器端仍然會像 actionentry()
方法里這樣驗證一遍數據。這保證了任何情況下用戶提交的數據都是有效的。
警告: 客戶端驗證是提高用戶體驗的手段。 無論它是否正常啟用,服務端驗證則都是必須的,請不要忽略它。
輸入框的文字標簽是 field()
方法生成的,內容就是模型中該數據的屬性名。 例如模型中的 name
屬性生成的標簽就是 name
。
你可以在視圖中自定義標簽 按如下方法:
1
2
|
<?= $form ->field( $model , 'name' )->label( '自定義 name' ) ?> <?= $form ->field( $model , 'email' )->label( '自定義 email' ) ?> |
信息: yii 提供了相當多類似的小部件去幫你生成復雜且動態的視圖。 在后面你還會了解到自己寫小部件是多么簡單。 你可能會把自己的很多視圖代碼轉化成小部件以提高重用,加快開發效率。
希望本文所述對大家基于Yii框架的PHP程序設計有所幫助。
原文鏈接:https://blog.csdn.net/qq_42176520/article/details/82431341