udpate some info, remove some no-use methods

Author: inhere

README.md

@@ -48,31 +48,49 @@ e.g
 - **github** https://github.com/inhere/php-validate.git
 - **gitee** https://gitee.com/inhere/php-validate.git
 
-> **注意：** master 分支是要求 `php7+` 的(推荐使用)。php5 分支是支持php5的代码分支,基本上不再维护。
+> **注意：** master 分支是要求 `php7+` 的(推荐使用)。`1.x` 分支是支持php5的代码分支,但是基本上不再维护。
 
 ## 安装
 
-- 使用 composer 命令
-
 ```php
 composer require inhere/php-validate
 // composer require inhere/php-validate ^2.2
 ```
 
-- 使用 composer.json
+## 立即使用
 
-编辑 `composer.json`，在 `require` 添加
+<a name="how-to-use1"></a>
+### 方式1: 直接使用类 `Validation`
 
-```
-"inhere/php-validate": "~2.0",
-// "inhere/php-validate": "dev-php5", // for php5
-```
+需要快速简便的使用验证时，可直接使用 `Inhere\Validate\Validation`
 
-然后执行: `composer update`
+```php
+use Inhere\Validate\Validation;
 
-## 立即使用
+class SomeController
+{
+    public function demoAction()
+    {
+        $v = Validation::check($_POST,[
+            // add rule
+            ['title', 'min', 40],
+            ['freeTime', 'number'],
+        ]);
 
-<a name="how-to-use1"></a>
+        if ($v->fail()) {
+            var_dump($v->getErrors());
+            var_dump($v->firstError());
+        }
+
+        // $postData = $v->all(); // 原始数据
+        $safeData = $v->getSafeData(); // 验证通过的安全数据
+
+        $db->save($safeData);
+    }
+}
+```
+
+<a name="how-to-use2"></a>
 ### 方式1: 继承类 `Validation`
 
 创建一个新的class，并继承 `Inhere\Validate\Validation`。用于一个（或一系列相关）请求的验证, 相当于 laravel 的 表单请求验证
@@ -185,37 +203,6 @@ $safeData = $v->getSafeData(); // 验证通过的安全数据
 $db->save($safeData);
 ```
 
-<a name="how-to-use2"></a>
-### 方式2: 直接使用类 `Validation`
-
-需要快速简便的使用验证时，可直接使用 `Inhere\Validate\Validation`
-
-```php
-use Inhere\Validate\Validation;
-
-class SomeController
-{
-    public function demoAction()
-    {
-        $v = Validation::check($_POST,[
-            // add rule
-            ['title', 'min', 40],
-            ['freeTime', 'number'],
-        ]);
-
-        if ($v->fail()) {
-            var_dump($v->getErrors());
-            var_dump($v->firstError());
-        }
-
-        // $postData = $v->all(); // 原始数据
-        $safeData = $v->getSafeData(); // 验证通过的安全数据
-
-        $db->save($safeData);
-    }
-}
-```
-
 <a name="how-to-use3"></a>
 ### 方式3: 使用trait `ValidationTrait`
 
@@ -296,7 +283,7 @@ class UserController
 
 ## 添加自定义验证器
 
-- **方式1**在继承了 `Inhere\Validate\Validation` 的子类添加验证方法. 请看上面的 [使用方式1](#how-to-use1)
+- **方式1**在继承了 `Inhere\Validate\Validation` 的子类添加验证方法. 请看上面的 [使用方式1](#how-to-use2)
 
 > 注意： 写在当前类里的验证器方法必须带有后缀 `Validator`, 以防止对内部的其他的方法造成干扰
 

src/Filter/Filters.php

@@ -211,7 +211,11 @@ public static function lowercase($val): string
             return \is_numeric($val) ? $val : '';
         }
 
-        return Helper::strToLower($val);
+        if (\function_exists('mb_strtolower')) {
+            return \mb_strtolower($val, 'utf-8');
+        }
+
+        return \strtolower($val);
     }
 
     /**
@@ -226,16 +230,38 @@ public static function upper($val): string
 
     /**
      * string to uppercase
-     * @param string $val
+     * @param string $str
      * @return string
      */
-    public static function uppercase($val): string
+    public static function uppercase($str): string
     {
-        if (!$val || !\is_string($val)) {
-            return \is_numeric($val) ? $val : '';
+        if (!$str || !\is_string($str)) {
+            return \is_numeric($str) ? $str : '';
         }
 
-        return Helper::strToUpper($val);
+        if (\function_exists('mb_strtoupper')) {
+            return \mb_strtoupper($str, 'utf-8');
+        }
+
+        return \strtoupper($str);
+    }
+
+    /**
+     * @param string $str
+     * @return string
+     */
+    public static function ucfirst($str): string
+    {
+        return self::uppercase(self::subStr($str, 0, 1)) . self::subStr($str, 1);
+    }
+
+    public static function ucwords($str): string
+    {
+        if (\function_exists('mb_convert_case')) {
+            return \mb_convert_case($str, \MB_CASE_TITLE);
+        }
+
+        return \ucwords(Filters::lowercase($str));
     }
 
     /**
@@ -250,7 +276,9 @@ public static function snake($val, $sep = '_'): string
     }
 
     /**
-     * string to snakeCase
+     * Transform a CamelCase string to underscore_case string
+     *  'CMSCategories' => 'cms_categories'
+     *  'RangePrice' => 'range_price'
      * @param string $val
      * @param string $sep
      * @return string
@@ -261,7 +289,9 @@ public static function snakeCase($val, $sep = '_'): string
             return '';
         }
 
-        return Helper::toSnakeCase($val, $sep);
+        $val = \preg_replace('/([A-Z][a-z])/', $sep . '$1', $val);
+
+        return self::lowercase(\trim($val, $sep));
     }
 
     /**
@@ -276,7 +306,7 @@ public static function camel($val, $ucFirst = false): string
     }
 
     /**
-     * string to camelcase
+     * Translates a string with underscores into camel case (e.g. first_name -> firstName)
      * @param string $val
      * @param bool   $ucFirst
      * @return string
@@ -287,7 +317,15 @@ public static function camelCase($val, $ucFirst = false): string
             return '';
         }
 
-        return Helper::toCamelCase($val, $ucFirst);
+        $str = self::lowercase($val);
+
+        if ($ucFirst) {
+            $str = self::ucfirst($str);
+        }
+
+        return \preg_replace_callback('/_+([a-z])/', function ($c) {
+            return \strtoupper($c[1]);
+        }, $str);
     }
 
     /**
@@ -311,7 +349,25 @@ public static function strToTime($val): int
             return 0;
         }
 
-        return (int)strtotime($val);
+        return (int)\strtotime($val);
+    }
+
+    /**
+     * @param string $str
+     * @param int    $start
+     * @param int    $length
+     * @param string $encoding
+     * @return bool|string
+     */
+    public static function subStr(string $str, int $start, int $length = 0, string $encoding = 'utf-8')
+    {
+        $length = $length === 0 ? Helper::strlen($str) : $length;
+
+        if (\function_exists('mb_substr')) {
+            return \mb_substr($str, $start, $length, $encoding);
+        }
+
+        return \substr($str, $start, $length);
     }
 
     /**
@@ -466,7 +522,7 @@ public static function stringCute($string, $start = 0, $end = null): string
         }
 
         // $length    = Helper::strlen($string);
-        return Helper::subStr($string, $start, $end);
+        return self::subStr($string, $start, $end);
     }
 
     /**

src/Filter/Filtration.php

@@ -8,7 +8,7 @@
 
 namespace Inhere\Validate\Filter;
 
-use Inhere\Validate\Utils\DataFiltersTrait;
+use Inhere\Validate\Utils\DataFilteringTrait;
 
 /**
  * Class Filtration
@@ -23,7 +23,7 @@
  */
 class Filtration
 {
-    use DataFiltersTrait;
+    use DataFilteringTrait;
 
     /** @var array raw data */
     private $_data;

src/Utils/DataFiltersTrait.php renamed to src/Utils/DataFilteringTrait.php

@@ -11,16 +11,18 @@
 use Inhere\Validate\Filter\Filters;
 
 /**
- * Trait DataFiltersTrait
+ * Trait DataFilteringTrait
  * @package Inhere\Validate\Utils
  */
-trait DataFiltersTrait
+trait DataFilteringTrait
 {
     /** @var array user custom filters */
     private static $customFilters = [];
 
     /** @var array filter aliases map */
     private static $filterAliases = [
+        'substr'       => 'subStr',
+        'substring'    => 'subStr',
         'str2list'     => 'explode',
         'str2array'    => 'explode',
         'string2list'  => 'explode',
@@ -32,6 +34,8 @@ trait DataFiltersTrait
         'str2lower'    => 'lowercase',
         'strToLower'   => 'lowercase',
         'clearNl'      => 'clearNewline',
+        'str2time'     => 'strToTime',
+        'strtotime'    => 'strToTime',
     ];
 
     /**

src/Utils/ErrorMessageTrait.php

@@ -471,6 +471,7 @@ public function getTranslates(): array
     public function getTranslate(string $field): string
     {
         $trans = $this->getTranslates();
+
         if (isset($trans[$field])) {
             return $trans[$field];
         }