php-validate

"inhere/php-validate": "dev-master",

git clone https://git.oschina.net/inhere/php-validate.git // git@osc
git clone https://github.com/inhere/php-validate.git // github

    use inhere\validate\Validation;

    class PageRequest extends Validation
    {
        public function rules()
        {
            return [
                ['tagId,title,userId,freeTime', 'required', 'msg' => '{attr} is required!'],
                ['tagId', 'size', 'min'=>4, 'max'=>567], // 4<= tagId <=567
                ['title', 'min', 40],
                ['freeTime', 'number'],
                ['tagId', 'number', 'when' => function($data) {
                    return isset($data['status']) && $data['status'] > 2;
                }],
                ['userId', 'number', 'on' => 'scene1' ],
                ['username', 'string', 'on' => 'scene2' ],
                ['title', 'customValidator', 'msg' => '{attr} error msg!' ],
                ['status', function($status) {
                    if ($status > 3) {
                        return true;
                    }
                    return false;
                }],
                ['created_at, updated_at', 'safe'],
            ];
        }
        
        // 添加一个验证器。必须返回一个布尔值标明验证失败或成功
        protected function customValidator($title)
        {
            // some logic ...

            return true; // Or false;
        }

        // 定义字段翻译
        public function attrTrans()
        {
            return [
              'userId' => '用户Id',
            ];
        }

        // 自定义验证器的提示消息, 更多请看 {@see ValidationTrait::_defaultMessages}
        public function messages()
        {
            return [
              'required' => '{attr} 是必填项。',
            ];
        }
    }

// 验证 POST 数据
$valid = PageRequest::make($_POST)->validate();

// 验证失败
if ($valid->fail()) {
    var_dump($valid->getErrors());
    var_dump($valid->firstError());
}

// 验证成功 ...
$safeData = $valid->getSafeData(); // 验证通过的安全数据
// $postData = $valid->all(); // 原始数据

$db->save($safeData);

    use inhere\validate\Validation;

    class SomeController
    {
        public function demoAction()
        {
            $valid = Validation::make($_POST,[
                // add rule
                ['title', 'min', 40],
                ['freeTime', 'number'],
            ])->validate();

            if ($valid->fail()) {
                var_dump($valid->getErrors());
                var_dump($valid->firstError());
            }

            // $postData = $valid->all(); // 原始数据
            $safeData = $valid->getSafeData(); // 验证通过的安全数据

            $db->save($safeData);
        }
    }

    class DataModel
    {
        use \inhere\validate\ValidationTrait;

        protected $data = [];

        protected $db;

        /**
         * @param array $data
         * @return $this
         */
        public function setData($data)
        {
            $this->data = $data;

            return $this;
        }

        public function create()
        {
            if ($this->validate()->fail()) {
                return false;
            }

            return $this->db->insert($this->getSafeData());
        }
    }

    class UserModel extends DataModel
    {
        public function rules()
        {
            return [
                ['username, passwd', 'required', 'on' => 'create' ],
                ['passwd', 'compare', 'repasswd', 'on' => 'create']
                ['username', 'string', 'min' => 2, 'max' => 20, 'on' => 'create' ],
                ['id', 'number', 'on' => 'update' ],
                ['created_at, updated_at', 'safe'],
            ];
        }
    }
    
    // ...
    class UserController 
    {
        // in action
        // @api /user/add
        public function addAction()
        {
            $model = new UserModel;
            $ret = $model->setData($_POST)->atScene('create')->create();

            if (!$ret) {
                exit($model->firstError());
            }

            echo "add success: userId = $ret";
        }

    }

$valid = Validation::make($_POST,[
        // add rule
        ['title', 'min', 40],
        ['freeTime', 'number'],
        ['title', 'checkTitle'],
    ])
    ->addValidator('checkTitle',function($title){
        // some logic ...

        return true; // 成功返回 True。 如果验证失败,返回 False.
    }, '{attr} default message!')
    ->validate();

    ['status', function($status) {

        if ($status > 3) {
            return true;
        }
        
        return false;
    }]

    // 在继承了 Validation 的子类 ValidationClass 中 ...
    public function rules()
    {
         return [
            ['title', 'required' ],
            ['userId', 'number', 'on' => 'create' ],
            ['userId', 'int', 'on' => 'update' ],
            ['name', 'string', 'on' => 'create,update' ],
        ];
    }

    // ...
    $valid = ValidationClass::make($_POST)->atScene('update')->validate();
    // ...

    // 在继承了 Validation 的子类中 ...
    public function rules()
    {
         return [
            ['title', 'required' ],
            ['tagId', 'number', 'when' => function($data)
            {
               return isset($data['status']) && $data['status'] > 2;
            }],
        ];
    }

['name', 'string']

['name', 'required' ]
['name', 'string' ]

['name', 'string', 'skipOnEmpty' => false ]

['name', 'string', 'isEmpty' => function($value) {
    return true or false;
 }]

['created_at, updated_at', 'safe']

public function setScene(string $scene)
public function atScene(string $scene) // setScene 的别名方法

public function validate(array $onlyChecked = [], $stopOnError = null)

public function addValidator(string $name, \Closure $callback, string $msg = '')

public function hasError()
public function isFail() // hasError() 的别名方法
public function fail() // hasError() 的别名方法

public function getErrors(): array

[
    [ attr1 => 'error message 1'],
    [ attr1 => 'error message 2'],
    [ attr2 => 'error message 3'],
]

public function firstError($onlyMsg = true)

public function lastError($onlyMsg = true)

public function getSafeData(): array

public function getSafe(string $key, $default = null)
public function getValid(string $key, $default = null) // getSafe() 的别名方法

public function all(): array

public function get(string $key, $default = null)