342 lines
7.5 KiB
PHP
342 lines
7.5 KiB
PHP
<?php
|
|
|
|
namespace Typecho;
|
|
|
|
/**
|
|
* 验证类
|
|
*
|
|
* @package Validate
|
|
*/
|
|
class Validate
|
|
{
|
|
/**
|
|
* 内部数据
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
private array $data;
|
|
|
|
/**
|
|
* 当前验证指针
|
|
*
|
|
* @access private
|
|
* @var string
|
|
*/
|
|
private string $key;
|
|
|
|
/**
|
|
* 验证规则数组
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
private array $rules = [];
|
|
|
|
/**
|
|
* 中断模式,一旦出现验证错误即抛出而不再继续执行
|
|
*
|
|
* @access private
|
|
* @var boolean
|
|
*/
|
|
private bool $break = false;
|
|
|
|
/**
|
|
* 最小长度
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str 待处理的字符串
|
|
* @param integer $length 最小长度
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function minLength(string $str, int $length): bool
|
|
{
|
|
return (Common::strLen($str) >= $length);
|
|
}
|
|
|
|
/**
|
|
* 枚举类型判断
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str 待处理的字符串
|
|
* @param array $params 枚举值
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function enum(string $str, array $params): bool
|
|
{
|
|
$keys = array_flip($params);
|
|
return isset($keys[$str]);
|
|
}
|
|
|
|
/**
|
|
* Max Length
|
|
*
|
|
* @param string $str
|
|
* @param int $length
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function maxLength(string $str, int $length): bool
|
|
{
|
|
return (Common::strLen($str) < $length);
|
|
}
|
|
|
|
/**
|
|
* Valid Email
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function email(string $str): bool
|
|
{
|
|
$email = filter_var($str, FILTER_SANITIZE_EMAIL);
|
|
return !!filter_var($str, FILTER_VALIDATE_EMAIL) && ($email === $str);
|
|
}
|
|
|
|
/**
|
|
* 验证是否为网址
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function url(string $str): bool
|
|
{
|
|
$url = Common::safeUrl($str);
|
|
return !!filter_var($str, FILTER_VALIDATE_URL) && ($url === $str);
|
|
}
|
|
|
|
/**
|
|
* Alpha
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function alpha(string $str): bool
|
|
{
|
|
return ctype_alpha($str);
|
|
}
|
|
|
|
/**
|
|
* Alpha-numeric
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function alphaNumeric(string $str): bool
|
|
{
|
|
return ctype_alnum($str);
|
|
}
|
|
|
|
/**
|
|
* Alpha-numeric with underscores and dashes
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function alphaDash(string $str): bool
|
|
{
|
|
return !!preg_match("/^([_a-z0-9-])+$/i", $str);
|
|
}
|
|
|
|
/**
|
|
* 对xss字符串的检测
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function xssCheck(string $str): bool
|
|
{
|
|
$search = 'abcdefghijklmnopqrstuvwxyz';
|
|
$search .= 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
|
|
$search .= '1234567890!@#$%^&*()';
|
|
$search .= '~`";:?+/={}[]-_|\'\\';
|
|
|
|
for ($i = 0; $i < strlen($search); $i++) {
|
|
// ;? matches the ;, which is optional
|
|
// 0{0,7} matches any padded zeros, which are optional and go up to 8 chars
|
|
|
|
// @ @ search for the hex values
|
|
$str = preg_replace('/(&#[xX]0{0,8}' . dechex(ord($search[$i])) . ';?)/i', $search[$i], $str); // with a ;
|
|
// @ @ 0{0,7} matches '0' zero to seven times
|
|
$str = preg_replace('/(�{0,8}' . ord($search[$i]) . ';?)/', $search[$i], $str); // with a ;
|
|
}
|
|
|
|
return !preg_match('/(\(|\)|\\\|"|<|>|[\x00-\x08]|[\x0b-\x0c]|[\x0e-\x19]|' . "\r|\n|\t" . ')/', $str);
|
|
}
|
|
|
|
/**
|
|
* Numeric
|
|
*
|
|
* @access public
|
|
*
|
|
* @param mixed $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function isFloat($str): bool
|
|
{
|
|
return filter_var($str, FILTER_VALIDATE_FLOAT) !== false;
|
|
}
|
|
|
|
/**
|
|
* Is Numeric
|
|
*
|
|
* @access public
|
|
*
|
|
* @param mixed $str
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public static function isInteger($str): bool
|
|
{
|
|
return filter_var($str, FILTER_VALIDATE_INT) !== false;
|
|
}
|
|
|
|
/**
|
|
* 正则表达式验证
|
|
*
|
|
* @param string $str
|
|
* @param string $pattern
|
|
* @return bool
|
|
*/
|
|
public static function regexp(string $str, string $pattern): bool
|
|
{
|
|
return preg_match($pattern, $str) === 1;
|
|
}
|
|
|
|
/**
|
|
* 增加验证规则
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string $key 数值键值
|
|
* @param string|callable $rule 规则名称
|
|
* @param string $message 错误字符串
|
|
*
|
|
* @return $this
|
|
*/
|
|
public function addRule(string $key, $rule, string $message): Validate
|
|
{
|
|
if (func_num_args() <= 3) {
|
|
$this->rules[$key][] = [$rule, $message];
|
|
} else {
|
|
$params = func_get_args();
|
|
$params = array_splice($params, 3);
|
|
$this->rules[$key][] = array_merge([$rule, $message], $params);
|
|
}
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* 设置为中断模式
|
|
*
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function setBreak()
|
|
{
|
|
$this->break = true;
|
|
}
|
|
|
|
/**
|
|
* Run the Validator
|
|
* This function does all the work.
|
|
*
|
|
* @access public
|
|
*
|
|
* @param array $data 需要验证的数据
|
|
* @param array|null $rules 验证数据遵循的规则
|
|
*
|
|
* @return array
|
|
*/
|
|
public function run(array $data, ?array $rules = null): array
|
|
{
|
|
$result = [];
|
|
$this->data = $data;
|
|
$rules = empty($rules) ? $this->rules : $rules;
|
|
|
|
// Cycle through the rules and test for errors
|
|
foreach ($rules as $key => $rule) {
|
|
$this->key = $key;
|
|
$data[$key] = (is_array($data[$key]) ? 0 == count($data[$key])
|
|
: 0 == strlen($data[$key] ?? '')) ? null : $data[$key];
|
|
|
|
foreach ($rule as $params) {
|
|
$method = $params[0];
|
|
|
|
if ('required' != $method && 'confirm' != $method && 0 == strlen($data[$key] ?? '')) {
|
|
continue;
|
|
}
|
|
|
|
$message = $params[1];
|
|
$params[1] = $data[$key];
|
|
$params = array_slice($params, 1);
|
|
|
|
if (!call_user_func_array(is_callable($method) ? $method : [$this, $method], $params)) {
|
|
$result[$key] = $message;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/** 开启中断 */
|
|
if ($this->break && $result) {
|
|
break;
|
|
}
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* 验证输入是否一致
|
|
*
|
|
* @access public
|
|
*
|
|
* @param string|null $str 待处理的字符串
|
|
* @param string $key 需要一致性检查的键值
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function confirm(?string $str, string $key): bool
|
|
{
|
|
return !empty($this->data[$key]) ? ($str == $this->data[$key]) : empty($str);
|
|
}
|
|
|
|
/**
|
|
* 是否为空
|
|
*
|
|
* @access public
|
|
*
|
|
* @return boolean
|
|
*/
|
|
public function required(): bool
|
|
{
|
|
return array_key_exists($this->key, $this->data) &&
|
|
(is_array($this->data[$this->key]) ? 0 < count($this->data[$this->key])
|
|
: 0 < strlen($this->data[$this->key] ?? ''));
|
|
}
|
|
}
|