CakePHP Framework: Kiểm tra tính hợp lệ của dữ liệu (data validation)

CakePHP Framework: Kiểm tra tính hợp lệ của dữ liệu (data validation) Data Validation là một trong những thành phần không thể thiếu trong hầu hết các ứng dụng web. Nó giúp cho các dữ liệu được đảm bảo được kiểm tra chặt chẽ trước khi chèn vào CSDL. Cũng như CodeIgniter, Zend ,CakePHP cũng có chức năng Data Validation .Bài viết sẽ hướng dẫn cho người dùng cách sử dụng tập luật và ứng dụng chúng trong các trường hợp cụ thể khác nhau với các hàm hổ trợ sẵn của CakePHP. A- Cách làm việc của Datavalidation : Để sử dụng Datavalidation thì trong ứng dụng của chúng ta cần có hai thành phần chính : + Thành phần form helper : sử dụng cho việc tạo form 1 <?php 2 var $helpers = array ('Html','Form'); 3 ?> + Thành phần namespace validate : sử dụng các tập luật để validation dữ liệu 1 <?php 2 var $validate = array(tập_luật); 3 ?> B.Cài đặt Cakephp và viết ứng dụng datavalidation : Việc thực hiện cài đặt CakePHP là không khó. Nếu bạn vẫn chưa biết làm thì có thể (Xem lại bài CakePHP Framework cho người mới bắt đầu). Các thý mục cần chuẩn bị : - app/controllers/valids_controller.php - app/model/valid.php - app/views/valids/ Chuẩn bị cho Controller Valids : (app/controllers/valids_controller.php) 1 <?php 2 class ValidsController extends AppController{ 3 var $name = "Valids"; 4 var $helpers = array ('Html','Form'); 5 var $components = array('Session'); // Use Flash messenger of Session component 6 ?> Chuẩn bị cho Controller Valids : (app/models/valid.php) 1 <?php 2 class valid extends AppModel{ 3 var $useTable = false; // không sử dụng table valid ðồng nghĩa là không sử dụng database 4 var $validate = array(); // name space mặc ðịnh khi sử dụng datavalidation 5 ?> Trong ví dụ này các ứng dụng không chèn dữ liệu vào database mà chỉ thông báo có hợp lệ hay không và báo lỗi týõng ứng . Nên trong Model tôi dùng namespace là var $useTable = false; để ám chỉ là không sử dụng bảng CSDL C. Sử dụng 1 tập luật cho 1 field - Yêu cầu tạo 1 form nhập liệu với 2 field với các tập luật được mô tả : - title : không được phép rỗng - info : không được phép rỗng Trong Controller Valid ta thêm hàm demo01 : 01 <?php 02 class ValidsController extends AppController{ 03 var $name = "Valids"; 04 var $helpers = array ('Html','Form'); 05 var $components = array('Session'); // Use Flash messenger of Session component 06 // ---- Valid one rule 07 function demo01(){ 08 $this->Valid->set($this->data); 09 if($this->Valid->valid_01()==TRUE){ 10 $this->Session->setFlash("Data is avaliable !"); 11 }else{ 12 $this->Session->setFlash("Data is not avaliable !"); 13 } 14 } 15 ?> Chức năng validation sẽ được kích hoạt khi ta dùng hàm $this->Valid- >set($this->data); Sau đó Model Valid gọi hàm valid_01() để sử dụng tập luật cho các field tương ứng (title,info) Trong thư mục app/views/valids/ tạo file demo01.ctp : 1 Add Post 2 <?php 3 echo $this->Form->create('Valid', array('action' => 'demo01')); 4 echo $this->Form->input('title'); 5 echo $this->Form->input('info'); 6 echo $this->Form->end('Register'); 7 ?> + Để validate dữ liệu ta dùng namespace validate ($this->validate) để gán tập luật cho các field + Với rule là từ khóa để chỉ đó là tập luật và notEmpty là từ khóa để nói là không được rỗng + Trong 1 số tài liệu ngýời ta có thể dùng từ khóa VALID_NOT_EMPTY ðể thay cho từ khóa notEmpty + Message là từ khóa để chỉ thông báo lỗi $this->validates($this->validate) //hàm kiểm tra các tập luật Các từ được coi từ khóa thì phải viết đúng tên và giữ nguyên nội dung của từ. Chạy thử ứng dụng đầu tiên : Một số tập luật thông dụng : § 'rule' => 'alphaNumeric' : chỉ có số hoặc chữ § 'rule' => array('between', 5, 15) : giá trị nằm trong khoản từ 5-15 § 'rule' => array('comparison', '>=', 18) : giá trị phải lớn hõn 18 § 'rule' => array('email', true) : định dạng email § 'rule' => array('extension', array('gif', 'jpeg', 'png', 'jpg')) : dành cho upload file , kiểm tra extension § 'rule' => array('minLength', 8) : độ dài nhỏ nhất là 8 § 'rule' => array('maxLength', 8) : độ dài tối đa là 8 § 'rule' => 'numeric' : dữ liệu nhập là số § 'rule' => 'notEmpty' : dữ liệu không được bỏ trống § 'rule' => 'url' : định dạng địa chỉ url D. Sử dụng nhiều tập luật cho 1 field Yêu cầu tạo 1 form nhập liệu với 3 field với các tập luật được mô tả : - Username : không được phép rỗng, tối đa là 10 kí tự, ít nhất là 4 kí tự - Email : không được phép rỗng, định dạng là email - website: không được phép rỗng, định dạng là địa chỉ url Trong Controller Valid ta thêm hàm demo02 : 01 <?php 02 class ValidsController extends AppController{ 03 var $name = "Valids"; 04 var $helpers = array ('Html','Form'); 05 var $components = array('Session'); // Use Flash messenger of Session component 06 // ---- Valid multi rules 07 function demo02(){ 08 $this->Valid->set($this->data); 09 if($this->Valid->valid_02()==TRUE){ 10 $this->Session->setFlash("Data is avaliable !"); 11 }else{ 12 $this->Session->setFlash("Data is not avaliable !"); 13 } 14 } 15 ?> Trong thý mục app/views/valids/ tạo file demo02.ctp : 1 Add Post 2 <?php 3 echo $this->Form->create('Valid', array('action' => 'demo02')); 4 echo $this->Form->input('username'); 5 echo $this->Form->input('email'); 6 echo $this->Form->input('website'); 7 echo $this->Form->end('Register'); 8 ?> Trong model Valid thêm hàm valid_02() : 01 <?php 02 class valid extends AppModel{ 03 var $useTable = false; 04 var $validate = array(); 05 //-------- Valid : Multi rule 06 function valid_02(){ 07 $this->validate = array( 08 "username"=>array( 09 "rule1" => array( 10 "rule" => "notEmpty", 11 "message" => "Username can not empty", 12 ), 13 "rule2" => array( 14 "rule" => array('minLength', 4), 15 "message" => "Usernames must be at least 4 characters long", 16 ), 17 "rule3" => array( 18 "rule" => array('maxLength', 10), 19 "message" => "Usernames must be no larger than 10 characters long", 20 ), 21 ), 22 "email" => array( 23 "rule1" => array( 24 "rule" => "notEmpty", 25 "message" => "Please enter email !", 26 ), 27 "rule2" => array( 28 "rule" => "email", 29 "message" => "Email not avaliable !", 30 ), 31 ), 32 "website" => array( 33 "rule1" => array( 34 "rule" => "notEmpty", 35 "message" => "Please enter website !", 36 ), 37 "rule2" => array( 38 "rule" => "url", 39 "message" => "website is not avaliable", 40 ), 41 ), 42 ); 43 if($this->validates($this->validate)) 44 return TRUE; 45 else 46 return FALSE; 47 } 48 ?> Chạy thử ứng dụng : E. Sử dụng tập luật bằng regular expression - Thông thường các rule có sẵn không đáp ứng được nhu cầu validation dữ liệu của chúng ta , với những ứng dụng phức tạp đòi hỏi khắc khe về việc nhập liệu thì Cakephp cũng có hổ trợ validation với Regular Expression. - Để sử dụng Regular Expression thì cú pháp như sau : 1 <?php 2 'rule' => '/^nội_dung_regular_expression$/i'; 3 ?> Ví dụ : + 'rule' => '/^[a-z0-9]{4,10}$/i' Dữ liệu chỉ là chữ thường và số, có từ 4-10 kí tự + 'rule' => '/^[a-z A-Z]{1}[a-z A-Z 0-9_]+@[a-z A-Z 0-9]{2,}.[a-z A- Z]{2,}$/i ' Kí tự đầu tiên chỉ là các kí tự chữ hoa hoặc thường Tiếp theo chỉ là các kí tự chữ hoa hoặc thường, số và dấu "_" , các kí tự này có thể xuất hiện hoặc xuất hiện nhiều lần Tiếp theo là kí tự bắt buộc phải có "@" Tiếp theo chỉ là các kí tự hoa hoặc thường và số , ít nhất là 2 kí tự Tiếp theo là kí tự bắt buộc phải có là "." Tiếp theo là các kí tự hoa hoặc thường , ít nhất là 2 kí tự Bắt đầu viết ứng dụng với 2 Regular Expression trên : - Yêu cầu tạo 1 form nhập liệu với 2 field với các tập luật được mô tả : - username : với Regular Expression thứ 1 - email : với Regular Expression thứ 2 Trong Controller Valid ta thêm hàm demo03 : 01 <?php 02 class ValidsController extends AppController{ 03 var $name = "Valids"; 04 var $helpers = array ('Html','Form'); 05 var $components = array('Session'); // Use Flash messenger of Session component 06 // ---- Valid with Regular Expression 07 function demo03(){ 08 $this->Valid->set($this->data); 09 if($this->Valid->valid_03()==TRUE){ 10 $this->Session->setFlash("Data is avaliable !"); 11 }else{ 12 $this->Session->setFlash("Data is not avaliable !"); 13 } 14 } 15 ?> Trong thý mục app/views/valids/ tạo file demo03.ctp : 1 Add Post 2 <?php 3 echo $this->Form->create('Valid', array('action' => 'demo03')); 4 echo $this->Form->input('username'); 5 echo $this->Form->input('email'); 6 echo $this->Form->end('Register'); 7 ?> Trong model Valid thêm hàm valid_03() : 01 <?php 02 class valid extends AppModel{ 03 var $useTable = false; 04 var $validate = array(); 05 //------- Valid : Use Regular Expresstion 06 function valid_03(){ 07 $this->validate = array( 08 "username" => array( 09 'rule' => '/^[a-z0-9]{4,10}$/i', 10 'message' => 'Username must be integer and alphabet, between 4-10 characters', 11 ), 12 "email" => array( 13 'rule' => '/^[a-z A-Z]{1}[a-z A-Z 0-9_]+@[a-z A-Z 0-9]{2,}.[a-z A- Z]{2,}$/i', 14 'message' => 'email not avaliable', 15 ), 16 ); 17 if($this->validates($this->validate)) 18 return TRUE; 19 else 20 return FALSE; 21 } 22 ?> Chạy thử ứng dụng : F. Sử dụng chức nãng callback function - Callback function ở đây có nghĩa là thay vì ta dùng các từ khóa có sẵn hoặc các Regular Expression , mà thay vào đó là tao viết 1 hàm nào đó để kiểm tra dữ liệu. - Thông thường Callback function sử dụng cho các ứng dụng như : § Kiểm tra username và pasword trước khi đãng nhập § So sánh các dữ liệu trong database § So sánh hai mật khẩu nhập có giống nhau không Bắt đầu viết ứng dụng với Call Back function : -Yêu cầu tạo 1 form nhập liệu với 1 field với các tập luật được mô tả : - Username : Không được rỗng, dữ liệu nhập vào hợp lệ là chuỗi "admin" nếu không thì báo lỗi, dùng hàm checkUsername để kiểm tra tính hợp lệ đó. Trong Controller Valid ta thêm hàm demo04 : 01 <?php 02 class ValidsController extends AppController{ 03 var $name = "Valids"; 04 var $helpers = array ('Html','Form'); 05 var $components = array('Session'); // Use Flash messenger of Session component 06 //------ Valid with call back function 07 function demo04(){ 08 $this->Valid->set($this->data); 09 if($this->Valid->valid_04()==TRUE){ 10 $this->Session->setFlash("Data is avaliable !"); 11 }else{ 12 $this->Session->setFlash("Data is not avaliable !"); 13 } 14 } 15 ?> Trong thý mục app/views/valids/ tạo file demo04.ctp : 1 Add Post 2 <?php 3 echo $this->Form->create('Valid', array('action' => 'demo04')); 4 echo $this->Form->input('username'); 5 echo $this->Form->end('Check'); 6 ?> Trong model Valid thêm hàm valid_04() và hàm checkUsername() 01 <?php 02 class valid extends AppModel{ 03 var $useTable = false; 04 var $validate = array(); 05 //------ Valid with call back function 06 function valid_04 (){ 07 $this->validate = array( 08 "username" => array( 09 'rule' => 'checkUsername', 10 'message' => 'Username is not avaliable', 11 ), 12 ); 13 if($this->validates($this->validate)) 14 return TRUE; 15 else 16 return FALSE; 17 } 18 //-------- Check Useranme 19 function checkUsername(){ 20 if($this->data['Valid']['username']=="admin"){ // so sánh dữ liệu nhập từ form có tên username 21 return true; 22 } 23 else{ 24 return false; 25 } 26 } 27 ?> Chạy thử ứng dụng :