Devil Killer Is Here MiNi Shell
MiNi SheLL

Current Path : /home/vmanager/www/common/components/helpers/
Linux 9dbcd5f6333d 5.15.0-102-generic #112-Ubuntu SMP Tue Mar 5 16:50:32 UTC 2024 x86_64
Current File : //home/vmanager/www/common/components/helpers/StringHelper.php
<?php

namespace common\components\helpers;

use \Yii;
use yii\base\InvalidParamException;

class StringHelper
{
    /**
     * Truncates a 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 bool $forceExactCut Specifies whether the truncate should take place after a specific position.
     * @param string $suffix String to append to the end of truncated string.
     * @param array $breakChars List of characters that allow truncate.
     * @param bool $removeEmptyLines Specifies whether remove empty lines.
     * @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, $forceExactCut = false, $suffix = ' ...', $breakChars = [' ', '.'], $removeEmptyLines = true, $encoding = null)
    {     
        if(!$encoding) {
            $encoding = Yii::$app->charset;
        }
        
        $outputString = trim(strip_tags($string));
        $outputString = html_entity_decode($outputString);
        $outputString = \yii\helpers\Html::encode($outputString, false);
        $outputString = preg_replace('/\s\s+/', ' ', $outputString);
        
        if($removeEmptyLines) {
            $outputString = preg_replace('/[\n\r]+/', '', $outputString);
        }
        
        if (mb_strlen($outputString, $encoding ?: Yii::$app->charset) > $length) {
            if(!in_array($outputString[$length], $breakChars)) {
                $stringTotalLength = mb_strlen($outputString);
                $breakPositionAfterDeclared = self::arrayMbStrpos($outputString, $breakChars, $length, $encoding); 
                if(!$forceExactCut) {
                    $breakPositionBeforeDeclared = self::arrayMbStrrpos($outputString, $breakChars, (($stringTotalLength - $length + 1) * -1), $encoding);
                } else {
                    $breakPositionBeforeDeclared = false;
                }

                $minDistance = $stringTotalLength - $length;
                $bestPosition = $stringTotalLength;

                if($breakPositionAfterDeclared !== false) {
                    $distance = $breakPositionAfterDeclared - $length;
                    if($distance < $minDistance) {
                        $minDistance = $distance;
                        $bestPosition = $breakPositionAfterDeclared;
                    }
                }
                if($breakPositionBeforeDeclared !== false) {
                    $distance = $length - $breakPositionBeforeDeclared;
                    if($distance < $minDistance) {
                        $minDistance = $distance;
                        $bestPosition = $breakPositionBeforeDeclared;
                    }
                }

//                var_dump('length: '.$length);
//                var_dump('stringTotalLength: '.$stringTotalLength);
//                var_dump('breakPositionAfterDeclared: '.$breakPositionAfterDeclared);
//                var_dump('breakPositionBeforeDeclared: '.$breakPositionBeforeDeclared); 
//                var_dump('minDistance: '.$minDistance);
//                var_dump('bestPosition: '.$bestPosition);

                $outputString = rtrim(mb_substr($outputString, 0, $bestPosition, $encoding)).$suffix;

            } else {
                $outputString = rtrim(mb_substr($outputString, 0, $length, $encoding)).$suffix;
            }
        } 
        
        return $outputString;
    }
    
    protected static function arrayMbStrpos($haystack, $needles = [], $offset = 0, $encoding = null) 
    {
        if(!$encoding) {
            $encoding = Yii::$app->charset;
        }

        $chr = [];
        foreach($needles as $needle) {
            $res = mb_strpos($haystack, $needle, $offset, $encoding);
            if ($res !== false) {
                $chr[$needle] = $res;
            }
        }

        return !empty($chr) ? min($chr) : false;
    }
        
    protected static function arrayMbStrrpos($haystack, $needles = [], $offset = 0, $encoding = null) 
    {
        if(!$encoding) {
            $encoding = Yii::$app->charset;
        }
        
        $chr = [];
        foreach($needles as $needle) {
            $res = mb_strrpos($haystack, $needle, $offset, $encoding);
            if ($res !== false) {
                $chr[$needle] = $res;
            }
        }

        return !empty($chr) ? max($chr) : false;
    }
}
Creat By MiNi SheLL
Email: jattceo@gmail.com