$config Settings array Settings array */ public function __construct(View $View, array $config = []) { $config += ['engine' => 'Tools.Text']; parent::__construct($View, $config); /** @psalm-var class-string<\Cake\Utility\Text>|null $engineClass */ $engineClass = App::className($config['engine'], 'Utility'); if ($engineClass === null) { throw new CakeException(sprintf('Class for `%s` could not be found', $config['engine'])); } $this->_engine = new $engineClass($config); } /** * Call methods from String utility class * * @param string $method Method to invoke * @param array $params Array of params for the method. * @return mixed Whatever is returned by called method, or false on failure */ public function __call(string $method, array $params): mixed { return $this->_engine->{$method}(...$params); } /** * Minimizes the given URL to a maximum length * * @param string $url the url * @param int|null $max the maximum length * @param array $options * - placeholder * @return string the manipulated url (+ eventuell ...) */ public function minimizeUrl(string $url, ?int $max = null, array $options = []): string { // check if there is nothing to do if (!$url || mb_strlen($url) <= (int)$max) { return $url; } // http:// etc has not to be displayed, so $url = Utility::stripProtocol($url); // cut the parameters if (mb_strpos($url, '/') !== false) { /** @var string $url */ $url = strtok($url, '/'); } // return if the url is short enough if (mb_strlen($url) <= (int)$max) { return $url; } // otherwise cut a part in the middle (but only if long enough!) // TODO: more dynamically $placeholder = CHAR_HELLIP; if (!empty($options['placeholder'])) { $placeholder = $options['placeholder']; } $end = mb_substr($url, -5, 5); $front = mb_substr($url, 0, (int)$max - 8); return $front . $placeholder . $end; } /** * Removes http:// or other protocols from the link. * * @param string $url * @param array $protocols Defaults to http and https. Pass empty array for all. * @return string strippedUrl */ public function stripProtocol(string $url, array $protocols = ['http', 'https']): string { return Utility::stripProtocol($url, $protocols); } /** * Transforming int values into ordinal numbers (1st, 3rd, ...). * When using HTML, you can use ^{, as well.
*
* @param int $num The number to be suffixed.
* @param bool $sup Whether to wrap the suffix in a superscript (^{) tag on output.
* @return string ordinal
*/
public function ordinalNumber(int $num = 0, bool $sup = false): string {
$ordinal = Number::ordinal($num);

return ($sup) ? $num . '^{' . $ordinal . '}' : $num . $ordinal;
}

/**
* Syntax highlighting using php internal highlighting
*
* @param string $file Filename
* @return string
*/
public function highlightFile(string $file): string {
return highlight_file($file, true);
}

/**
* Syntax highlighting using php internal highlighting
*
* @param string $string Content
* @return string
*/
public function highlightString(string $string): string {
return highlight_string($string, true);
}

}}}