begin string helper

Author: darkfriend

.gitignore

@@ -0,0 +1 @@
+vendor

README.md

@@ -0,0 +1,9 @@
+# StringHelper - хелпер для работы со строками 
+
+* ```StringHelper::htmlspecialchars($val)``` - статичный метод, который делает htmlspecialchars() для строк и массивов
+* ```StringHelper::htmlspecialchars_decode($val)``` - статичный метод, который делает htmlspecialchars_decode() для строк и массивов
+* ```StringHelper::generateString($length, $chars)``` - статичный метод, который возвращает сгенерированную строку нужной длины
+* ```StringHelper::getDeclension($value, $words)``` - статичный метод, который возвращает окончания слов при слонении. _Например: 5 товаров, 1 товар, 3 товара_
+* ```StringHelper::truncate($string, $length, $suffix = '...', $encoding = null)``` - возвращает обрезанный текст в $length символов
+* ```StringHelper::truncateWords($string, $count, $suffix = '...')``` - возвращает обрезанный текст в $length слов
+

StringHelper.php

@@ -0,0 +1,134 @@
+<?php
+
+namespace darkfriend\helpers;
+
+/**
+ * This helper methods for string
+ * @package darkfriend\helpers
+ * @author darkfriend <hi@darkfriend.ru>
+ * @version 1.0.0
+ */
+class StringHelper
+{
+    /**
+     * Get encoded string
+     *
+     * @param mixed $val
+     * @return array|string
+     */
+    public static function htmlspecialchars($val)
+    {
+        if (\is_array($val)) {
+            $arrReturn = [];
+            foreach ($val as $key => $value) {
+                $arrReturn[$key] = self::htmlspecialchars($value);
+            }
+            return $arrReturn;
+        } else {
+            if (!empty($val)) {
+                return \htmlspecialchars(
+                    $val,
+                    \ENT_QUOTES | \ENT_HTML5 | \ENT_DISALLOWED | \ENT_SUBSTITUTE,
+                    'UTF-8'
+                );
+            }
+        }
+        return '';
+    }
+
+    /**
+     * Get decoded string
+     *
+     * @param mixed $val
+     * @return array|string
+     */
+    public static function htmlspecialchars_decode($val)
+    {
+        if (\is_array($val)) {
+            $arrReturn = [];
+            foreach ($val as $key => $value) {
+                $arrReturn[$key] = self::htmlspecialchars_decode($value);
+            }
+            return $arrReturn;
+        } else {
+            if ($val) {
+                return \htmlspecialchars_decode(
+                    $val,
+                    \ENT_QUOTES | \ENT_DISALLOWED | \ENT_SUBSTITUTE
+                );
+            }
+        }
+        return '';
+    }
+
+    /**
+     * Get generated string
+     *
+     * @param int $length
+     * @param string $chars
+     * @return string
+     */
+    public static function generateString($length = 8, $chars = '0123456789ABDEFGHKNQRSTYZ'): string
+    {
+        $numChars = \strlen($chars);
+        $string = '';
+        for ($i = 0; $i < $length; $i++) {
+            $string .= \substr($chars, rand(1, $numChars) - 1, 1);
+        }
+        return $string;
+    }
+
+    /**
+     * Return suffix word
+     * @param int $value число
+     * @param array $words массив возможных окончаний
+     * @return string
+     * @example 5 товаров, 1 товар, 3 товара
+     */
+    public static function getDeclension($value = 1, $words = ['', 'а', 'ов']): string
+    {
+        $array = [2, 0, 1, 1, 1, 2];
+
+        return $words[($value % 100 > 4 && $value % 100 < 20) ? 2 : $array[($value % 10 < 5) ? $value % 10 : 5]];
+    }
+
+    /**
+     * Return truncated string to the number of characters specified.
+     *
+     * @param string $string The string to truncate.
+     * @param int $length How many characters from original string to include into truncated string.
+     * @param string $suffix String to append to the end of truncated string.
+     * @param string $encoding The charset to use, defaults to charset currently used by application.
+     * @return string the truncated string.
+     */
+    public static function truncate($string, $length, $suffix = '...', $encoding = null): string
+    {
+        if ($encoding === null) {
+            $encoding = 'UTF-8';
+        }
+
+        if (\mb_strlen($string, $encoding) > $length) {
+            return \rtrim(\mb_substr($string, 0, $length, $encoding)) . $suffix;
+        }
+
+        return $string;
+    }
+
+    /**
+     * Return truncated string to the number of words specified.
+     *
+     * @param string $string The string to truncate.
+     * @param int $count How many words from original string to include into truncated string.
+     * @param string $suffix String to append to the end of truncated string.
+     * @return string the truncated string.
+     */
+    public static function truncateWords($string, $count, $suffix = '...'): string
+    {
+        $words = \preg_split('/(\s+)/u', \trim($string), null, \PREG_SPLIT_DELIM_CAPTURE);
+        if (\count($words) / 2 > $count) {
+            return \implode('', \array_slice($words, 0, ($count * 2) - 1)) . $suffix;
+        }
+
+        return $string;
+    }
+}

composer.json

@@ -0,0 +1,21 @@
+{
+    "name": "darkfriend/php7-string",
+    "type": "library",
+    "description": "PHP7 debug helper",
+    "keywords": ["dev","string","helper","darkfriend","development","php7","php"],
+    "homepage": "https://github.com/darkfriend/php7-string",
+    "authors": [
+        {
+            "name": "darkfriend",
+            "email": "hi@darkfriend.ru"
+        }
+    ],
+    "require": {
+        "php":">=7.0"
+    },
+    "autoload": {
+        "classmap":[
+            "./StringHelper.php"
+        ]
+    }
+}