FuelPHP 高級(jí)表單編程

fuelphp 高級(jí)表單編程

fuelphp 通過 fieldset 和 fieldset_field 類提供高級(jí)表單編程。 fieldset 提供了一種面向?qū)ο蟮姆绞絹韯?chuàng)建表單。它完全支持模型。它還內(nèi)置了對(duì)客戶端和服務(wù)器端驗(yàn)證的支持。要?jiǎng)?chuàng)建一個(gè)完整的表單，創(chuàng)建一個(gè)具有適當(dāng)表單和驗(yàn)證設(shè)置的模型就足夠了。讓我們?cè)诒菊轮辛私?fieldset 類以及如何使用它創(chuàng)建表單。

字段集

fieldset 是 fieldset_field 對(duì)象的集合。 fieldset_field 定義了表單的單個(gè)條目，例如名字、姓氏等以及驗(yàn)證。 fieldset 類具有添加/編輯/刪除字段的方法。它具有識(shí)別模型中定義的字段并從給定模型創(chuàng)建字段的選項(xiàng)。 fieldset 在后臺(tái)使用 form 和 validation 類來做真正的工作。讓我們看看 fieldset 類的一些重要方法。

forge

forge 創(chuàng)建一個(gè)新的 fieldset 實(shí)例。它有以下兩個(gè)參數(shù)：

$name-字段集的標(biāo)識(shí)符
$config-配置數(shù)組?？赡艿倪x項(xiàng)是 validation_instance 和 form_instance。 validation_instance 可以有 validation 對(duì)象，form_instance 可以有 form 對(duì)象。

$employee_form = fieldset::forge('employee');

實(shí)例

instance 通過標(biāo)識(shí)符返回之前創(chuàng)建的 fieldset 實(shí)例。

$employee_form = fieldset::instance('employee');

get_name

獲取字段集實(shí)例的標(biāo)識(shí)符。

$employee_form = fieldset::forge('employee'); 
$name = $employee_form->get_name();

add

add 創(chuàng)建一個(gè)新的 fieldset_field 實(shí)例并將其添加到當(dāng)前字段集。它包含以下四個(gè)參數(shù)，

$name-字段名稱
$label-字段標(biāo)簽
$attributes-html 標(biāo)簽屬性
$rules-驗(yàn)證規(guī)則

$employee_field = $employee_form-> add (
   'employee_lastname', 
   'lastname', 
   array ('class' => 'pretty_input')
);  
// with validation rules 
$employee_form->add ( 
   'email', 'e-mail', 
   array('type' => 'email', 'class' => 'pretty_input'), 
   array('required', 'valid_email') 
);

add_before

add_before 與 add 類似，只是它有一個(gè)額外的參數(shù)來指定新創(chuàng)建的字段將添加到哪個(gè)字段之前。

$employee_form->add_before (
   'employee_firstname', 
   'firstname', 
   array ('class' => 'pretty_input'), 
   array(), 
   'employee_lastname'
);

delete

delete 從字段集中刪除指定的字段。

$employee_form->delete('employee_firstname');

field

field 從字段集中獲取所有字段或指定的字段。

$fields = $employee_form->field(); 
$lastname_field = $employee_form->field('employee_lastname');

build

build 是 $this->form()->build() 的別名。生成表單的 html 標(biāo)記。

$employee_form->build(uri::create('employee/add'));

enable

enable 重新啟用先前已禁用的字段。

$employee_form->enable('employee_firstname');

disable

disable 允許禁止構(gòu)建字段集中的字段。

$employee_form->disable('employee_firstname');

form

form 返回當(dāng)前字段集的 form 實(shí)例。

$form = employee_form->form();

add_model

add_model 將模型的字段添加到字段集中。它有以下三個(gè)參數(shù)，

$class-類名
$instance-用值填充字段的類的實(shí)例
$method-類中方法的名稱。此方法用于將字段添加到字段集中。 orm\model 具有所需的方法。默認(rèn)方法名稱是 set_form_fields。

$employee_form = fieldset::forge('employee'); 
$employee_form->add_model('model_employee');

populate

populate 使用模型實(shí)例設(shè)置字段集中字段的初始值。

$emp = new model_employee(); 
$emp->name = "jon"; 
$employee_form->populate($emp);

repopulate

repopulate 與 populate 相同，只是它重新填充字段集中的字段。

validation

validation 獲取當(dāng)前字段集的驗(yàn)證實(shí)例。

$validation = $employee_form->validation();

validated

$this->validation()->validated() 的別名。

input

$this->validation()->input() 的別名。

error

$this->validation()->error() 的別名。

show_errors

$this->validation()->show_errors() 的別名。

工作示例

讓我們創(chuàng)建一個(gè)高級(jí)表單，使用 fieldset 類在我們的示例員工應(yīng)用程序中添加新員工。

更新模型

使用必要的驗(yàn)證規(guī)則更新員工模型，并按如下方式添加驗(yàn)證觀察者。

  
   class model_employee extends orm\model { 
      protected static $_connection = 'production'; 
      protected static $_table_name = 'employee'; 
      protected static $_primary_key = array('id'); 
      
      protected static $_properties = array ( 
         'id',  
         'name' =--> array ( 
            'data_type' => 'varchar',
            'label' => 'employee name', 
            'validation' => array ( 
               'required',  
               'min_length' => array(3),  
               'max_length' => array(80) 
            ), 
            'form' => array ( 
               'type' => 'text' 
            ), 
         ),  
         'age' => array ( 
            'data_type' => 'int', 
            'label' => 'employee age', 
            'validation' => array ( 
               'required',  
            ), 
            'form' => array ('type' => 'text' ), 
         ), 
      );  
      
      // just add the observer, and define the required event 
      protected static $_observers = array('orm\\observer_validation' => array ( 
         'events' => array('before_save'))); 
   }

這里，我們定義了 name 和 age 字段的驗(yàn)證規(guī)則，并添加了一個(gè)新的觀察者來執(zhí)行服務(wù)器端驗(yàn)證，然后將模型保存到數(shù)據(jù)庫(kù)中。相同的驗(yàn)證規(guī)則也會(huì)在表單中創(chuàng)建必要的輸入驗(yàn)證屬性。

創(chuàng)建表單

在員工控制器中創(chuàng)建新動(dòng)作 action_advancedform，如下所示。

public function action_advancedform() { 
   
   // create a new fieldset and add employee model
   $fieldset = fieldset::forge('employee')->add_model('model_employee');  
   
   // get form from fieldset 
   $form = $fieldset->form();  
   
   // add submit button to the form 
   $form->add('submit', '', array('type' => 'submit', 'value' => 'submit'));  
   
   // build the form  and set the current page as action  
   $formhtml = $fieldset->build(uri::create('employee/advancedform'));  
   
   // set form in data 
   $data = array(); 
   $data['form'] = $formhtml;  
   return response::forge(view::forge('employee/advancedform', $data, false)); 
}

在這里，我們使用 fieldset 創(chuàng)建了表單并將表單發(fā)送到視圖。接下來，為動(dòng)作添加視圖， fuel/app/views/employee/advancedform.php，如下所示。

 
 
   
    
      <title>employee :: add page</title> 
      <meta charset="utf-8"> 
      <meta name="viewport" content="width = device-width, initial-scale = 1"> 
       echo asset::css('bootstrap.css');  
      
      <style>  
         table { 
            width: 90%; 
         }  
         table tr { 
            width: 90% 
         }
         table tr td { 
            width: 50% 
         }  
         input[type = text], select { 
            width: 100%; 
            padding: 12px 20px; 
            margin: 8px 0; 
            display: inline-block; 
            border: 1px solid #ccc; 
            border-radius: 4px; 
            box-sizing: border-box; 
         }  
         input[type = submit] { 
            width: 100%; 
            background-color: #3c3c3c; 
            color: white; 
            padding: 14px 20px; 
            margin: 8px 0; 
            border: none; 
            border-radius: 4px; 
            cursor: pointer; 
         }  
         div { 
            border-radius: 5px; 
            background-color: #f2f2f2; 
            padding: 20px; 
         } 
      </style>
 
    
   
    
       
         
            if(isset($errors)) { 
               echo $errors; 
            } 
            echo $form;

現(xiàn)在，請(qǐng)求頁(yè)面 http://localhost:8080/employee/add 將顯示以下表單。

流程表格

更新action方法， action_advancedform來處理表單，將用戶輸入的員工數(shù)據(jù)添加到員工控制器的數(shù)據(jù)庫(kù)中，如下所示。

public function action_advancedform() { 
   
   // create a new fieldset and add employee model 
   $fieldset = fieldset::forge('employee')->add_model('model_employee');  
   
   // get form from fieldset 
   $form = $fieldset->form();  
   
   // add submit button to the form 
   $form->add('submit', '', array('type' => 'submit', 'value' => 'submit')); 
   
   // build the form  and set the current page as action  
   $formhtml = $fieldset->build(uri::create('employee/advancedform'));  
   
   if (input::param() != array()) { 
      try { 
         $article = model_employee::forge(); 
         $article->name = input::param('name'); 
         $article->url = input::param('age'); 
         $article->save(); 
         response::redirect('employee/list'); 
      
      } 
      catch (orm\validationfailed $e) { 
         $view = view::forge('employee/advancedform'); 
         $view->set('form', $formhtml, false); 
         $view->set('errors', $e->getmessage(), false); 
      } 
   } 
   
   return response::forge($view); 
}

在這里，我們被重定向到員工列表頁(yè)面，一旦用戶輸入的數(shù)據(jù)被驗(yàn)證并保存到數(shù)據(jù)庫(kù)中。否則，我們將再次顯示該表單。

創(chuàng)建表單

現(xiàn)在，請(qǐng)求 url， http://localhost:8080/employee/add 并輸入一些員工數(shù)據(jù)并提交表單。如果未提供數(shù)據(jù)，則表單將提示用戶輸入數(shù)據(jù)，如下面的屏幕截圖所示。

如果用戶繞過客戶端驗(yàn)證，則服務(wù)器將驗(yàn)證表單并顯示錯(cuò)誤，如下面的屏幕截圖所示。

如果數(shù)據(jù)通過客戶端和服務(wù)器端驗(yàn)證，那么員工數(shù)據(jù)將被保存到數(shù)據(jù)庫(kù)中，頁(yè)面被重定向到列表頁(yè)面。

下一節(jié)：fuelphp 文件上傳

fuelphp 教程

相關(guān)文章

PHP實(shí)戰(zhàn)