$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)
{
return lcfirst(static::studly($value));
}
/**
* Get the character at the specified index.
*
* @param string $subject
* @param int $index
* @return null|string
*/
public static function charAt($subject, $index)
{
$length = mb_strlen($subject);
if ($index < 0 ? $index < -$length : $index > $length - 1) {
return null;
}
return mb_substr($subject, $index, 1);
}
/**
* Remove the given string(s) if it exists at the end of the haystack.
*
* @param string $subject
* @param array|string $needle
* @return string
*/
public static function chopEnd($subject, $needle)
{
foreach ((array) $needle as $n) {
if (str_ends_with($subject, $n)) {
return substr($subject, 0, -strlen($n));
}
}
return $subject;
}
/**
* Remove the given string(s) if it exists at the start of the haystack.
*
* @param string $subject
* @param array|string $needle
* @return string
*/
public static function chopStart($subject, $needle)
{
foreach ((array) $needle as $n) {
if (str_starts_with($subject, $n)) {
return substr($subject, strlen($n));
}
}
return $subject;
}
/**
* Determine if a given string contains a given substring.
*
* @param array|string $needles
*/
public static function contains(string $haystack, mixed $needles, bool $ignoreCase = false): bool
{
if ($ignoreCase) {
return static::containsIgnoreCase($haystack, $needles);
}
foreach ((array) $needles as $needle) {
$needle = (string) $needle;
if ($needle !== '' && str_contains($haystack, $needle)) {
return true;
}
}
return false;
}
/**
* Determine if a given string contains a given substring regardless of case sensitivity.
*
* @param array|string $needles
*/
public static function containsIgnoreCase(string $haystack, $needles): bool
{
foreach ((array) $needles as $needle) {
$needle = (string) $needle;
if ($needle !== '' && stripos($haystack, $needle) !== false) {
return true;
}
}
return false;
}
/**
* Determine if a given string contains all array values.
*
* @param string[] $needles
* @return bool
*/
public static function containsAll(string $haystack, array $needles, bool $ignoreCase = false)
{
foreach ($needles as $needle) {
if (! static::contains($haystack, $needle, $ignoreCase)) {
return false;
}
}
return true;
}
/**
* Determine if a given string ends with a given substring.
*
* @param array|string $needles
* @return bool
*/
public static function endsWith(string $haystack, $needles)
{
foreach ((array) $needles as $needle) {
$needle = (string) $needle;
if ($needle !== '' && str_ends_with($haystack, $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
* @param bool $ignoreCase
* @return bool
*/
public static function is($pattern, $value, $ignoreCase = false)
{
$value = (string) $value;
$patterns = Arr::wrap($pattern);
if (empty($patterns)) {
return false;
}
foreach ($patterns as $pattern) {
$pattern = (string) $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#' . ($ignoreCase ? 'iu' : 'u'), $value) === 1) {
return true;
}
}
return false;
}
/**
* Determine if a given string is 7 bit ASCII.
*/
public static function isAscii(string $value): bool
{
if ($value == '') {
return true;
}
return ! preg_match('/[^\x09\x0A\x0D\x20-\x7E]/', $value);
}
/**
* 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)
{
return mb_strlen($value, $encoding);
}
/**
* 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];
}
/**
* Determine if a given string matches a given pattern.
*
* @param iterable|string $patterns
* @param string $value
* @return bool
*/
public static function isMatch($patterns, $value)
{
$value = (string) $value;
if (! is_iterable($patterns)) {
$patterns = [$patterns];
}
foreach ($patterns as $pattern) {
$pattern = (string) $pattern;
if (preg_match($pattern, $value) === 1) {
return true;
}
}
return false;
}
/**
* 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, strlen($value) - mb_strlen($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, strlen($value) - mb_strlen($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, strlen($value) - mb_strlen($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.
* @param mixed $count
*/
public static function pluralStudly(string $value, $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, array|Countable|int $count = 2): string
{
return Pluralizer::plural($value, $count);
}
/**
* Find the multi-byte safe position of the first occurrence of a given substring in a string.
*/
public static function position(string $haystack, string $needle, int $offset = 0, ?string $encoding = null): false|int
{
return mb_strpos($haystack, (string) $needle, $offset, $encoding);
}
/**
* 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.
*
* @param string[] $replace
*/
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
{
if ($search == '') {
return $subject;
}
$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 $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');
}
/**
* Convert the given string to proper case for each word.
*/
public static function headline(string $value): string
{
$parts = explode(' ', $value);
$parts = count($parts) > 1
? array_map([static::class, 'title'], $parts)
: array_map([static::class, 'title'], static::ucsplit(implode('_', $parts)));
$collapsed = static::replace(['-', '_', ' '], '_', implode('_', $parts));
return implode(' ', array_filter(explode('_', $collapsed)));
}
/**
* 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.
* @param mixed $dictionary
*/
public static function slug(string $title, string $separator = '-', ?string $language = 'en', $dictionary = ['@' => 'at']): 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 dictionary words
foreach ($dictionary as $key => $value) {
$dictionary[$key] = $separator . $value . $separator;
}
$title = str_replace(array_keys($dictionary), array_values($dictionary), $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
{
if (! ctype_lower($value)) {
$value = preg_replace('/\s+/u', '', ucwords($value));
$value = static::lower(preg_replace('/(.)(?=[A-Z])/u', '$1' . $delimiter, $value));
}
return $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) {
$needle = (string) $needle;
if ($needle !== '' && str_starts_with($haystack, $needle)) {
return true;
}
}
return false;
}
/**
* Convert a value to studly caps case.
*/
public static function studly(string $value, string $gap = ''): string
{
$value = ucwords(str_replace(['-', '_'], ' ', $value));
return 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 *
* @return string
*/
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);
}
/**
* Determine if a given value is a valid ULID.
*
* @param mixed $value
*/
public static function isUlid($value): bool
{
if (! is_string($value)) {
return false;
}
if (strlen($value) !== 26) {
return false;
}
if (strspn($value, '0123456789ABCDEFGHJKMNPQRSTVWXYZabcdefghjkmnpqrstvwxyz') !== 26) {
return false;
}
return $value[0] <= '7';
}
/**
* Generate a ULID.
*/
public static function ulid(?DateTimeInterface $time = null): Ulid
{
if (! class_exists(Ulid::class)) {
throw new RuntimeException('The "symfony/uid" package is required to use the "ulid" method. Please run "composer require symfony/uid".');
}
return new Ulid(Ulid::generate($time));
}
/**
* Determine if a given value is a valid URL.
*
* @param string $value
*/
public static function isUrl($value, array $protocols = []): bool
{
if (! is_string($value)) {
return false;
}
$protocolList = empty($protocols)
? 'aaa|aaas|about|acap|acct|acd|acr|adiumxtra|adt|afp|afs|aim|amss|android|appdata|apt|ark|attachment|aw|barion|beshare|bitcoin|bitcoincash|blob|bolo|browserext|calculator|callto|cap|cast|casts|chrome|chrome-extension|cid|coap|coap\+tcp|coap\+ws|coaps|coaps\+tcp|coaps\+ws|com-eventbrite-attendee|content|conti|crid|cvs|dab|data|dav|diaspora|dict|did|dis|dlna-playcontainer|dlna-playsingle|dns|dntp|dpp|drm|drop|dtn|dvb|ed2k|elsi|example|facetime|fax|feed|feedready|file|filesystem|finger|first-run-pen-experience|fish|fm|ftp|fuchsia-pkg|geo|gg|git|gizmoproject|go|gopher|graph|gtalk|h323|ham|hcap|hcp|http|https|hxxp|hxxps|hydrazone|iax|icap|icon|im|imap|info|iotdisco|ipn|ipp|ipps|irc|irc6|ircs|iris|iris\.beep|iris\.lwz|iris\.xpc|iris\.xpcs|isostore|itms|jabber|jar|jms|keyparc|lastfm|ldap|ldaps|leaptofrogans|lorawan|lvlt|magnet|mailserver|mailto|maps|market|message|mid|mms|modem|mongodb|moz|ms-access|ms-browser-extension|ms-calculator|ms-drive-to|ms-enrollment|ms-excel|ms-eyecontrolspeech|ms-gamebarservices|ms-gamingoverlay|ms-getoffice|ms-help|ms-infopath|ms-inputapp|ms-lockscreencomponent-config|ms-media-stream-id|ms-mixedrealitycapture|ms-mobileplans|ms-officeapp|ms-people|ms-project|ms-powerpoint|ms-publisher|ms-restoretabcompanion|ms-screenclip|ms-screensketch|ms-search|ms-search-repair|ms-secondary-screen-controller|ms-secondary-screen-setup|ms-settings|ms-settings-airplanemode|ms-settings-bluetooth|ms-settings-camera|ms-settings-cellular|ms-settings-cloudstorage|ms-settings-connectabledevices|ms-settings-displays-topology|ms-settings-emailandaccounts|ms-settings-language|ms-settings-location|ms-settings-lock|ms-settings-nfctransactions|ms-settings-notifications|ms-settings-power|ms-settings-privacy|ms-settings-proximity|ms-settings-screenrotation|ms-settings-wifi|ms-settings-workplace|ms-spd|ms-sttoverlay|ms-transit-to|ms-useractivityset|ms-virtualtouchpad|ms-visio|ms-walk-to|ms-whiteboard|ms-whiteboard-cmd|ms-word|msnim|msrp|msrps|mss|mtqp|mumble|mupdate|mvn|news|nfs|ni|nih|nntp|notes|ocf|oid|onenote|onenote-cmd|opaquelocktoken|openpgp4fpr|pack|palm|paparazzi|payto|pkcs11|platform|pop|pres|prospero|proxy|pwid|psyc|pttp|qb|query|redis|rediss|reload|res|resource|rmi|rsync|rtmfp|rtmp|rtsp|rtsps|rtspu|s3|secondlife|service|session|sftp|sgn|shttp|sieve|simpleledger|sip|sips|skype|smb|sms|smtp|snews|snmp|soap\.beep|soap\.beeps|soldat|spiffe|spotify|ssh|steam|stun|stuns|submit|svn|tag|teamspeak|tel|teliaeid|telnet|tftp|tg|things|thismessage|tip|tn3270|tool|ts3server|turn|turns|tv|udp|unreal|urn|ut2004|v-event|vemmi|ventrilo|videotex|vnc|view-source|wais|webcal|wpid|ws|wss|wtai|wyciwyg|xcon|xcon-userid|xfire|xmlrpc\.beep|xmlrpc\.beeps|xmpp|xri|ymsgr|z39\.50|z39\.50r|z39\.50s'
: implode('|', $protocols);
/*
* This pattern is derived from Symfony\Component\Validator\Constraints\UrlValidator (5.0.7).
*
* (c) Fabien Potencier http://symfony.com
*/
$pattern = '~^
(DEFAULT_PROTOCOLS):// # protocol
(((?:[\_\.\pL\pN-]|%[0-9A-Fa-f]{2})+:)?((?:[\_\.\pL\pN-]|%[0-9A-Fa-f]{2})+)@)? # basic auth
(
([\pL\pN\pS\-\_\.])+(\.?([\pL\pN]|xn\-\-[\pL\pN-]+)+\.?) # a domain name
| # or
\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3} # an IP address
| # or
\[
(?:(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){6})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:::(?:(?:(?:[0-9a-f]{1,4})):){5})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){4})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,1}(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){3})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,2}(?:(?:[0-9a-f]{1,4})))?::(?:(?:(?:[0-9a-f]{1,4})):){2})(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,3}(?:(?:[0-9a-f]{1,4})))?::(?:(?:[0-9a-f]{1,4})):)(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,4}(?:(?:[0-9a-f]{1,4})))?::)(?:(?:(?:(?:(?:[0-9a-f]{1,4})):(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9]))\.){3}(?:(?:25[0-5]|(?:[1-9]|1[0-9]|2[0-4])?[0-9])))))))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,5}(?:(?:[0-9a-f]{1,4})))?::)(?:(?:[0-9a-f]{1,4})))|(?:(?:(?:(?:(?:(?:[0-9a-f]{1,4})):){0,6}(?:(?:[0-9a-f]{1,4})))?::))))
\] # an IPv6 address
)
(:[0-9]+)? # a port (optional)
(?:/ (?:[\pL\pN\-._\~!$&\'()*+,;=:@]|%[0-9A-Fa-f]{2})* )* # a path
(?:\? (?:[\pL\pN\-._\~!$&\'\[\]()*+,;=:@/?]|%[0-9A-Fa-f]{2})* )? # a query (optional)
(?:\# (?:[\pL\pN\-._\~!$&\'()*+,;=:@/?]|%[0-9A-Fa-f]{2})* )? # a fragment (optional)
$~ixu';
return preg_match(str_replace('DEFAULT_PROTOCOLS', $protocolList, $pattern), $value) > 0;
}
/**
* Determine if a given value is a valid UUID.
*
* @param mixed $value
*/
public static function isUuid($value): bool
{
if (! is_string($value)) {
return false;
}
return preg_match('/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iD', $value) > 0;
}
/**
* Generate a UUID (version 4).
*/
public static function uuid(): UuidInterface
{
if (! class_exists(Uuid::class)) {
throw new RuntimeException('The "ramsey/uuid" package is required to use the "uuid" method. Please run "composer require ramsey/uuid".');
}
return Uuid::uuid4();
}
/**
* Generate a UUID (version 7).
*/
public static function uuidv7(): UuidInterface
{
if (! class_exists(Uuid::class)) {
throw new RuntimeException('The "ramsey/uuid" package is required to use the "uuidv7" method. Please run "composer require ramsey/uuid".');
}
return Uuid::uuid7();
}
/**
* Generate a time-ordered UUID.
*/
public static function orderedUuid(?DateTimeInterface $time = null): UuidInterface
{
if (! class_exists(Uuid::class)) {
throw new RuntimeException('The "ramsey/uuid" package is required to use the "orderedUuid" method. Please run "composer require ramsey/uuid".');
}
return Uuid::uuid7($time);
}
/**
* Get the smallest possible portion of a string between two given values.
*
* @param string $subject
* @param string $from
* @param string $to
* @return string
*/
public static function betweenFirst($subject, $from, $to)
{
if ($from === '' || $to === '') {
return $subject;
}
return Str::before(Str::after($subject, $from), $to);
}
/**
* @param string $value
*/
public static function classNamespace($value): string
{
if ($pos = strrpos($value, '\\')) {
return substr($value, 0, $pos);
}
return '';
}
/**
* Convert the case of a string.
*/
public static function convertCase(string $string, int $mode = MB_CASE_FOLD, ?string $encoding = 'UTF-8'): string
{
return mb_convert_case($string, $mode, $encoding);
}
/**
* Extracts an excerpt from text that matches the first instance of a phrase.
*
* @param string $text
* @param string $phrase
* @param array $options
* @return null|string
*/
public static function excerpt($text, $phrase = '', $options = [])
{
$radius = $options['radius'] ?? 100;
$omission = $options['omission'] ?? '...';
preg_match('/^(.*?)(' . preg_quote((string) $phrase) . ')(.*)$/iu', (string) $text, $matches);
if (empty($matches)) {
return null;
}
$startStr = ltrim($matches[1]);
$start = Str::of(mb_substr($matches[1], max(mb_strlen($startStr, 'UTF-8') - $radius, 0), $radius, 'UTF-8'))->ltrim();
$start = $start->unless(
(fn ($startWithRadius) => $startWithRadius->exactly($startStr))($start),
fn ($startWithRadius) => $startWithRadius->prepend($omission),
);
$endStr = rtrim($matches[3]);
$end = Str::of(mb_substr($endStr, 0, $radius, 'UTF-8'))->rtrim();
$end = $end->unless(
(fn ($endWithRadius) => $endWithRadius->exactly($endStr))($end),
fn ($endWithRadius) => $endWithRadius->append($omission),
);
return $start->append($matches[2], (string) $end)->__toString();
}
/**
* Determine if a given value is valid JSON.
*
* @param mixed $value
*/
public static function isJson($value): bool
{
if (! is_string($value)) {
return false;
}
if (function_exists('json_validate')) {
return json_validate($value, 512);
}
try {
json_decode($value, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
return false;
}
return true;
}
/**
* Make a string's first character lowercase.
*
* @param string $string
*/
public static function lcfirst($string): string
{
return Str::lower(Str::substr($string, 0, 1)) . Str::substr($string, 1);
}
/**
* Generate a random, secure password.
*
* @param int $length
* @param bool $letters
* @param bool $numbers
* @param bool $symbols
* @param bool $spaces
* @return string
*/
public static function password($length = 32, $letters = true, $numbers = true, $symbols = true, $spaces = false)
{
return (new Collection())
->when($letters, fn ($c) => $c->merge([
'a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k',
'l', 'm', 'n', 'o', 'p', 'q', 'r', 's', 't', 'u', 'v',
'w', 'x', 'y', 'z', 'A', 'B', 'C', 'D', 'E', 'F', 'G',
'H', 'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P', 'Q', 'R',
'S', 'T', 'U', 'V', 'W', 'X', 'Y', 'Z',
]))
->when($numbers, fn ($c) => $c->merge([
'0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
]))
->when($symbols, fn ($c) => $c->merge([
'~', '!', '#', '$', '%', '^', '&', '*', '(', ')', '-',
'_', '.', ',', '<', '>', '?', '/', '\\', '{', '}', '[',
']', '|', ':', ';',
]))
->when($spaces, fn ($c) => $c->merge([' ']))
->pipe(fn ($c) => Collection::times($length, fn () => $c[random_int(0, $c->count() - 1)]))
->implode('');
}
/**
* Replace the first occurrence of the given value if it appears at the start of the string.
*
* @param string $search
* @param string $replace
* @param string $subject
* @return string
*/
public static function replaceStart($search, $replace, $subject)
{
$search = (string) $search;
if ($search === '') {
return $subject;
}
if (static::startsWith($subject, $search)) {
return static::replaceFirst($search, $replace, $subject);
}
return $subject;
}
/**
* Replace the last occurrence of a given value if it appears at the end of the string.
*
* @param string $search
* @param string $replace
* @param string $subject
* @return string
*/
public static function replaceEnd($search, $replace, $subject)
{
$search = (string) $search;
if ($search === '') {
return $subject;
}
if (static::endsWith($subject, $search)) {
return static::replaceLast($search, $replace, $subject);
}
return $subject;
}
/**
* Replace the patterns matching the given regular expression.
*
* @param string $pattern
* @param Closure|string $replace
* @param array|string $subject
* @param int $limit
* @return null|string|string[]
*/
public static function replaceMatches($pattern, $replace, $subject, $limit = -1)
{
if ($replace instanceof Closure) {
return preg_replace_callback($pattern, $replace, $subject, $limit);
}
return preg_replace($pattern, $replace, $subject, $limit);
}
/**
* @param string $value
*/
public static function reverse($value): string
{
return implode(array_reverse(mb_str_split($value)));
}
/**
* Remove all whitespace from both ends of a string.
*
* @param string $value
* @param null|string $charlist
* @return string
*/
public static function trim($value, $charlist = null)
{
if ($charlist === null) {
$trimDefaultCharacters = " \n\r\t\v";
return preg_replace('~^[\s\x{FEFF}\x{200B}\x{200E}' . $trimDefaultCharacters . ']+|[\s\x{FEFF}\x{200B}\x{200E}' . $trimDefaultCharacters . ']+$~u', '', $value) ?? trim($value);
}
return trim($value, $charlist);
}
/**
* Remove all whitespace from the beginning of a string.
*
* @param string $value
* @param null|string $charlist
* @return string
*/
public static function ltrim($value, $charlist = null)
{
if ($charlist === null) {
$ltrimDefaultCharacters = " \n\r\t\v";
return preg_replace('~^[\s\x{FEFF}\x{200B}\x{200E}' . $ltrimDefaultCharacters . ']+~u', '', $value) ?? ltrim($value);
}
return ltrim($value, $charlist);
}
/**
* Remove all whitespace from the end of a string.
*
* @param string $value
* @param null|string $charlist
* @return string
*/
public static function rtrim($value, $charlist = null)
{
if ($charlist === null) {
$rtrimDefaultCharacters = " \n\r\t\v";
return preg_replace('~[\s\x{FEFF}\x{200B}\x{200E}' . $rtrimDefaultCharacters . ']+$~u', '', $value) ?? rtrim($value);
}
return rtrim($value, $charlist);
}
/**
* Remove all "extra" blank space from the given string.
*
* @param string $value
*/
public static function squish($value): null|array|string
{
return preg_replace('~(\s|\x{3164}|\x{1160})+~u', ' ', static::trim($value));
}
/**
* Replace text within a portion of a string.
*
* @param string|string[] $string
* @param string|string[] $replace
* @param int|int[] $offset
* @param null|int|int[] $length
* @return string|string[]
*/
public static function substrReplace($string, $replace, $offset = 0, $length = null): array|string
{
if ($length === null) {
$length = strlen($string);
}
return substr_replace($string, $replace, $offset, $length);
}
/**
* Swap multiple keywords in a string with other keywords.
*
* @param string $subject
* @return string
*/
public static function swap(array $map, $subject): array|string
{
return str_replace(array_keys($map), array_values($map), $subject);
}
/**
* Take the first or last {$limit} characters of a string.
*/
public static function take(string $string, int $limit): string
{
if ($limit < 0) {
return static::substr($string, $limit);
}
return static::substr($string, 0, $limit);
}
/**
* Convert the given string to Base64 encoding.
*
* @param string $string
*/
public static function toBase64($string): string
{
return base64_encode($string);
}
/**
* Split a string into pieces by uppercase characters.
*
* @param string $string
* @return bool|string[]
*/
public static function ucsplit($string): array|bool
{
return preg_split('/(?=\p{Lu})/u', $string, -1, PREG_SPLIT_NO_EMPTY);
}
/**
* Unwrap the string with the given strings.
*
* @param string $value
* @param string $before
* @param null|string $after
*/
public static function unwrap($value, $before, $after = null): string
{
if (static::startsWith($value, $before)) {
$value = static::substr($value, static::length($before));
}
if (static::endsWith($value, $after ??= $before)) {
$value = static::substr($value, 0, -static::length($after));
}
return $value;
}
/**
* Get the number of words a string contains.
*
* @param string $string
*/
public static function wordCount($string): array|int
{
return str_word_count($string);
}
/**
* Wrap the string with the given strings.
*
* @param string $value
* @param string $before
* @param null|string $after
*/
public static function wrap($value, $before, $after = null): string
{
return $before . $value . ($after ??= $before);
}
/**
* Wrap a string to a given number of characters.
*
* @param string $string
* @param int $characters
* @param string $break
* @param bool $cutLongWords
*/
public static function wordWrap($string, $characters = 75, $break = "\n", $cutLongWords = false): string
{
return wordwrap($string, $characters, $break, $cutLongWords);
}
/**
* Remove all non-numeric characters from a string.
*/
public static function numbers(array|string $value): array|string
{
return preg_replace('/[^0-9]/', '', $value);
}
/**
* Decode the given Base64 encoded string.
*/
public static function fromBase64(string $string, bool $strict = false): false|string
{
return base64_decode($string, $strict);
}
/**
* 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' => ['°', 'â‚€', 'Û°', 'ï¼'],
'1' => ['¹', 'â‚', 'Û±', '１'],
'2' => ['²', '₂', '۲', '２'],
'3' => ['³', '₃', '۳', '３'],
'4' => ['â´', 'â‚„', 'Û´', 'Ù¤', 'ï¼”'],
'5' => ['âµ', 'â‚…', 'Ûµ', 'Ù¥', '５'],
'6' => ['â¶', '₆', 'Û¶', 'Ù¦', 'ï¼–'],
'7' => ['â·', '₇', 'Û·', 'ï¼—'],
'8' => ['â¸', '₈', 'Û¸', '８'],
'9' => ['â¹', '₉', 'Û¹', 'ï¼™'],
'a' => [
'Ã ',
'á',
'ả',
'ã',
'ạ',
'ă',
'ắ',
'ằ',
'ẳ',
'ẵ',
'ặ',
'â',
'ấ',
'ầ',
'ẩ',
'ẫ',
'áº',
'Ä',
'Ä…',
'Ã¥',
'α',
'ά',
'á¼€',
'á¼',
'ἂ',
'ἃ',
'ἄ',
'á¼…',
'ἆ',
'ἇ',
'á¾€',
'á¾',
'ᾂ',
'ᾃ',
'ᾄ',
'á¾…',
'ᾆ',
'ᾇ',
'á½°',
'ά',
'á¾°',
'á¾±',
'á¾²',
'á¾³',
'á¾´',
'ᾶ',
'á¾·',
'а',
'Ø£',
'အ',
'ာ',
'ါ',
'Ç»',
'ÇŽ',
'ª',
'áƒ',
'अ',
'ا',
'ï½',
'ä',
],
'b' => ['б', 'β', 'ب', 'ဗ', 'ბ', 'ｂ'],
'c' => ['ç', 'ć', 'Ä', 'ĉ', 'Ä‹', 'ｃ'],
'd' => ['Ä', 'ð', 'Ä‘', 'ÆŒ', 'È¡', 'É–', 'É—', 'áµ', 'á¶', 'ᶑ', 'д', 'δ', 'د', 'ض', 'á€', 'ဒ', 'დ', 'ｄ'],
'e' => [
'é',
'è',
'ẻ',
'ẽ',
'ẹ',
'ê',
'ế',
'á»',
'ể',
'á»…',
'ệ',
'ë',
'Ä“',
'Ä™',
'Ä›',
'Ä•',
'Ä—',
'ε',
'Î',
'á¼',
'ἑ',
'á¼’',
'ἓ',
'á¼”',
'ἕ',
'á½²',
'Î',
'е',
'Ñ‘',
'Ñ',
'Ñ”',
'É™',
'ဧ',
'ေ',
'ဲ',
'ე',
'à¤',
'Ø¥',
'ئ',
'ï½…',
],
'f' => ['Ñ„', 'φ', 'Ù', 'Æ’', 'ფ', 'ｆ'],
'g' => ['Ä', 'ÄŸ', 'Ä¡', 'Ä£', 'г', 'Ò‘', 'γ', 'ဂ', 'გ', 'Ú¯', 'ｇ'],
'h' => ['Ä¥', 'ħ', 'η', 'ή', 'Ø', 'Ù‡', 'ဟ', 'ှ', 'ჰ', 'ｈ'],
'i' => [
'Ã',
'ì',
'ỉ',
'Ä©',
'ị',
'î',
'ï',
'Ä«',
'Ä',
'į',
'ı',
'ι',
'ί',
'ÏŠ',
'Î',
'á¼°',
'á¼±',
'á¼²',
'á¼³',
'á¼´',
'á¼µ',
'ἶ',
'á¼·',
'ὶ',
'ί',
'á¿',
'á¿‘',
'á¿’',
'Î',
'á¿–',
'á¿—',
'Ñ–',
'Ñ—',
'и',
'ဣ',
'á€',
'ီ',
'ည်',
'Ç',
'ი',
'इ',
'ی',
'ｉ',
],
'j' => ['ĵ', 'ј', 'Ј', 'ჯ', 'ج', 'ｊ'],
'k' => ['ķ', 'ĸ', 'к', 'κ', 'Ķ', 'ق', 'ك', 'က', 'კ', 'ქ', 'ک', 'ｋ'],
'l' => ['ł', 'ľ', 'ĺ', 'ļ', 'ŀ', 'л', 'λ', 'ل', 'လ', 'ლ', 'ｌ'],
'm' => ['м', 'μ', 'Ù…', 'မ', 'მ', 'ï½'],
'n' => ['ñ', 'ń', 'ň', 'ņ', 'ʼn', 'ŋ', 'ν', 'н', 'ن', 'န', 'ნ', 'ｎ'],
'o' => [
'ó',
'ò',
'á»',
'õ',
'á»',
'ô',
'ố',
'ồ',
'ổ',
'á»—',
'á»™',
'Æ¡',
'á»›',
'á»',
'ở',
'ỡ',
'ợ',
'ø',
'Å',
'Å‘',
'Å',
'ο',
'á½€',
'á½',
'ὂ',
'ὃ',
'ὄ',
'á½…',
'ὸ',
'ό',
'о',
'Ùˆ',
'θ',
'á€á€¯',
'Ç’',
'Ç¿',
'º',
'áƒ',
'ओ',
'ï½',
'ö',
],
'p' => ['п', 'Ï€', 'ပ', 'პ', 'Ù¾', 'ï½'],
'q' => ['ყ', 'ｑ'],
'r' => ['Å•', 'Å™', 'Å—', 'Ñ€', 'Ï', 'ر', 'რ', 'ï½’'],
's' => ['Å›', 'Å¡', 'ÅŸ', 'Ñ', 'σ', 'È™', 'Ï‚', 'س', 'ص', 'စ', 'Å¿', 'ს', 'ｓ'],
't' => ['Å¥', 'Å£', 'Ñ‚', 'Ï„', 'È›', 'ت', 'Ø·', 'ဋ', 'á€', 'ŧ', 'თ', 'ტ', 'ï½”'],
'u' => [
'ú',
'ù',
'ủ',
'Å©',
'ụ',
'Æ°',
'ứ',
'ừ',
'á»',
'ữ',
'á»±',
'û',
'Å«',
'ů',
'ű',
'Å',
'ų',
'µ',
'у',
'ဉ',
'ု',
'ူ',
'Ç”',
'Ç–',
'ǘ',
'Çš',
'ǜ',
'უ',
'उ',
'ｕ',
'Ñž',
'ü',
],
'v' => ['в', 'ვ', 'Ï', 'ï½–'],
'w' => ['ŵ', 'ω', 'ÏŽ', 'á€', 'ွ', 'ï½—'],
'x' => ['χ', 'ξ', 'ｘ'],
'y' => ['ý', 'ỳ', 'á»·', 'ỹ', 'ỵ', 'ÿ', 'Å·', 'й', 'Ñ‹', 'Ï…', 'Ï‹', 'Ï', 'ΰ', 'ÙŠ', 'ယ', 'ï½™'],
'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' => [
'Ã',
'À',
'Ả',
'Ã',
'Ạ',
'Ä‚',
'Ắ',
'Ằ',
'Ẳ',
'Ẵ',
'Ặ',
'Â',
'Ấ',
'Ầ',
'Ẩ',
'Ẫ',
'Ậ',
'Ã…',
'Ä€',
'Ä„',
'Α',
'Ά',
'Ἀ',
'Ἁ',
'Ἂ',
'Ἃ',
'Ἄ',
'á¼',
'Ἆ',
'á¼',
'ᾈ',
'ᾉ',
'ᾊ',
'ᾋ',
'ᾌ',
'á¾',
'ᾎ',
'á¾',
'Ᾰ',
'á¾¹',
'Ὰ',
'Ά',
'á¾¼',
'Ð',
'Ǻ',
'Ç',
'Ａ',
'Ä',
],
'B' => ['Б', 'Β', 'ब', 'Ｂ'],
'C' => ['Ç', 'Ć', 'Č', 'Ĉ', 'Ċ', 'Ｃ'],
'D' => ['ÄŽ', 'Ã', 'Ä', 'Ɖ', 'ÆŠ', 'Æ‹', 'á´…', 'á´†', 'Д', 'Δ', 'Ｄ'],
'E' => [
'É',
'È',
'Ẻ',
'Ẽ',
'Ẹ',
'Ê',
'Ế',
'Ề',
'Ể',
'Ễ',
'Ệ',
'Ë',
'Ä’',
'Ę',
'Äš',
'Ä”',
'Ä–',
'Ε',
'Έ',
'Ἐ',
'á¼™',
'Ἒ',
'á¼›',
'Ἔ',
'á¼',
'Έ',
'Ὲ',
'Е',
'Ð',
'Ð',
'Є',
'Æ',
'ï¼¥',
],
'F' => ['Ф', 'Φ', 'Ｆ'],
'G' => ['Äž', 'Ä ', 'Ä¢', 'Г', 'Ò', 'Γ', 'Ｇ'],
'H' => ['Η', 'Ή', 'Ħ', 'Ｈ'],
'I' => [
'Ã',
'Ì',
'Ỉ',
'Ĩ',
'Ị',
'ÃŽ',
'Ã',
'Ī',
'Ĭ',
'Ä®',
'Ä°',
'Ι',
'Ί',
'Ϊ',
'Ἰ',
'á¼¹',
'á¼»',
'á¼¼',
'á¼½',
'á¼¾',
'Ἷ',
'Ῐ',
'á¿™',
'á¿š',
'Ί',
'И',
'І',
'Ї',
'Ç',
'Ï’',
'Ｉ',
],
'J' => ['Ｊ'],
'K' => ['К', 'Κ', 'Ｋ'],
'L' => ['Ĺ', 'Å', 'Л', 'Λ', 'Ä»', 'Ľ', 'Ä¿', 'ल', 'Ｌ'],
'M' => ['Ðœ', 'Îœ', 'ï¼'],
'N' => ['Ń', 'Ñ', 'Ň', 'Å…', 'ÅŠ', 'Ð', 'Î', 'ï¼®'],
'O' => [
'Ó',
'Ã’',
'Ỏ',
'Õ',
'Ọ',
'Ô',
'á»',
'á»’',
'á»”',
'á»–',
'Ộ',
'Æ ',
'Ớ',
'Ờ',
'Ở',
'á» ',
'Ợ',
'Ø',
'Ō',
'Å',
'ÅŽ',
'Ο',
'Ό',
'Ὀ',
'Ὁ',
'Ὂ',
'Ὃ',
'Ὄ',
'á½',
'Ὸ',
'Ό',
'О',
'Θ',
'Ó¨',
'Ç‘',
'Ǿ',
'Ｏ',
'Ö',
],
'P' => ['П', 'Π', 'Ｐ'],
'Q' => ['ï¼±'],
'R' => ['Ř', 'Ŕ', 'Р', 'Ρ', 'Ŗ', 'Ｒ'],
'S' => ['Ş', 'Ŝ', 'Ș', 'Š', 'Ś', 'С', 'Σ', 'Ｓ'],
'T' => ['Ť', 'Ţ', 'Ŧ', 'Ț', 'Т', 'Τ', 'Ｔ'],
'U' => [
'Ú',
'Ù',
'Ủ',
'Ũ',
'Ụ',
'Ư',
'Ứ',
'Ừ',
'Ử',
'á»®',
'á»°',
'Û',
'Ū',
'Å®',
'Å°',
'Ŭ',
'Ų',
'У',
'Ç“',
'Ç•',
'Ç—',
'Ç™',
'Ç›',
'ï¼µ',
'ÐŽ',
'Ü',
],
'V' => ['В', 'Ｖ'],
'W' => ['Ω', 'Î', 'Å´', 'ï¼·'],
'X' => ['Χ', 'Ξ', 'Ｘ'],
'Y' => ['Ã', 'Ỳ', 'Ỷ', 'Ỹ', 'á»´', 'Ÿ', 'Ῠ', 'á¿©', 'Ὺ', 'ÎŽ', 'Ы', 'Й', 'Î¥', 'Ϋ', 'Ŷ', 'ï¼¹'],
'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;
}
}