1321 lines
34 KiB
PHP
1321 lines
34 KiB
PHP
|
|
<?php
|
|||
|
|
|
|||
|
|
declare(strict_types=1);
|
|||
|
|
/**
|
|||
|
|
* This file is part of Hyperf.
|
|||
|
|
*
|
|||
|
|
* @link https://www.hyperf.io
|
|||
|
|
* @document https://hyperf.wiki
|
|||
|
|
* @contact group@hyperf.io
|
|||
|
|
* @license https://github.com/hyperf/hyperf/blob/master/LICENSE
|
|||
|
|
*/
|
|||
|
|
namespace Hyperf\Utils;
|
|||
|
|
|
|||
|
|
use Hyperf\Macroable\Macroable;
|
|||
|
|
use Hyperf\Utils\Exception\InvalidArgumentException;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Most of the methods in this file come from illuminate/support,
|
|||
|
|
* thanks Laravel Team provide such a useful class.
|
|||
|
|
*/
|
|||
|
|
class Str
|
|||
|
|
{
|
|||
|
|
use Macroable;
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The cache of snake-cased words.
|
|||
|
|
*
|
|||
|
|
* @var array
|
|||
|
|
*/
|
|||
|
|
protected static $snakeCache = [];
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The cache of camel-cased words.
|
|||
|
|
*
|
|||
|
|
* @var array
|
|||
|
|
*/
|
|||
|
|
protected static $camelCache = [];
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* The cache of studly-cased words.
|
|||
|
|
*
|
|||
|
|
* @var array
|
|||
|
|
*/
|
|||
|
|
protected static $studlyCache = [];
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get a new stringable object from the given string.
|
|||
|
|
*
|
|||
|
|
* @param string $string
|
|||
|
|
* @return Stringable
|
|||
|
|
*/
|
|||
|
|
public static function of($string)
|
|||
|
|
{
|
|||
|
|
return new Stringable($string);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Return the remainder of a string after a given value.
|
|||
|
|
*
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param string $search
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function after($subject, $search)
|
|||
|
|
{
|
|||
|
|
return $search === '' ? $subject : array_reverse(explode($search, $subject, 2))[0];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Return the remainder of a string after the last occurrence of a given value.
|
|||
|
|
*
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param string $search
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function afterLast($subject, $search)
|
|||
|
|
{
|
|||
|
|
if ($search === '') {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$position = strrpos($subject, (string) $search);
|
|||
|
|
|
|||
|
|
if ($position === false) {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return substr($subject, $position + strlen($search));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Transliterate a UTF-8 value to ASCII.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param string $language
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function ascii($value, $language = 'en')
|
|||
|
|
{
|
|||
|
|
$languageSpecific = static::languageSpecificCharsArray($language);
|
|||
|
|
|
|||
|
|
if (! is_null($languageSpecific)) {
|
|||
|
|
$value = str_replace($languageSpecific[0], $languageSpecific[1], $value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
foreach (static::charsArray() as $key => $val) {
|
|||
|
|
$value = str_replace($val, (string) $key, $value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return preg_replace('/[^\x20-\x7E]/u', '', $value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the portion of a string before a given value.
|
|||
|
|
*
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param string $search
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function before($subject, $search)
|
|||
|
|
{
|
|||
|
|
return $search === '' ? $subject : explode($search, $subject)[0];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the portion of a string before the last occurrence of a given value.
|
|||
|
|
*
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param string $search
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function beforeLast($subject, $search)
|
|||
|
|
{
|
|||
|
|
if ($search === '') {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$pos = mb_strrpos($subject, $search);
|
|||
|
|
|
|||
|
|
if ($pos === false) {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return static::substr($subject, 0, $pos);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the portion of a string between two given values.
|
|||
|
|
*
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param string $from
|
|||
|
|
* @param string $to
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function between($subject, $from, $to)
|
|||
|
|
{
|
|||
|
|
if ($from === '' || $to === '') {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return static::beforeLast(static::after($subject, $from), $to);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert a value to camel case.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function camel($value)
|
|||
|
|
{
|
|||
|
|
if (isset(static::$camelCache[$value])) {
|
|||
|
|
return static::$camelCache[$value];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return static::$camelCache[$value] = lcfirst(static::studly($value));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Determine if a given string contains a given substring.
|
|||
|
|
*
|
|||
|
|
* @param string $haystack
|
|||
|
|
* @param array|string $needles
|
|||
|
|
* @return bool
|
|||
|
|
*/
|
|||
|
|
public static function contains($haystack, $needles)
|
|||
|
|
{
|
|||
|
|
foreach ((array) $needles as $needle) {
|
|||
|
|
if ($needle !== '' && mb_strpos($haystack, $needle) !== false) {
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Determine if a given string contains all array values.
|
|||
|
|
*
|
|||
|
|
* @param string $haystack
|
|||
|
|
* @param string[] $needles
|
|||
|
|
* @return bool
|
|||
|
|
*/
|
|||
|
|
public static function containsAll($haystack, array $needles)
|
|||
|
|
{
|
|||
|
|
foreach ($needles as $needle) {
|
|||
|
|
if (! static::contains($haystack, $needle)) {
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Determine if a given string ends with a given substring.
|
|||
|
|
*
|
|||
|
|
* @param string $haystack
|
|||
|
|
* @param array|string $needles
|
|||
|
|
* @return bool
|
|||
|
|
*/
|
|||
|
|
public static function endsWith($haystack, $needles)
|
|||
|
|
{
|
|||
|
|
foreach ((array) $needles as $needle) {
|
|||
|
|
if (substr($haystack, -strlen($needle)) === (string) $needle) {
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Cap a string with a single instance of a given value.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param string $cap
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function finish($value, $cap)
|
|||
|
|
{
|
|||
|
|
$quoted = preg_quote($cap, '/');
|
|||
|
|
|
|||
|
|
return preg_replace('/(?:' . $quoted . ')+$/u', '', $value) . $cap;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Determine if a given string matches a given pattern.
|
|||
|
|
*
|
|||
|
|
* @param array|string $pattern
|
|||
|
|
* @param string $value
|
|||
|
|
* @return bool
|
|||
|
|
*/
|
|||
|
|
public static function is($pattern, $value)
|
|||
|
|
{
|
|||
|
|
$patterns = Arr::wrap($pattern);
|
|||
|
|
|
|||
|
|
if (empty($patterns)) {
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
foreach ($patterns as $pattern) {
|
|||
|
|
// If the given value is an exact match we can of course return true right
|
|||
|
|
// from the beginning. Otherwise, we will translate asterisks and do an
|
|||
|
|
// actual pattern match against the two strings to see if they match.
|
|||
|
|
if ($pattern == $value) {
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$pattern = preg_quote($pattern, '#');
|
|||
|
|
|
|||
|
|
// Asterisks are translated into zero-or-more regular expression wildcards
|
|||
|
|
// to make it convenient to check if the strings starts with the given
|
|||
|
|
// pattern such as "library/*", making any string check convenient.
|
|||
|
|
$pattern = str_replace('\*', '.*', $pattern);
|
|||
|
|
|
|||
|
|
if (preg_match('#^' . $pattern . '\z#u', $value) === 1) {
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert a string to kebab case.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function kebab($value)
|
|||
|
|
{
|
|||
|
|
return static::snake($value, '-');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Return the length of the given string.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param string $encoding
|
|||
|
|
* @return int
|
|||
|
|
*/
|
|||
|
|
public static function length($value, $encoding = null)
|
|||
|
|
{
|
|||
|
|
if ($encoding) {
|
|||
|
|
return mb_strlen($value, $encoding);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return mb_strlen($value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Limit the number of characters in a string.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param int $limit
|
|||
|
|
* @param string $end
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function limit($value, $limit = 100, $end = '...')
|
|||
|
|
{
|
|||
|
|
if (mb_strwidth($value, 'UTF-8') <= $limit) {
|
|||
|
|
return $value;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return rtrim(mb_strimwidth($value, 0, $limit, '', 'UTF-8')) . $end;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert the given string to lower-case.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function lower($value)
|
|||
|
|
{
|
|||
|
|
return mb_strtolower($value, 'UTF-8');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Limit the number of words in a string.
|
|||
|
|
*/
|
|||
|
|
public static function words(string $value, int $words = 100, string $end = '...'): string
|
|||
|
|
{
|
|||
|
|
preg_match('/^\s*+(?:\S++\s*+){1,' . $words . '}/u', $value, $matches);
|
|||
|
|
|
|||
|
|
if (! isset($matches[0]) || static::length($value) === static::length($matches[0])) {
|
|||
|
|
return $value;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return rtrim($matches[0]) . $end;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the string matching the given pattern.
|
|||
|
|
*
|
|||
|
|
* @param string $pattern
|
|||
|
|
* @param string $subject
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function match($pattern, $subject)
|
|||
|
|
{
|
|||
|
|
preg_match($pattern, $subject, $matches);
|
|||
|
|
|
|||
|
|
if (! $matches) {
|
|||
|
|
return '';
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $matches[1] ?? $matches[0];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the string matching the given pattern.
|
|||
|
|
*
|
|||
|
|
* @param string $pattern
|
|||
|
|
* @param string $subject
|
|||
|
|
* @return Collection
|
|||
|
|
*/
|
|||
|
|
public static function matchAll($pattern, $subject)
|
|||
|
|
{
|
|||
|
|
preg_match_all($pattern, $subject, $matches);
|
|||
|
|
|
|||
|
|
if (empty($matches[0])) {
|
|||
|
|
return collect();
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return collect($matches[1] ?? $matches[0]);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Pad both sides of a string with another.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param int $length
|
|||
|
|
* @param string $pad
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function padBoth($value, $length, $pad = ' ')
|
|||
|
|
{
|
|||
|
|
return str_pad($value, $length, $pad, STR_PAD_BOTH);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Pad the left side of a string with another.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param int $length
|
|||
|
|
* @param string $pad
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function padLeft($value, $length, $pad = ' ')
|
|||
|
|
{
|
|||
|
|
return str_pad($value, $length, $pad, STR_PAD_LEFT);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Pad the right side of a string with another.
|
|||
|
|
*
|
|||
|
|
* @param string $value
|
|||
|
|
* @param int $length
|
|||
|
|
* @param string $pad
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function padRight($value, $length, $pad = ' ')
|
|||
|
|
{
|
|||
|
|
return str_pad($value, $length, $pad, STR_PAD_RIGHT);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Parse a Class@method style callback into class and method.
|
|||
|
|
*
|
|||
|
|
* @param null|string $default
|
|||
|
|
*/
|
|||
|
|
public static function parseCallback(string $callback, $default = null): array
|
|||
|
|
{
|
|||
|
|
return static::contains($callback, '@') ? explode('@', $callback, 2) : [$callback, $default];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Pluralize the last word of an English, studly caps case string.
|
|||
|
|
*/
|
|||
|
|
public static function pluralStudly(string $value, int $count = 2): string
|
|||
|
|
{
|
|||
|
|
$parts = preg_split('/(.)(?=[A-Z])/u', $value, -1, PREG_SPLIT_DELIM_CAPTURE);
|
|||
|
|
|
|||
|
|
$lastWord = array_pop($parts);
|
|||
|
|
|
|||
|
|
return implode('', $parts) . self::plural($lastWord, $count);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the plural form of an English word.
|
|||
|
|
*/
|
|||
|
|
public static function plural(string $value, int $count = 2): string
|
|||
|
|
{
|
|||
|
|
return Pluralizer::plural($value, $count);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Generate a more truly "random" alpha-numeric string.
|
|||
|
|
*/
|
|||
|
|
public static function random(int $length = 16): string
|
|||
|
|
{
|
|||
|
|
$string = '';
|
|||
|
|
|
|||
|
|
while (($len = strlen($string)) < $length) {
|
|||
|
|
$size = $length - $len;
|
|||
|
|
|
|||
|
|
$bytes = random_bytes($size);
|
|||
|
|
|
|||
|
|
$string .= substr(str_replace(['/', '+', '='], '', base64_encode($bytes)), 0, $size);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $string;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Repeat the given string.
|
|||
|
|
*
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function repeat(string $string, int $times)
|
|||
|
|
{
|
|||
|
|
return str_repeat($string, $times);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Replace a given value in the string sequentially with an array.
|
|||
|
|
*/
|
|||
|
|
public static function replaceArray(string $search, array $replace, string $subject): string
|
|||
|
|
{
|
|||
|
|
foreach ($replace as $value) {
|
|||
|
|
$subject = static::replaceFirst($search, (string) $value, $subject);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Replace the given value in the given string.
|
|||
|
|
*
|
|||
|
|
* @param string|string[] $search
|
|||
|
|
* @param string|string[] $replace
|
|||
|
|
* @param string|string[] $subject
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function replace($search, $replace, $subject)
|
|||
|
|
{
|
|||
|
|
return str_replace($search, $replace, $subject);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Replace the first occurrence of a given value in the string.
|
|||
|
|
*/
|
|||
|
|
public static function replaceFirst(string $search, string $replace, string $subject): string
|
|||
|
|
{
|
|||
|
|
if ($search == '') {
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$position = strpos($subject, $search);
|
|||
|
|
|
|||
|
|
if ($position !== false) {
|
|||
|
|
return substr_replace($subject, $replace, $position, strlen($search));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Replace the last occurrence of a given value in the string.
|
|||
|
|
*/
|
|||
|
|
public static function replaceLast(string $search, string $replace, string $subject): string
|
|||
|
|
{
|
|||
|
|
$position = strrpos($subject, $search);
|
|||
|
|
|
|||
|
|
if ($position !== false) {
|
|||
|
|
return substr_replace($subject, $replace, $position, strlen($search));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $subject;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Remove any occurrence of the given string in the subject.
|
|||
|
|
*
|
|||
|
|
* @param array<string>|string $search
|
|||
|
|
* @param string $subject
|
|||
|
|
* @param bool $caseSensitive
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function remove($search, $subject, $caseSensitive = true)
|
|||
|
|
{
|
|||
|
|
return $caseSensitive
|
|||
|
|
? str_replace($search, '', $subject)
|
|||
|
|
: str_ireplace($search, '', $subject);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Begin a string with a single instance of a given value.
|
|||
|
|
*/
|
|||
|
|
public static function start(string $value, string $prefix): string
|
|||
|
|
{
|
|||
|
|
$quoted = preg_quote($prefix, '/');
|
|||
|
|
|
|||
|
|
return $prefix . preg_replace('/^(?:' . $quoted . ')+/u', '', $value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Strip HTML and PHP tags from the given string.
|
|||
|
|
*
|
|||
|
|
* @param null|string|string[] $allowedTags
|
|||
|
|
*/
|
|||
|
|
public static function stripTags(string $value, $allowedTags = null): string
|
|||
|
|
{
|
|||
|
|
return strip_tags($value, $allowedTags);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert the given string to upper-case.
|
|||
|
|
*/
|
|||
|
|
public static function upper(string $value): string
|
|||
|
|
{
|
|||
|
|
return mb_strtoupper($value, 'UTF-8');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert the given string to title case.
|
|||
|
|
*/
|
|||
|
|
public static function title(string $value): string
|
|||
|
|
{
|
|||
|
|
return mb_convert_case($value, MB_CASE_TITLE, 'UTF-8');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Get the singular form of an English word.
|
|||
|
|
*/
|
|||
|
|
public static function singular(string $value): string
|
|||
|
|
{
|
|||
|
|
return Pluralizer::singular($value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Generate a URL friendly "slug" from a given string.
|
|||
|
|
*/
|
|||
|
|
public static function slug(string $title, string $separator = '-', string $language = 'en'): string
|
|||
|
|
{
|
|||
|
|
$title = $language ? static::ascii($title, $language) : $title;
|
|||
|
|
|
|||
|
|
// Convert all dashes/underscores into separator
|
|||
|
|
$flip = $separator === '-' ? '_' : '-';
|
|||
|
|
|
|||
|
|
$title = preg_replace('![' . preg_quote($flip) . ']+!u', $separator, $title);
|
|||
|
|
|
|||
|
|
// Replace @ with the word 'at'
|
|||
|
|
$title = str_replace('@', $separator . 'at' . $separator, $title);
|
|||
|
|
|
|||
|
|
// Remove all characters that are not the separator, letters, numbers, or whitespace.
|
|||
|
|
$title = preg_replace('![^' . preg_quote($separator) . '\pL\pN\s]+!u', '', mb_strtolower($title));
|
|||
|
|
|
|||
|
|
// Replace all separator characters and whitespace by a single separator
|
|||
|
|
$title = preg_replace('![' . preg_quote($separator) . '\s]+!u', $separator, $title);
|
|||
|
|
|
|||
|
|
return trim($title, $separator);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert a string to snake case.
|
|||
|
|
*/
|
|||
|
|
public static function snake(string $value, string $delimiter = '_'): string
|
|||
|
|
{
|
|||
|
|
$key = $value;
|
|||
|
|
|
|||
|
|
if (isset(static::$snakeCache[$key][$delimiter])) {
|
|||
|
|
return static::$snakeCache[$key][$delimiter];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
if (! ctype_lower($value)) {
|
|||
|
|
$value = preg_replace('/\s+/u', '', ucwords($value));
|
|||
|
|
|
|||
|
|
$value = static::lower(preg_replace('/(.)(?=[A-Z])/u', '$1' . $delimiter, $value));
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return static::$snakeCache[$key][$delimiter] = $value;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Determine if a given string starts with a given substring.
|
|||
|
|
*
|
|||
|
|
* @param array|string $needles
|
|||
|
|
*/
|
|||
|
|
public static function startsWith(string $haystack, $needles): bool
|
|||
|
|
{
|
|||
|
|
foreach ((array) $needles as $needle) {
|
|||
|
|
if ($needle !== '' && substr($haystack, 0, strlen($needle)) === (string) $needle) {
|
|||
|
|
return true;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return false;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Convert a value to studly caps case.
|
|||
|
|
*/
|
|||
|
|
public static function studly(string $value, string $gap = ''): string
|
|||
|
|
{
|
|||
|
|
$key = $value;
|
|||
|
|
|
|||
|
|
if (isset(static::$studlyCache[$key])) {
|
|||
|
|
return static::$studlyCache[$key];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$value = ucwords(str_replace(['-', '_'], ' ', $value));
|
|||
|
|
|
|||
|
|
return static::$studlyCache[$key] = str_replace(' ', $gap, $value);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Returns the portion of string specified by the start and length parameters.
|
|||
|
|
*
|
|||
|
|
* @param string $string
|
|||
|
|
* @param int $start
|
|||
|
|
* @param null|int $length
|
|||
|
|
* @return string
|
|||
|
|
*/
|
|||
|
|
public static function substr($string, $start, $length = null)
|
|||
|
|
{
|
|||
|
|
return mb_substr($string, $start, $length, 'UTF-8');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Returns the number of substring occurrences.
|
|||
|
|
*
|
|||
|
|
* @param string $haystack
|
|||
|
|
* @param string $needle
|
|||
|
|
* @param int $offset
|
|||
|
|
* @param null|int $length
|
|||
|
|
* @return int
|
|||
|
|
*/
|
|||
|
|
public static function substrCount($haystack, $needle, $offset = 0, $length = null)
|
|||
|
|
{
|
|||
|
|
if (! is_null($length)) {
|
|||
|
|
return substr_count($haystack, $needle, $offset, $length);
|
|||
|
|
}
|
|||
|
|
return substr_count($haystack, $needle, $offset);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Make a string's first character uppercase.
|
|||
|
|
*/
|
|||
|
|
public static function ucfirst(string $string): string
|
|||
|
|
{
|
|||
|
|
return static::upper(static::substr($string, 0, 1)) . static::substr($string, 1);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Replaces the first or the last ones chars from a string by a given char.
|
|||
|
|
*
|
|||
|
|
* @param int $offset if is negative it starts from the end
|
|||
|
|
* @param string $replacement default is *
|
|||
|
|
*/
|
|||
|
|
public static function mask(string $string, int $offset = 0, int $length = 0, string $replacement = '*')
|
|||
|
|
{
|
|||
|
|
if ($length < 0) {
|
|||
|
|
throw new InvalidArgumentException('The length must equal or greater than zero.');
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$stringLength = mb_strlen($string);
|
|||
|
|
$absOffset = abs($offset);
|
|||
|
|
if ($absOffset >= $stringLength) {
|
|||
|
|
return $string;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
$hiddenLength = $length ?: $stringLength - $absOffset;
|
|||
|
|
|
|||
|
|
if ($offset >= 0) {
|
|||
|
|
return mb_substr($string, 0, $offset) . str_repeat($replacement, $hiddenLength) . mb_substr($string, $offset + $hiddenLength);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return mb_substr($string, 0, max($stringLength - $hiddenLength - $absOffset, 0)) . str_repeat($replacement, $hiddenLength) . mb_substr($string, $offset);
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Returns the replacements for the ascii method.
|
|||
|
|
* Note: Adapted from Stringy\Stringy.
|
|||
|
|
*
|
|||
|
|
* @see https://github.com/danielstjules/Stringy/blob/3.1.0/LICENSE.txt
|
|||
|
|
*/
|
|||
|
|
protected static function charsArray(): array
|
|||
|
|
{
|
|||
|
|
static $charsArray;
|
|||
|
|
|
|||
|
|
if (isset($charsArray)) {
|
|||
|
|
return $charsArray;
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $charsArray = [
|
|||
|
|
'0' => ['°', '₀', '۰', '0'],
|
|||
|
|
'1' => ['¹', '₁', '۱', '1'],
|
|||
|
|
'2' => ['²', '₂', '۲', '2'],
|
|||
|
|
'3' => ['³', '₃', '۳', '3'],
|
|||
|
|
'4' => ['⁴', '₄', '۴', '٤', '4'],
|
|||
|
|
'5' => ['⁵', '₅', '۵', '٥', '5'],
|
|||
|
|
'6' => ['⁶', '₆', '۶', '٦', '6'],
|
|||
|
|
'7' => ['⁷', '₇', '۷', '7'],
|
|||
|
|
'8' => ['⁸', '₈', '۸', '8'],
|
|||
|
|
'9' => ['⁹', '₉', '۹', '9'],
|
|||
|
|
'a' => [
|
|||
|
|
'à',
|
|||
|
|
'á',
|
|||
|
|
'ả',
|
|||
|
|
'ã',
|
|||
|
|
'ạ',
|
|||
|
|
'ă',
|
|||
|
|
'ắ',
|
|||
|
|
'ằ',
|
|||
|
|
'ẳ',
|
|||
|
|
'ẵ',
|
|||
|
|
'ặ',
|
|||
|
|
'â',
|
|||
|
|
'ấ',
|
|||
|
|
'ầ',
|
|||
|
|
'ẩ',
|
|||
|
|
'ẫ',
|
|||
|
|
'ậ',
|
|||
|
|
'ā',
|
|||
|
|
'ą',
|
|||
|
|
'å',
|
|||
|
|
'α',
|
|||
|
|
'ά',
|
|||
|
|
'ἀ',
|
|||
|
|
'ἁ',
|
|||
|
|
'ἂ',
|
|||
|
|
'ἃ',
|
|||
|
|
'ἄ',
|
|||
|
|
'ἅ',
|
|||
|
|
'ἆ',
|
|||
|
|
'ἇ',
|
|||
|
|
'ᾀ',
|
|||
|
|
'ᾁ',
|
|||
|
|
'ᾂ',
|
|||
|
|
'ᾃ',
|
|||
|
|
'ᾄ',
|
|||
|
|
'ᾅ',
|
|||
|
|
'ᾆ',
|
|||
|
|
'ᾇ',
|
|||
|
|
'ὰ',
|
|||
|
|
'ά',
|
|||
|
|
'ᾰ',
|
|||
|
|
'ᾱ',
|
|||
|
|
'ᾲ',
|
|||
|
|
'ᾳ',
|
|||
|
|
'ᾴ',
|
|||
|
|
'ᾶ',
|
|||
|
|
'ᾷ',
|
|||
|
|
'а',
|
|||
|
|
'أ',
|
|||
|
|
'အ',
|
|||
|
|
'ာ',
|
|||
|
|
'ါ',
|
|||
|
|
'ǻ',
|
|||
|
|
'ǎ',
|
|||
|
|
'ª',
|
|||
|
|
'ა',
|
|||
|
|
'अ',
|
|||
|
|
'ا',
|
|||
|
|
'a',
|
|||
|
|
'ä',
|
|||
|
|
],
|
|||
|
|
'b' => ['б', 'β', 'ب', 'ဗ', 'ბ', 'b'],
|
|||
|
|
'c' => ['ç', 'ć', 'č', 'ĉ', 'ċ', 'c'],
|
|||
|
|
'd' => ['ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ', 'д', 'δ', 'د', 'ض', 'ဍ', 'ဒ', 'დ', 'd'],
|
|||
|
|
'e' => [
|
|||
|
|
'é',
|
|||
|
|
'è',
|
|||
|
|
'ẻ',
|
|||
|
|
'ẽ',
|
|||
|
|
'ẹ',
|
|||
|
|
'ê',
|
|||
|
|
'ế',
|
|||
|
|
'ề',
|
|||
|
|
'ể',
|
|||
|
|
'ễ',
|
|||
|
|
'ệ',
|
|||
|
|
'ë',
|
|||
|
|
'ē',
|
|||
|
|
'ę',
|
|||
|
|
'ě',
|
|||
|
|
'ĕ',
|
|||
|
|
'ė',
|
|||
|
|
'ε',
|
|||
|
|
'έ',
|
|||
|
|
'ἐ',
|
|||
|
|
'ἑ',
|
|||
|
|
'ἒ',
|
|||
|
|
'ἓ',
|
|||
|
|
'ἔ',
|
|||
|
|
'ἕ',
|
|||
|
|
'ὲ',
|
|||
|
|
'έ',
|
|||
|
|
'е',
|
|||
|
|
'ё',
|
|||
|
|
'э',
|
|||
|
|
'є',
|
|||
|
|
'ə',
|
|||
|
|
'ဧ',
|
|||
|
|
'ေ',
|
|||
|
|
'ဲ',
|
|||
|
|
'ე',
|
|||
|
|
'ए',
|
|||
|
|
'إ',
|
|||
|
|
'ئ',
|
|||
|
|
'e',
|
|||
|
|
],
|
|||
|
|
'f' => ['ф', 'φ', 'ف', 'ƒ', 'ფ', 'f'],
|
|||
|
|
'g' => ['ĝ', 'ğ', 'ġ', 'ģ', 'г', 'ґ', 'γ', 'ဂ', 'გ', 'گ', 'g'],
|
|||
|
|
'h' => ['ĥ', 'ħ', 'η', 'ή', 'ح', 'ه', 'ဟ', 'ှ', 'ჰ', 'h'],
|
|||
|
|
'i' => [
|
|||
|
|
'í',
|
|||
|
|
'ì',
|
|||
|
|
'ỉ',
|
|||
|
|
'ĩ',
|
|||
|
|
'ị',
|
|||
|
|
'î',
|
|||
|
|
'ï',
|
|||
|
|
'ī',
|
|||
|
|
'ĭ',
|
|||
|
|
'į',
|
|||
|
|
'ı',
|
|||
|
|
'ι',
|
|||
|
|
'ί',
|
|||
|
|
'ϊ',
|
|||
|
|
'ΐ',
|
|||
|
|
'ἰ',
|
|||
|
|
'ἱ',
|
|||
|
|
'ἲ',
|
|||
|
|
'ἳ',
|
|||
|
|
'ἴ',
|
|||
|
|
'ἵ',
|
|||
|
|
'ἶ',
|
|||
|
|
'ἷ',
|
|||
|
|
'ὶ',
|
|||
|
|
'ί',
|
|||
|
|
'ῐ',
|
|||
|
|
'ῑ',
|
|||
|
|
'ῒ',
|
|||
|
|
'ΐ',
|
|||
|
|
'ῖ',
|
|||
|
|
'ῗ',
|
|||
|
|
'і',
|
|||
|
|
'ї',
|
|||
|
|
'и',
|
|||
|
|
'ဣ',
|
|||
|
|
'ိ',
|
|||
|
|
'ီ',
|
|||
|
|
'ည်',
|
|||
|
|
'ǐ',
|
|||
|
|
'ი',
|
|||
|
|
'इ',
|
|||
|
|
'ی',
|
|||
|
|
'i',
|
|||
|
|
],
|
|||
|
|
'j' => ['ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'j'],
|
|||
|
|
'k' => ['ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ', 'ک', 'k'],
|
|||
|
|
'l' => ['ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ', 'l'],
|
|||
|
|
'm' => ['м', 'μ', 'م', 'မ', 'მ', 'm'],
|
|||
|
|
'n' => ['ñ', 'ń', 'ň', 'ņ', 'ʼn', 'ŋ', 'ν', 'н', 'ن', 'န', 'ნ', 'n'],
|
|||
|
|
'o' => [
|
|||
|
|
'ó',
|
|||
|
|
'ò',
|
|||
|
|
'ỏ',
|
|||
|
|
'õ',
|
|||
|
|
'ọ',
|
|||
|
|
'ô',
|
|||
|
|
'ố',
|
|||
|
|
'ồ',
|
|||
|
|
'ổ',
|
|||
|
|
'ỗ',
|
|||
|
|
'ộ',
|
|||
|
|
'ơ',
|
|||
|
|
'ớ',
|
|||
|
|
'ờ',
|
|||
|
|
'ở',
|
|||
|
|
'ỡ',
|
|||
|
|
'ợ',
|
|||
|
|
'ø',
|
|||
|
|
'ō',
|
|||
|
|
'ő',
|
|||
|
|
'ŏ',
|
|||
|
|
'ο',
|
|||
|
|
'ὀ',
|
|||
|
|
'ὁ',
|
|||
|
|
'ὂ',
|
|||
|
|
'ὃ',
|
|||
|
|
'ὄ',
|
|||
|
|
'ὅ',
|
|||
|
|
'ὸ',
|
|||
|
|
'ό',
|
|||
|
|
'о',
|
|||
|
|
'و',
|
|||
|
|
'θ',
|
|||
|
|
'ို',
|
|||
|
|
'ǒ',
|
|||
|
|
'ǿ',
|
|||
|
|
'º',
|
|||
|
|
'ო',
|
|||
|
|
'ओ',
|
|||
|
|
'o',
|
|||
|
|
'ö',
|
|||
|
|
],
|
|||
|
|
'p' => ['п', 'π', 'ပ', 'პ', 'پ', 'p'],
|
|||
|
|
'q' => ['ყ', 'q'],
|
|||
|
|
'r' => ['ŕ', 'ř', 'ŗ', 'р', 'ρ', 'ر', 'რ', 'r'],
|
|||
|
|
's' => ['ś', 'š', 'ş', 'с', 'σ', 'ș', 'ς', 'س', 'ص', 'စ', 'ſ', 'ს', 's'],
|
|||
|
|
't' => ['ť', 'ţ', 'т', 'τ', 'ț', 'ت', 'ط', 'ဋ', 'တ', 'ŧ', 'თ', 'ტ', 't'],
|
|||
|
|
'u' => [
|
|||
|
|
'ú',
|
|||
|
|
'ù',
|
|||
|
|
'ủ',
|
|||
|
|
'ũ',
|
|||
|
|
'ụ',
|
|||
|
|
'ư',
|
|||
|
|
'ứ',
|
|||
|
|
'ừ',
|
|||
|
|
'ử',
|
|||
|
|
'ữ',
|
|||
|
|
'ự',
|
|||
|
|
'û',
|
|||
|
|
'ū',
|
|||
|
|
'ů',
|
|||
|
|
'ű',
|
|||
|
|
'ŭ',
|
|||
|
|
'ų',
|
|||
|
|
'µ',
|
|||
|
|
'у',
|
|||
|
|
'ဉ',
|
|||
|
|
'ု',
|
|||
|
|
'ူ',
|
|||
|
|
'ǔ',
|
|||
|
|
'ǖ',
|
|||
|
|
'ǘ',
|
|||
|
|
'ǚ',
|
|||
|
|
'ǜ',
|
|||
|
|
'უ',
|
|||
|
|
'उ',
|
|||
|
|
'u',
|
|||
|
|
'ў',
|
|||
|
|
'ü',
|
|||
|
|
],
|
|||
|
|
'v' => ['в', 'ვ', 'ϐ', 'v'],
|
|||
|
|
'w' => ['ŵ', 'ω', 'ώ', 'ဝ', 'ွ', 'w'],
|
|||
|
|
'x' => ['χ', 'ξ', 'x'],
|
|||
|
|
'y' => ['ý', 'ỳ', 'ỷ', 'ỹ', 'ỵ', 'ÿ', 'ŷ', 'й', 'ы', 'υ', 'ϋ', 'ύ', 'ΰ', 'ي', 'ယ', 'y'],
|
|||
|
|
'z' => ['ź', 'ž', 'ż', 'з', 'ζ', 'ز', 'ဇ', 'ზ', 'z'],
|
|||
|
|
'aa' => ['ع', 'आ', 'آ'],
|
|||
|
|
'ae' => ['æ', 'ǽ'],
|
|||
|
|
'ai' => ['ऐ'],
|
|||
|
|
'ch' => ['ч', 'ჩ', 'ჭ', 'چ'],
|
|||
|
|
'dj' => ['ђ', 'đ'],
|
|||
|
|
'dz' => ['џ', 'ძ'],
|
|||
|
|
'ei' => ['ऍ'],
|
|||
|
|
'gh' => ['غ', 'ღ'],
|
|||
|
|
'ii' => ['ई'],
|
|||
|
|
'ij' => ['ij'],
|
|||
|
|
'kh' => ['х', 'خ', 'ხ'],
|
|||
|
|
'lj' => ['љ'],
|
|||
|
|
'nj' => ['њ'],
|
|||
|
|
'oe' => ['ö', 'œ', 'ؤ'],
|
|||
|
|
'oi' => ['ऑ'],
|
|||
|
|
'oii' => ['ऒ'],
|
|||
|
|
'ps' => ['ψ'],
|
|||
|
|
'sh' => ['ш', 'შ', 'ش'],
|
|||
|
|
'shch' => ['щ'],
|
|||
|
|
'ss' => ['ß'],
|
|||
|
|
'sx' => ['ŝ'],
|
|||
|
|
'th' => ['þ', 'ϑ', 'ث', 'ذ', 'ظ'],
|
|||
|
|
'ts' => ['ц', 'ც', 'წ'],
|
|||
|
|
'ue' => ['ü'],
|
|||
|
|
'uu' => ['ऊ'],
|
|||
|
|
'ya' => ['я'],
|
|||
|
|
'yu' => ['ю'],
|
|||
|
|
'zh' => ['ж', 'ჟ', 'ژ'],
|
|||
|
|
'(c)' => ['©'],
|
|||
|
|
'A' => [
|
|||
|
|
'Á',
|
|||
|
|
'À',
|
|||
|
|
'Ả',
|
|||
|
|
'Ã',
|
|||
|
|
'Ạ',
|
|||
|
|
'Ă',
|
|||
|
|
'Ắ',
|
|||
|
|
'Ằ',
|
|||
|
|
'Ẳ',
|
|||
|
|
'Ẵ',
|
|||
|
|
'Ặ',
|
|||
|
|
'Â',
|
|||
|
|
'Ấ',
|
|||
|
|
'Ầ',
|
|||
|
|
'Ẩ',
|
|||
|
|
'Ẫ',
|
|||
|
|
'Ậ',
|
|||
|
|
'Å',
|
|||
|
|
'Ā',
|
|||
|
|
'Ą',
|
|||
|
|
'Α',
|
|||
|
|
'Ά',
|
|||
|
|
'Ἀ',
|
|||
|
|
'Ἁ',
|
|||
|
|
'Ἂ',
|
|||
|
|
'Ἃ',
|
|||
|
|
'Ἄ',
|
|||
|
|
'Ἅ',
|
|||
|
|
'Ἆ',
|
|||
|
|
'Ἇ',
|
|||
|
|
'ᾈ',
|
|||
|
|
'ᾉ',
|
|||
|
|
'ᾊ',
|
|||
|
|
'ᾋ',
|
|||
|
|
'ᾌ',
|
|||
|
|
'ᾍ',
|
|||
|
|
'ᾎ',
|
|||
|
|
'ᾏ',
|
|||
|
|
'Ᾰ',
|
|||
|
|
'Ᾱ',
|
|||
|
|
'Ὰ',
|
|||
|
|
'Ά',
|
|||
|
|
'ᾼ',
|
|||
|
|
'А',
|
|||
|
|
'Ǻ',
|
|||
|
|
'Ǎ',
|
|||
|
|
'A',
|
|||
|
|
'Ä',
|
|||
|
|
],
|
|||
|
|
'B' => ['Б', 'Β', 'ब', 'B'],
|
|||
|
|
'C' => ['Ç', 'Ć', 'Č', 'Ĉ', 'Ċ', 'C'],
|
|||
|
|
'D' => ['Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д', 'Δ', 'D'],
|
|||
|
|
'E' => [
|
|||
|
|
'É',
|
|||
|
|
'È',
|
|||
|
|
'Ẻ',
|
|||
|
|
'Ẽ',
|
|||
|
|
'Ẹ',
|
|||
|
|
'Ê',
|
|||
|
|
'Ế',
|
|||
|
|
'Ề',
|
|||
|
|
'Ể',
|
|||
|
|
'Ễ',
|
|||
|
|
'Ệ',
|
|||
|
|
'Ë',
|
|||
|
|
'Ē',
|
|||
|
|
'Ę',
|
|||
|
|
'Ě',
|
|||
|
|
'Ĕ',
|
|||
|
|
'Ė',
|
|||
|
|
'Ε',
|
|||
|
|
'Έ',
|
|||
|
|
'Ἐ',
|
|||
|
|
'Ἑ',
|
|||
|
|
'Ἒ',
|
|||
|
|
'Ἓ',
|
|||
|
|
'Ἔ',
|
|||
|
|
'Ἕ',
|
|||
|
|
'Έ',
|
|||
|
|
'Ὲ',
|
|||
|
|
'Е',
|
|||
|
|
'Ё',
|
|||
|
|
'Э',
|
|||
|
|
'Є',
|
|||
|
|
'Ə',
|
|||
|
|
'E',
|
|||
|
|
],
|
|||
|
|
'F' => ['Ф', 'Φ', 'F'],
|
|||
|
|
'G' => ['Ğ', 'Ġ', 'Ģ', 'Г', 'Ґ', 'Γ', 'G'],
|
|||
|
|
'H' => ['Η', 'Ή', 'Ħ', 'H'],
|
|||
|
|
'I' => [
|
|||
|
|
'Í',
|
|||
|
|
'Ì',
|
|||
|
|
'Ỉ',
|
|||
|
|
'Ĩ',
|
|||
|
|
'Ị',
|
|||
|
|
'Î',
|
|||
|
|
'Ï',
|
|||
|
|
'Ī',
|
|||
|
|
'Ĭ',
|
|||
|
|
'Į',
|
|||
|
|
'İ',
|
|||
|
|
'Ι',
|
|||
|
|
'Ί',
|
|||
|
|
'Ϊ',
|
|||
|
|
'Ἰ',
|
|||
|
|
'Ἱ',
|
|||
|
|
'Ἳ',
|
|||
|
|
'Ἴ',
|
|||
|
|
'Ἵ',
|
|||
|
|
'Ἶ',
|
|||
|
|
'Ἷ',
|
|||
|
|
'Ῐ',
|
|||
|
|
'Ῑ',
|
|||
|
|
'Ὶ',
|
|||
|
|
'Ί',
|
|||
|
|
'И',
|
|||
|
|
'І',
|
|||
|
|
'Ї',
|
|||
|
|
'Ǐ',
|
|||
|
|
'ϒ',
|
|||
|
|
'I',
|
|||
|
|
],
|
|||
|
|
'J' => ['J'],
|
|||
|
|
'K' => ['К', 'Κ', 'K'],
|
|||
|
|
'L' => ['Ĺ', 'Ł', 'Л', 'Λ', 'Ļ', 'Ľ', 'Ŀ', 'ल', 'L'],
|
|||
|
|
'M' => ['М', 'Μ', 'M'],
|
|||
|
|
'N' => ['Ń', 'Ñ', 'Ň', 'Ņ', 'Ŋ', 'Н', 'Ν', 'N'],
|
|||
|
|
'O' => [
|
|||
|
|
'Ó',
|
|||
|
|
'Ò',
|
|||
|
|
'Ỏ',
|
|||
|
|
'Õ',
|
|||
|
|
'Ọ',
|
|||
|
|
'Ô',
|
|||
|
|
'Ố',
|
|||
|
|
'Ồ',
|
|||
|
|
'Ổ',
|
|||
|
|
'Ỗ',
|
|||
|
|
'Ộ',
|
|||
|
|
'Ơ',
|
|||
|
|
'Ớ',
|
|||
|
|
'Ờ',
|
|||
|
|
'Ở',
|
|||
|
|
'Ỡ',
|
|||
|
|
'Ợ',
|
|||
|
|
'Ø',
|
|||
|
|
'Ō',
|
|||
|
|
'Ő',
|
|||
|
|
'Ŏ',
|
|||
|
|
'Ο',
|
|||
|
|
'Ό',
|
|||
|
|
'Ὀ',
|
|||
|
|
'Ὁ',
|
|||
|
|
'Ὂ',
|
|||
|
|
'Ὃ',
|
|||
|
|
'Ὄ',
|
|||
|
|
'Ὅ',
|
|||
|
|
'Ὸ',
|
|||
|
|
'Ό',
|
|||
|
|
'О',
|
|||
|
|
'Θ',
|
|||
|
|
'Ө',
|
|||
|
|
'Ǒ',
|
|||
|
|
'Ǿ',
|
|||
|
|
'O',
|
|||
|
|
'Ö',
|
|||
|
|
],
|
|||
|
|
'P' => ['П', 'Π', 'P'],
|
|||
|
|
'Q' => ['Q'],
|
|||
|
|
'R' => ['Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'R'],
|
|||
|
|
'S' => ['Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'S'],
|
|||
|
|
'T' => ['Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'T'],
|
|||
|
|
'U' => [
|
|||
|
|
'Ú',
|
|||
|
|
'Ù',
|
|||
|
|
'Ủ',
|
|||
|
|
'Ũ',
|
|||
|
|
'Ụ',
|
|||
|
|
'Ư',
|
|||
|
|
'Ứ',
|
|||
|
|
'Ừ',
|
|||
|
|
'Ử',
|
|||
|
|
'Ữ',
|
|||
|
|
'Ự',
|
|||
|
|
'Û',
|
|||
|
|
'Ū',
|
|||
|
|
'Ů',
|
|||
|
|
'Ű',
|
|||
|
|
'Ŭ',
|
|||
|
|
'Ų',
|
|||
|
|
'У',
|
|||
|
|
'Ǔ',
|
|||
|
|
'Ǖ',
|
|||
|
|
'Ǘ',
|
|||
|
|
'Ǚ',
|
|||
|
|
'Ǜ',
|
|||
|
|
'U',
|
|||
|
|
'Ў',
|
|||
|
|
'Ü',
|
|||
|
|
],
|
|||
|
|
'V' => ['В', 'V'],
|
|||
|
|
'W' => ['Ω', 'Ώ', 'Ŵ', 'W'],
|
|||
|
|
'X' => ['Χ', 'Ξ', 'X'],
|
|||
|
|
'Y' => ['Ý', 'Ỳ', 'Ỷ', 'Ỹ', 'Ỵ', 'Ÿ', 'Ῠ', 'Ῡ', 'Ὺ', 'Ύ', 'Ы', 'Й', 'Υ', 'Ϋ', 'Ŷ', 'Y'],
|
|||
|
|
'Z' => ['Ź', 'Ž', 'Ż', 'З', 'Ζ', 'Z'],
|
|||
|
|
'AE' => ['Æ', 'Ǽ'],
|
|||
|
|
'Ch' => ['Ч'],
|
|||
|
|
'Dj' => ['Ђ'],
|
|||
|
|
'Dz' => ['Џ'],
|
|||
|
|
'Gx' => ['Ĝ'],
|
|||
|
|
'Hx' => ['Ĥ'],
|
|||
|
|
'Ij' => ['IJ'],
|
|||
|
|
'Jx' => ['Ĵ'],
|
|||
|
|
'Kh' => ['Х'],
|
|||
|
|
'Lj' => ['Љ'],
|
|||
|
|
'Nj' => ['Њ'],
|
|||
|
|
'Oe' => ['Œ'],
|
|||
|
|
'Ps' => ['Ψ'],
|
|||
|
|
'Sh' => ['Ш'],
|
|||
|
|
'Shch' => ['Щ'],
|
|||
|
|
'Ss' => ['ẞ'],
|
|||
|
|
'Th' => ['Þ'],
|
|||
|
|
'Ts' => ['Ц'],
|
|||
|
|
'Ya' => ['Я'],
|
|||
|
|
'Yu' => ['Ю'],
|
|||
|
|
'Zh' => ['Ж'],
|
|||
|
|
' ' => [
|
|||
|
|
"\xC2\xA0",
|
|||
|
|
"\xE2\x80\x80",
|
|||
|
|
"\xE2\x80\x81",
|
|||
|
|
"\xE2\x80\x82",
|
|||
|
|
"\xE2\x80\x83",
|
|||
|
|
"\xE2\x80\x84",
|
|||
|
|
"\xE2\x80\x85",
|
|||
|
|
"\xE2\x80\x86",
|
|||
|
|
"\xE2\x80\x87",
|
|||
|
|
"\xE2\x80\x88",
|
|||
|
|
"\xE2\x80\x89",
|
|||
|
|
"\xE2\x80\x8A",
|
|||
|
|
"\xE2\x80\xAF",
|
|||
|
|
"\xE2\x81\x9F",
|
|||
|
|
"\xE3\x80\x80",
|
|||
|
|
"\xEF\xBE\xA0",
|
|||
|
|
],
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
/**
|
|||
|
|
* Returns the language specific replacements for the ascii method.
|
|||
|
|
* Note: Adapted from Stringy\Stringy.
|
|||
|
|
*
|
|||
|
|
* @see https://github.com/danielstjules/Stringy/blob/3.1.0/LICENSE.txt
|
|||
|
|
* @return null|array
|
|||
|
|
*/
|
|||
|
|
protected static function languageSpecificCharsArray(string $language)
|
|||
|
|
{
|
|||
|
|
static $languageSpecific;
|
|||
|
|
|
|||
|
|
if (! isset($languageSpecific)) {
|
|||
|
|
$languageSpecific = [
|
|||
|
|
'bg' => [
|
|||
|
|
['х', 'Х', 'щ', 'Щ', 'ъ', 'Ъ', 'ь', 'Ь'],
|
|||
|
|
['h', 'H', 'sht', 'SHT', 'a', 'А', 'y', 'Y'],
|
|||
|
|
],
|
|||
|
|
'de' => [
|
|||
|
|
['ä', 'ö', 'ü', 'Ä', 'Ö', 'Ü'],
|
|||
|
|
['ae', 'oe', 'ue', 'AE', 'OE', 'UE'],
|
|||
|
|
],
|
|||
|
|
];
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
return $languageSpecific[$language] ?? null;
|
|||
|
|
}
|
|||
|
|
}
|