AgelxNash / DocLister

assets/lib/APIHelpers.class.php

Doc Comments +2 added lines, -2 removed lines

@@ -80,7 +80,7 @@ 
      * @license    GNU General Public License (GPL), http://www.gnu.org/copyleft/gpl.html
      * @param string $email проверяемый email
      * @param boolean $dns проверять ли DNS записи
-     * @return boolean Результат проверки почтового ящика
+     * @return false|string Результат проверки почтового ящика
      * @author Anton Shevchuk
      */
     public static function emailValidate($email, $dns = true)
@@ -155,7 +155,7 @@ 
     }
 
     /**
-     * @param $data
+     * @param string $data
      * @return bool|false|string
      */
     private static function _getEnv($data)

Braces +50 added lines, -50 removed lines

@@ -3,16 +3,16 @@ 
 /**
  * Class APIhelpers
  */
-class APIhelpers
-{
+class APIhelpers

+{

     /**
      * Преобразует первый символ в нижний регистр
      * @param $str
      * @param string $encoding - кодировка, по-умолчанию UTF-8
      * @return string
      */
-    public static function mb_lcfirst($str, $encoding = 'UTF-8')
-    {
+    public static function mb_lcfirst($str, $encoding = 'UTF-8')

+    {

         return mb_strtolower(mb_substr($str, 0, 1, $encoding), $encoding) . mb_substr($str, 1, mb_strlen($str),
             $encoding);
     }
@@ -23,8 +23,8 @@ 
      * @param string $encoding - кодировка, по-умолчанию UTF-8
      * @return string
      */
-    public static function mb_ucfirst($str, $encoding = 'UTF-8')
-    {
+    public static function mb_ucfirst($str, $encoding = 'UTF-8')

+    {

         $str = mb_ereg_replace('^[\ ]+', '', $str);
         $str = mb_strtoupper(mb_substr($str, 0, 1, $encoding), $encoding) . mb_substr($str, 1, mb_strlen($str),
                 $encoding);
@@ -43,13 +43,13 @@ 
      * @param string $encoding кодировка
      * @return string
      */
-    public static function mb_trim_word($html, $len, $encoding = 'UTF-8')
-    {
+    public static function mb_trim_word($html, $len, $encoding = 'UTF-8')

+    {

         $text = trim(preg_replace('|\s+|', ' ', strip_tags($html)));
         $text = mb_substr($text, 0, $len + 1, $encoding);
-        if (mb_substr($text, -1, null, $encoding) == ' ') {
+        if (mb_substr($text, -1, null, $encoding) == ' ') {

             $out = trim($text);
-        } else {
+        } else {

             $out = mb_substr($text, 0, mb_strripos($text, ' ', null, $encoding), $encoding);
         }
 
@@ -62,10 +62,10 @@ 
      * @param mixed $default null
      * @return mixed
      */
-    public static function getkey($data, $key, $default = null)
-    {
+    public static function getkey($data, $key, $default = null)

+    {

         $out = $default;
-        if (is_array($data) && (is_int($key) || is_string($key)) && $key !== '' && array_key_exists($key, $data)) {
+        if (is_array($data) && (is_int($key) || is_string($key)) && $key !== '' && array_key_exists($key, $data)) {

             $out = $data[$key];
         }
 
@@ -83,16 +83,16 @@ 
      * @return boolean Результат проверки почтового ящика
      * @author Anton Shevchuk
      */
-    public static function emailValidate($email, $dns = true)
-    {
-        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {
+    public static function emailValidate($email, $dns = true)

+    {

+        if (filter_var($email, FILTER_VALIDATE_EMAIL)) {

             list(, $domain) = explode("@", $email, 2);
-            if (!$dns || ($dns && checkdnsrr($domain, "MX") && checkdnsrr($domain, "A"))) {
+            if (!$dns || ($dns && checkdnsrr($domain, "MX") && checkdnsrr($domain, "A"))) {

                 $error = false;
-            } else {
+            } else {

                 $error = 'dns';
             }
-        } else {
+        } else {

             $error = 'format';
         }
 
@@ -125,16 +125,16 @@ 
      * $this->genPass(20,"."); //AMV,>&?J)v55,(^g}Z06
      * $this->genPass(20,"aaa0aaa.A"); //rtvKja5xb0\KpdiRR1if
      */
-    public static function genPass($len, $data = '')
-    {
-        if ($data == '') {
+    public static function genPass($len, $data = '')

+    {

+        if ($data == '') {

             $data = 'Aa0.';
         }
         $opt = strlen($data);
         $pass = array();
 
-        for ($i = $len; $i > 0; $i--) {
-            switch ($data[rand(0, ($opt - 1))]) {
+        for ($i = $len; $i > 0; $i--) {

+            switch ($data[rand(0, ($opt - 1))]) {

                 case 'A':
                     $tmp = rand(65, 90);
                     break;
@@ -158,9 +158,9 @@ 
      * @param $data
      * @return bool|false|string
      */
-    private static function _getEnv($data)
-    {
-        switch (true) {
+    private static function _getEnv($data)

+    {

+        switch (true) {

             case (isset($_SERVER[$data])):
                 $out = $_SERVER[$data];
                 break;
@@ -193,10 +193,10 @@ 
      *
      * @see http://stackoverflow.com/questions/5036443/php-how-to-block-proxies-from-my-site
      */
-    public static function getUserIP($default = '127.0.0.1')
-    {
+    public static function getUserIP($default = '127.0.0.1')

+    {

         //Порядок условий зависит от приоритетов
-        switch (true) {
+        switch (true) {

             case ($tmp = self::_getEnv('HTTP_COMING_FROM')):
                 $out = $tmp;
                 break;
@@ -250,8 +250,8 @@ 
             '`'   => '`',
             '%60' => '`'
         )
-    ) {
-        switch (true) {
+    ) {

+        switch (true) {

             case is_scalar($data):
                 $out = str_replace(
                     array_keys($chars),
@@ -261,7 +261,7 @@ 
                 break;
             case is_array($data):
                 $out = $data;
-                foreach ($out as $key => &$val) {
+                foreach ($out as $key => &$val) {

                     $val = self::sanitarTag($val, $charset, $chars);
                 }
                 break;
@@ -277,8 +277,8 @@ 
      * @param string $charset
      * @return string
      */
-    public static function e($text, $charset = 'UTF-8')
-    {
+    public static function e($text, $charset = 'UTF-8')

+    {

         return is_scalar($text) ? htmlspecialchars($text, ENT_QUOTES, $charset, false) : '';
     }
 
@@ -293,17 +293,17 @@ 
      * @param array $mixArray Примесь символов, которые так же могут использоваться в строке
      * @return bool
      */
-    public static function checkString($value, $minLen = 1, $alph = array(), $mixArray = array())
-    {
+    public static function checkString($value, $minLen = 1, $alph = array(), $mixArray = array())

+    {

         $flag = true;
         $len = mb_strlen($value, 'UTF-8');
         $value = trim($value);
-        if (mb_strlen($value, 'UTF-8') == $len) {
+        if (mb_strlen($value, 'UTF-8') == $len) {

             $data = is_array($mixArray) ? $mixArray : array();
             $alph = is_array($alph) ? array_unique($alph) : array();
-            foreach ($alph as $item) {
+            foreach ($alph as $item) {

                 $item = strtolower($item);
-                switch ($item) {
+                switch ($item) {

                     case 'rus':
                         $data = array_merge($data, array(
                             'А',
@@ -343,7 +343,7 @@ 
                         break;
                     case 'num':
                         $tmp = range('0', '9');
-                        foreach ($tmp as $t) {
+                        foreach ($tmp as $t) {

                             $data[] = (string)$t;
                         }
                         break;
@@ -352,15 +352,15 @@ 
                         break;
                 }
             }
-            for ($i = 0; $i < $len; $i++) {
+            for ($i = 0; $i < $len; $i++) {

                 $chr = mb_strtoupper(mb_substr($value, $i, 1, 'UTF-8'), 'UTF-8');
-                if (!in_array($chr, $data, true)) {
+                if (!in_array($chr, $data, true)) {

                     $flag = false;
                     break;
                 }
             }
             $flag = ($flag && $len >= $minLen);
-        } else {
+        } else {

             $flag = false;
         }
 
@@ -377,18 +377,18 @@ 
      * @param string $sep разделитель ключей при склейке многомерных массивов
      * @return array массив с переименованными ключами
      */
-    public static function renameKeyArr($data, $prefix = '', $suffix = '', $addPS = '.', $sep = '.')
-    {
+    public static function renameKeyArr($data, $prefix = '', $suffix = '', $addPS = '.', $sep = '.')

+    {

         $out = array();
-        if ($prefix == '' && $suffix == '') {
+        if ($prefix == '' && $suffix == '') {

             $out = $data;
-        } else {
+        } else {

             $InsertPrefix = ($prefix != '') ? ($prefix . $addPS) : '';
             $InsertSuffix = ($suffix != '') ? ($addPS . $suffix) : '';
-            foreach ($data as $key => $item) {
+            foreach ($data as $key => $item) {

                 $key = $InsertPrefix . $key;
                 $val = null;
-                switch (true) {
+                switch (true) {

                     case is_scalar($item):
                         $val = $item;
                         break;