rafayhingoro/vmodel-idiorm-extension

There is no license information available for the latest version (1.0.0) of this package.

Verification and extension for Idiorm/Paris

1.0.0 2017-03-19 19:26 UTC

Requires

• j4mie/idiorm: *
• j4mie/paris: *

Unknown License

• Abdul Rafay Hingoro

README

https://github.com/rafayhingoro/vmodel-idiorm-extension

Built on top of Idiorm & Paris.

Tested on PHP 5.4.0+ - may work on earlier versions with PDO and the correct database drivers.

Released under a MIT license.

Documentation

Setup Guide

1. Download release source code and move vmodel.php in your Models Directory

2. on any model where you want to use vmodel simply use extends like this

    <?php 
     class YourModelName extends VModel {
       //your code 
     }

3. for validating before save Model File YourModelName.php

   <?php 
    class YourModelName extends VModel {
        public $_isValid = true; //by default making it valid
        
        //fields which are in database
        public $_fields = array(
            'id',
            'name',
            'email',
            'contact_number',
            'description'
        );
        
        //adding rules for fields 
        protected $_rules = array(
            'category_id' => 'required',
            'name' => 'required',
            'email' => 'required|email',
            'contact_number' => 'required',
            'description' => 'required'
        );
    }
   ?>

   Controller File ControllerUser.php

    <?php 
    class ControllerUser {
         try {
         
            // $form is array of inputs here's an example 
            // $form['username'] = 'user1234';
            // $form['password'] = 'mySecretPassword';
            // $form['email'] = '[e-mail]';
            // ... 
           
             $oModel = Model::factory("YourModelName")->create();
             $oModel->validateForm($form); //throws exception if form is not valid
             ...
         } catch (Exception $ex) {
            $ex->getMessage(); //validation error will be available here 
         }
     }

Validation Modal

class Item extends VModel {
    public $_fields = array(
        'id',
        'shop_id',
        'cat_id',
        'name',
        'description',
        'price',
        'created_on',
        'created_by',
        'updated_by',
        'updated_on'
    );
    public $_rules = array(
        'shop_id' => 'required',
        'cat_id'     => 'required|int',
        'name'       => 'required',
        'description' => 'required|limit<500',
        'price'       => 'required|int'
    );
}
$form = array(
    'shop_id' => 23,
    'cat_id' => 12,
    'name' => 'XYZ product',
    'description' => 'some description ...',
    'price' => '12.00'
);

$item = Model::factory('Item')
         ->saveForm($form);
//or
$item = Model::factory('Item')
         ->validateForm($form);
 $item->shop_id = $form['shop_id'];
 $item->cat_id = $form['cat_id'];
 $item->name = $form['name'];
 $item->description = $form['description'];
 $item->price = $form['price'];
 $item->save();

1.0.0 - released 2017-03-19

• Initial release