字符串

简介
可用方法

简介

Laravel 包含了多种用于操作字符串值的函数。其中许多函数被框架本身使用；不过，如果你觉得方便，也可以在自有应用程序中随意使用它们。

可用方法

字符串

__class_basename e preg_replace_array Str::after Str::afterLast Str::apa Str::ascii Str::before Str::beforeLast Str::between Str::betweenFirst Str::camel Str::charAt Str::chopStart Str::chopEnd Str::contains Str::containsAll Str::doesntContain Str::doesntEndWith Str::doesntStartWith Str::deduplicate Str::endsWith Str::excerpt Str::finish Str::fromBase64 Str::headline Str::initials Str::inlineMarkdown Str::is Str::isAscii Str::isJson Str::isUlid Str::isUrl Str::isUuid Str::kebab Str::lcfirst Str::length Str::limit Str::lower Str::markdown Str::mask Str::match Str::matchAll Str::isMatch Str::orderedUuid Str::padBoth Str::padLeft Str::padRight Str::password Str::plural Str::pluralStudly Str::position Str::random Str::remove Str::repeat Str::replace Str::replaceArray Str::replaceFirst Str::replaceLast Str::replaceMatches Str::replaceStart Str::replaceEnd Str::reverse Str::singular Str::slug Str::snake Str::squish Str::start Str::startsWith Str::studly Str::substr Str::substrCount Str::substrReplace Str::swap Str::take Str::title Str::toBase64 Str::transliterate Str::trim Str::ltrim Str::rtrim Str::ucfirst Str::ucsplit Str::ucwords Str::upper Str::ulid Str::unwrap Str::uuid Str::uuid7 Str::wordCount Str::wordWrap Str::words Str::wrap str trans trans_choice

流畅的字符串

after afterLast apa append ascii basename before beforeLast between betweenFirst camel charAt classBasename chopStart chopEnd contains containsAll decrypt deduplicate dirname doesntContain doesntEndWith doesntStartWith encrypt endsWith exactly excerpt explode finish fromBase64 hash headline initials inlineMarkdown is isAscii isEmpty isNotEmpty isJson isUlid isUrl isUuid kebab lcfirst length limit lower markdown mask match matchAll isMatch newLine padBoth padLeft padRight pipe plural position prepend remove repeat replace replaceArray replaceFirst replaceLast replaceMatches replaceStart replaceEnd scan singular slug snake split squish start startsWith stripTags studly substr substrReplace swap take tap test title toBase64 toHtmlString toUri transliterate trim ltrim rtrim ucfirst ucsplit ucwords unwrap upper when whenContains whenContainsAll whenDoesntEndWith whenDoesntStartWith whenEmpty whenNotEmpty whenStartsWith whenEndsWith whenExactly whenNotExactly whenIs whenIsAscii whenIsUlid whenIsUuid whenTest wordCount words wrap

字符串

`__()`

__ 函数使用你的语言文件翻译给定的翻译字符串或翻译键：

php

echo __('欢迎使用我们的应用程序');

echo __('messages.welcome');

如果指定的翻译字符串或键不存在，__ 函数将返回给定的值。因此，使用上面的示例，如果该翻译键不存在，__ 函数将返回 messages.welcome。

`class_basename()`

class_basename 函数返回给定类的类名，并移除类的命名空间：

php

$class = class_basename('Foo\Bar\Baz');

// Baz

`e()`

e 函数运行 PHP 的 htmlspecialchars 函数，默认将 double_encode 选项设置为 true：

php

echo e('<html>foo</html>');

// &lt;html&gt;foo&lt;/html&gt;

`preg_replace_array()`

preg_replace_array 函数使用数组顺序替换字符串中给定的模式：

php

$string = '活动将在 :start 和 :end 之间举行';

$replaced = preg_replace_array('/:[a-z_]+/', ['8:30', '9:00'], $string);

// 活动将在 8:30 和 9:00 之间举行

`Str::after()`

Str::after 方法返回字符串中给定值之后的所有内容。如果该值不存在于字符串中，则返回整个字符串：

php

use Illuminate\Support\Str;

$slice = Str::after('这是我的名字', '这是');

// ' 我的名字'

`Str::afterLast()`

Str::afterLast 方法返回字符串中最后一次出现给定值之后的所有内容。如果该值不存在于字符串中，则返回整个字符串：

php

use Illuminate\Support\Str;

$slice = Str::afterLast('App\Http\Controllers\Controller', '\\');

// 'Controller'

`Str::apa()`

Str::apa 方法根据 APA 指南将给定的字符串转换为标题大小写：

php

use Illuminate\Support\Str;

$title = Str::apa('Creating A Project');

// 'Creating a Project'

`Str::ascii()`

Str::ascii 方法将尝试将字符串音译为 ASCII 值：

php

use Illuminate\Support\Str;

$slice = Str::ascii('û');

// 'u'

`Str::before()`

Str::before 方法返回字符串中给定值之前的所有内容：

php

use Illuminate\Support\Str;

$slice = Str::before('这是我的名字', '我的名字');

// '这是 '

`Str::beforeLast()`

Str::beforeLast 方法返回字符串中最后一次出现给定值之前的所有内容：

php

use Illuminate\Support\Str;

$slice = Str::beforeLast('这是我的名字', '是');

// '这'

`Str::between()`

Str::between 方法返回字符串中两个值之间的部分：

php

use Illuminate\Support\Str;

$slice = Str::between('这是我的名字', '这', '名字');

// '是我的 '

`Str::betweenFirst()`

Str::betweenFirst 方法返回字符串中两个值之间可能的最小部分：

php

use Illuminate\Support\Str;

$slice = Str::betweenFirst('[a] bc [d]', '[', ']');

// 'a'

`Str::camel()`

Str::camel 方法将给定的字符串转换为 驼峰式：

php

use Illuminate\Support\Str;

$converted = Str::camel('foo_bar');

// 'fooBar'

`Str::charAt()`

Str::charAt 方法返回指定索引处的字符。如果索引超出范围，则返回 false：

php

use Illuminate\Support\Str;

$character = Str::charAt('这是我的名字。', 6);

// '名'

`Str::chopStart()`

Str::chopStart 方法仅在给定值出现在字符串开头时移除该值的第一次出现：

php

use Illuminate\Support\Str;

$url = Str::chopStart('https://laravel.com', 'https://');

// 'laravel.com'

你也可以传递一个数组作为第二个参数。如果字符串以数组中的任何一个值开头，则该值将从字符串中移除：

php

use Illuminate\Support\Str;

$url = Str::chopStart('http://laravel.com', ['https://', 'http://']);

// 'laravel.com'

`Str::chopEnd()`

Str::chopEnd 方法仅在给定值出现在字符串末尾时移除该值的最后一次出现：

php

use Illuminate\Support\Str;

$url = Str::chopEnd('app/Models/Photograph.php', '.php');

// 'app/Models/Photograph'

你也可以传递一个数组作为第二个参数。如果字符串以数组中的任何一个值结尾，则该值将从字符串中移除：

php

use Illuminate\Support\Str;

$url = Str::chopEnd('laravel.com/index.php', ['/index.html', '/index.php']);

// 'laravel.com'

`Str::contains()`

Str::contains 方法确定给定的字符串是否包含给定的值。默认情况下，此方法区分大小写：

php

use Illuminate\Support\Str;

$contains = Str::contains('这是我的名字', '我的');

// true

你也可以传递一个值数组，以确定给定的字符串是否包含数组中的任何值：

php

use Illuminate\Support\Str;

$contains = Str::contains('这是我的名字', ['我的', 'foo']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$contains = Str::contains('这是我的名字', 'MY', ignoreCase: true);

// true

`Str::containsAll()`

Str::containsAll 方法确定给定的字符串是否包含给定数组中的所有值：

php

use Illuminate\Support\Str;

$containsAll = Str::containsAll('这是我的名字', ['我的', '名字']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$containsAll = Str::containsAll('这是我的名字', ['MY', 'NAME'], ignoreCase: true);

// true

`Str::doesntContain()`

Str::doesntContain 方法确定给定的字符串是否不包含给定的值。默认情况下，此方法区分大小写：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('这是名字', '我的');

// true

你也可以传递一个值数组，以确定给定的字符串是否不包含数组中的任何值：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('这是名字', ['我的', '框架']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('这是名字', 'MY', ignoreCase: true);

// true

`Str::deduplicate()`

Str::deduplicate 方法将字符串中连续出现的某个字符替换为该字符的单个实例。默认情况下，该方法对空格进行去重：

php

use Illuminate\Support\Str;

$result = Str::deduplicate('The   Laravel   Framework');

// The Laravel Framework

你可以通过将不同的字符作为第二个参数传递给该方法来指定要去重的字符：

php

use Illuminate\Support\Str;

$result = Str::deduplicate('The---Laravel---Framework', '-');

// The-Laravel-Framework

`Str::doesntEndWith()`

Str::doesntEndWith 方法确定给定的字符串是否不以给定的值结尾：

php

use Illuminate\Support\Str;

$result = Str::doesntEndWith('这是我的名字', '狗');

// true

你也可以传递一个值数组，以确定给定的字符串是否不以数组中的任何值结尾：

php

use Illuminate\Support\Str;

$result = Str::doesntEndWith('这是我的名字', ['this', 'foo']);

// true

$result = Str::doesntEndWith('这是我的名字', ['名字', 'foo']);

// false

`Str::doesntStartWith()`

Str::doesntStartWith 方法确定给定的字符串是否不以给定的值开头：

php

use Illuminate\Support\Str;

$result = Str::doesntStartWith('这是我的名字', '那');

// true

如果传递了一个可能值的数组，那么如果字符串不以任何给定值开头，doesntStartWith 方法将返回 true：

php

$result = Str::doesntStartWith('这是我的名字', ['什么', '那', '那里']);

// true

`Str::endsWith()`

Str::endsWith 方法确定给定的字符串是否以给定的值结尾：

php

use Illuminate\Support\Str;

$result = Str::endsWith('这是我的名字', '名字');

// true

你也可以传递一个值数组，以确定给定的字符串是否以数组中的任何值结尾：

php

use Illuminate\Support\Str;

$result = Str::endsWith('这是我的名字', ['名字', 'foo']);

// true

$result = Str::endsWith('这是我的名字', ['this', 'foo']);

// false

`Str::excerpt()`

Str::excerpt 方法从给定的字符串中提取与其中某个短语的首次实例相匹配的摘录：

php

use Illuminate\Support\Str;

$excerpt = Str::excerpt('这是我的名字', '我的', [
    'radius' => 3
]);

// '...是我的名字...' // 注：根据原文示例调整，中文可能有不同，但保留原文逻辑

radius 选项默认为 100，允许你定义截断字符串两侧应出现的字符数。

此外，你可以使用 omission 选项来定义将前置和附加到截断字符串的字符串：

php

use Illuminate\Support\Str;

$excerpt = Str::excerpt('这是我的名字', '名字', [
    'radius' => 3,
    'omission' => '(...) '
]);

// '(...) 我的名字'

`Str::finish()`

Str::finish 方法在字符串末尾添加给定值的单个实例（如果该字符串尚未以该值结尾）：

php

use Illuminate\Support\Str;

$adjusted = Str::finish('this/string', '/');

// this/string/

$adjusted = Str::finish('this/string/', '/');

// this/string/

`Str::fromBase64()`

Str::fromBase64 方法解码给定的 Base64 字符串：

php

use Illuminate\Support\Str;

$decoded = Str::fromBase64('TGFyYXZlbA==');

// Laravel

`Str::headline()`

Str::headline 方法会将使用大小写、连字符或下划线分隔的字符串转换为以空格分隔的字符串，且每个单词的首字母大写：

php

use Illuminate\Support\Str;

$headline = Str::headline('steve_jobs');

// Steve Jobs

$headline = Str::headline('EmailNotificationSent');

// Email Notification Sent

`Str::initials()`

Str::initials 方法将返回给定字符串的首字母，可选择将其大写：

php

use Illuminate\Support\Str;

$initials = Str::initials('taylor otwell');

// to

$initials = Str::initials('taylor otwell', capitalize: true);

// TO

`Str::inlineMarkdown()`

Str::inlineMarkdown 方法使用 CommonMark 将 GitHub 风格的 Markdown 转换为内联 HTML。但是，与 markdown 方法不同，它不会将所有生成的 HTML 包装在块级元素中：

php

use Illuminate\Support\Str;

$html = Str::inlineMarkdown('**Laravel**');

// <strong>Laravel</strong>

Markdown 安全性

默认情况下，Markdown 支持原始 HTML，当与原始用户输入一起使用时，这将暴露跨站脚本（XSS）漏洞。根据 CommonMark 安全文档，你可以使用 html_input 选项来转义或剥离原始 HTML，并使用 allow_unsafe_links 选项来指定是否允许不安全的链接。如果你需要允许一些原始 HTML，应该将编译后的 Markdown 传递给 HTML 净化器：

php

use Illuminate\Support\Str;

Str::inlineMarkdown('注入: <script>alert("Hello XSS!");</script>', [
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);

// 注入: alert(&quot;Hello XSS!&quot;);

`Str::is()`

Str::is 方法确定给定的字符串是否与给定的模式匹配。星号可用作通配符值：

php

use Illuminate\Support\Str;

$matches = Str::is('foo*', 'foobar');

// true

$matches = Str::is('baz*', 'foobar');

// false

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$matches = Str::is('*.jpg', 'photo.JPG', ignoreCase: true);

// true

`Str::isAscii()`

Str::isAscii 方法确定给定的字符串是否为 7 位 ASCII 码：

php

use Illuminate\Support\Str;

$isAscii = Str::isAscii('Taylor');

// true

$isAscii = Str::isAscii('ü');

// false

`Str::isJson()`

Str::isJson 方法确定给定的字符串是否为有效的 JSON：

php

use Illuminate\Support\Str;

$result = Str::isJson('[1,2,3]');

// true

$result = Str::isJson('{"first": "John", "last": "Doe"}');

// true

$result = Str::isJson('{first: "John", last: "Doe"}');

// false

`Str::isUrl()`

Str::isUrl 方法确定给定的字符串是否为有效的 URL：

php

use Illuminate\Support\Str;

$isUrl = Str::isUrl('http://example.com');

// true

$isUrl = Str::isUrl('laravel');

// false

isUrl 方法将多种协议视为有效。但是，你可以通过将它们提供给 isUrl 方法来指定应视为有效的协议：

php

$isUrl = Str::isUrl('http://example.com', ['http', 'https']);

`Str::isUlid()`

Str::isUlid 方法确定给定的字符串是否为有效的 ULID：

php

use Illuminate\Support\Str;

$isUlid = Str::isUlid('01gd6r360bp37zj17nxb55yv40');

// true

$isUlid = Str::isUlid('laravel');

// false

`Str::isUuid()`

Str::isUuid 方法确定给定的字符串是否为有效的 UUID：

php

use Illuminate\Support\Str;

$isUuid = Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de');

// true

$isUuid = Str::isUuid('laravel');

// false

你还可以验证给定的 UUID 是否匹配特定版本（1、3、4、5、6、7 或 8）的 UUID 规范：

php

use Illuminate\Support\Str;

$isUuid = Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de', version: 4);

// true

$isUuid = Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de', version: 1);

// false

`Str::kebab()`

Str::kebab 方法将给定的字符串转换为 短横线命名：

php

use Illuminate\Support\Str;

$converted = Str::kebab('fooBar');

// foo-bar

`Str::lcfirst()`

Str::lcfirst 方法返回给定的字符串，并将首字母转换为小写：

php

use Illuminate\Support\Str;

$string = Str::lcfirst('Foo Bar');

// foo Bar

`Str::length()`

Str::length 方法返回给定字符串的长度：

php

use Illuminate\Support\Str;

$length = Str::length('Laravel');

// 7

`Str::limit()`

Str::limit 方法将给定的字符串截断为指定的长度：

php

use Illuminate\Support\Str;

$truncated = Str::limit('敏捷的棕色狐狸跃过懒狗', 20);

// 敏捷的棕色狐狸跃过...

你可以向该方法传递第三个参数来更改将附加到截断字符串末尾的字符串：

php

$truncated = Str::limit('敏捷的棕色狐狸跃过懒狗', 20, ' (...)');

// 敏捷的棕色狐狸跃过 (...)

如果希望在截断字符串时保留完整的单词，可以利用 preserveWords 参数。当此参数为 true 时，字符串将截断到最近的完整单词边界：

php

$truncated = Str::limit('敏捷的棕色狐狸', 12, preserveWords: true);

// 敏捷的棕色...

`Str::lower()`

Str::lower 方法将给定的字符串转换为小写：

php

use Illuminate\Support\Str;

$converted = Str::lower('LARAVEL');

// laravel

`Str::markdown()`

Str::markdown 方法使用 CommonMark 将 GitHub 风格的 Markdown 转换为 HTML：

php

use Illuminate\Support\Str;

$html = Str::markdown('# Laravel');

// <h1>Laravel</h1>

$html = Str::markdown('# Taylor <b>Otwell</b>', [
    'html_input' => 'strip',
]);

// <h1>Taylor Otwell</h1>

Markdown 安全性

php

use Illuminate\Support\Str;

Str::markdown('注入: <script>alert("Hello XSS!");</script>', [
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);

// <p>注入: alert(&quot;Hello XSS!&quot;);</p>

`Str::mask()`

Str::mask 方法用重复字符遮蔽字符串的一部分，可用于混淆字符串的片段，如电子邮件地址和电话号码：

php

use Illuminate\Support\Str;

$string = Str::mask('taylor@example.com', '*', 3);

// tay***************

如果需要，你可以向 mask 方法提供负数作为第三个或第四个参数，这将指示该方法从距离字符串末尾的给定位置开始遮蔽：

php

$string = Str::mask('taylor@example.com', '*', -15, 3);

// tay***@example.com

$string = Str::mask('taylor@example.com', '*', 4, -4);

// tayl**********.com

`Str::match()`

Str::match 方法将返回与给定正则表达式模式匹配的字符串部分：

php

use Illuminate\Support\Str;

$result = Str::match('/bar/', 'foo bar');

// 'bar'

$result = Str::match('/foo (.*)/', 'foo bar');

// 'bar'

`Str::matchAll()`

Str::matchAll 方法将返回一个集合，其中包含与给定正则表达式模式匹配的字符串部分：

php

use Illuminate\Support\Str;

$result = Str::matchAll('/bar/', 'bar foo bar');

// collect(['bar', 'bar'])

如果你在表达式中指定了一个匹配组，Laravel 将返回第一个匹配组的匹配项集合：

php

use Illuminate\Support\Str;

$result = Str::matchAll('/f(\w*)/', 'bar fun bar fly');

// collect(['un', 'ly']);

如果未找到匹配项，将返回一个空集合。

`Str::isMatch()`

Str::isMatch 方法如果字符串匹配给定的正则表达式，将返回 true：

php

use Illuminate\Support\Str;

$result = Str::isMatch('/foo (.*)/', 'foo bar');

// true

$result = Str::isMatch('/foo (.*)/', 'laravel');

// false

`Str::orderedUuid()`

Str::orderedUuid 方法生成一个“时间戳优先”的 UUID，可以有效地存储在索引数据库列中。使用此方法生成的每个 UUID 都将排在先前使用该方法生成的 UUID 之后：

php

use Illuminate\Support\Str;

return (string) Str::orderedUuid();

`Str::padBoth()`

Str::padBoth 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的两侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::padBoth('James', 10, '_');

// '__James___'

$padded = Str::padBoth('James', 10);

// '  James   '

`Str::padLeft()`

Str::padLeft 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的左侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::padLeft('James', 10, '-=');

// '-=-=-James'

$padded = Str::padLeft('James', 10);

// '     James'

`Str::padRight()`

Str::padRight 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的右侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::padRight('James', 10, '-');

// 'James-----'

$padded = Str::padRight('James', 10);

// 'James     '

`Str::password()`

Str::password 方法可用于生成给定长度的安全、随机密码。密码将由字母、数字、符号和空格的组合构成。默认情况下，密码长度为 32 个字符：

php

use Illuminate\Support\Str;

$password = Str::password();

// 'EbJo2vE-AS:U,$%_gkrV4n,q~1xy/-_4'

$password = Str::password(12);

// 'qwuar>#V|i]N'

`Str::plural()`

Str::plural 方法将单数词字符串转换为其复数形式。此函数支持 Laravel 复数化器支持的任何语言：

php

use Illuminate\Support\Str;

$plural = Str::plural('car');

// cars

$plural = Str::plural('child');

// children

你可以向函数提供一个整数作为第二个参数，以获取字符串的单数或复数形式：

php

use Illuminate\Support\Str;

$plural = Str::plural('child', 2);

// children

$singular = Str::plural('child', 1);

// child

可以提供 prependCount 参数以在复数化字符串前加上格式化的 $count：

php

use Illuminate\Support\Str;

$label = Str::plural('car', 1000, prependCount: true);

// 1,000 cars

`Str::pluralStudly()`

Str::pluralStudly 方法将以驼峰式大小写格式化的单数词字符串转换为其复数形式。此函数支持 Laravel 复数化器支持的任何语言：

php

use Illuminate\Support\Str;

$plural = Str::pluralStudly('VerifiedHuman');

// VerifiedHumans

$plural = Str::pluralStudly('UserFeedback');

// UserFeedback

你可以向函数提供一个整数作为第二个参数，以获取字符串的单数或复数形式：

php

use Illuminate\Support\Str;

$plural = Str::pluralStudly('VerifiedHuman', 2);

// VerifiedHumans

$singular = Str::pluralStudly('VerifiedHuman', 1);

// VerifiedHuman

`Str::position()`

Str::position 方法返回子字符串在字符串中首次出现的位置。如果子字符串在给定的字符串中不存在，则返回 false：

php

use Illuminate\Support\Str;

$position = Str::position('Hello, World!', 'Hello');

// 0

$position = Str::position('Hello, World!', 'W');

// 7

`Str::random()`

Str::random 方法生成一个指定长度的随机字符串。此函数使用 PHP 的 random_bytes 函数：

php

use Illuminate\Support\Str;

$random = Str::random(40);

在测试期间，“伪造” Str::random 方法返回的值可能很有用。为此，你可以使用 createRandomStringsUsing 方法：

php

Str::createRandomStringsUsing(function () {
    return 'fake-random-string';
});

要指示 random 方法恢复正常生成随机字符串，你可以调用 createRandomStringsNormally 方法：

php

Str::createRandomStringsNormally();

`Str::remove()`

Str::remove 方法从字符串中移除给定的值或值数组：

php

use Illuminate\Support\Str;

$string = 'Peter Piper picked a peck of pickled peppers.';

$removed = Str::remove('e', $string);

// Ptr Pipr pickd a pck of pickld ppprs.

你还可以向 remove 方法传递 false 作为第三个参数，以在移除字符串时忽略大小写。

`Str::repeat()`

Str::repeat 方法重复给定的字符串：

php

use Illuminate\Support\Str;

$string = 'a';

$repeat = Str::repeat($string, 5);

// aaaaa

`Str::replace()`

Str::replace 方法替换字符串中的给定字符串：

php

use Illuminate\Support\Str;

$string = 'Laravel 11.x';

$replaced = Str::replace('11.x', '12.x', $string);

// Laravel 12.x

replace 方法还接受一个 caseSensitive 参数。默认情况下，replace 方法区分大小写：

php

$replaced = Str::replace(
    'php',
    'Laravel',
    'PHP Framework for Web Artisans',
    caseSensitive: false
);

// Laravel Framework for Web Artisans

`Str::replaceArray()`

Str::replaceArray 方法使用数组顺序替换字符串中的给定值：

php

use Illuminate\Support\Str;

$string = '活动将在 ? 和 ? 之间举行';

$replaced = Str::replaceArray('?', ['8:30', '9:00'], $string);

// 活动将在 8:30 和 9:00 之间举行

`Str::replaceFirst()`

Str::replaceFirst 方法替换字符串中第一次出现的给定值：

php

use Illuminate\Support\Str;

$replaced = Str::replaceFirst('the', 'a', 'the quick brown fox jumps over the lazy dog');

// a quick brown fox jumps over the lazy dog

`Str::replaceLast()`

Str::replaceLast 方法替换字符串中最后一次出现的给定值：

php

use Illuminate\Support\Str;

$replaced = Str::replaceLast('the', 'a', 'the quick brown fox jumps over the lazy dog');

// the quick brown fox jumps over a lazy dog

`Str::replaceMatches()`

Str::replaceMatches 方法用给定的替换字符串替换字符串中与模式匹配的所有部分：

php

use Illuminate\Support\Str;

$replaced = Str::replaceMatches(
    pattern: '/[^A-Za-z0-9]++/',
    replace: '',
    subject: '(+1) 501-555-1000'
);

// '15015551000'

replaceMatches 方法还接受一个闭包，该闭包将为字符串中与给定模式匹配的每个部分调用，允许你在闭包内执行替换逻辑并返回替换后的值：

php

use Illuminate\Support\Str;

$replaced = Str::replaceMatches('/\d/', function (array $matches) {
    return '['.$matches[0].']';
}, '123');

// '[1][2][3]'

`Str::replaceStart()`

Str::replaceStart 方法仅在给定值出现在字符串开头时替换该值的第一次出现：

php

use Illuminate\Support\Str;

$replaced = Str::replaceStart('Hello', 'Laravel', 'Hello World');

// Laravel World

$replaced = Str::replaceStart('World', 'Laravel', 'Hello World');

// Hello World

`Str::replaceEnd()`

Str::replaceEnd 方法仅在给定值出现在字符串末尾时替换该值的最后一次出现：

php

use Illuminate\Support\Str;

$replaced = Str::replaceEnd('World', 'Laravel', 'Hello World');

// Hello Laravel

$replaced = Str::replaceEnd('Hello', 'Laravel', 'Hello World');

// Hello World

`Str::reverse()`

Str::reverse 方法反转给定的字符串：

php

use Illuminate\Support\Str;

$reversed = Str::reverse('Hello World');

// dlroW olleH

`Str::singular()`

Str::singular 方法将字符串转换为其单数形式。此函数支持 Laravel 复数化器支持的任何语言：

php

use Illuminate\Support\Str;

$singular = Str::singular('cars');

// car

$singular = Str::singular('children');

// child

`Str::slug()`

Str::slug 方法从给定的字符串生成一个 URL 友好的“slug”：

php

use Illuminate\Support\Str;

$slug = Str::slug('Laravel 5 Framework', '-');

// laravel-5-framework

`Str::snake()`

Str::snake 方法将给定的字符串转换为 蛇形命名：

php

use Illuminate\Support\Str;

$converted = Str::snake('fooBar');

// foo_bar

$converted = Str::snake('fooBar', '-');

// foo-bar

`Str::squish()`

Str::squish 方法从字符串中删除所有多余的空格，包括单词之间的多余空格：

php

use Illuminate\Support\Str;

$string = Str::squish('    laravel    framework    ');

// laravel framework

`Str::start()`

Str::start 方法在字符串开头添加给定值的单个实例（如果该字符串尚未以该值开头）：

php

use Illuminate\Support\Str;

$adjusted = Str::start('this/string', '/');

// /this/string

$adjusted = Str::start('/this/string', '/');

// /this/string

`Str::startsWith()`

Str::startsWith 方法确定给定的字符串是否以给定的值开头：

php

use Illuminate\Support\Str;

$result = Str::startsWith('这是我的名字', '这');

// true

如果传递了一个可能值的数组，那么如果字符串以任何给定的值开头，startsWith 方法将返回 true：

php

$result = Str::startsWith('这是我的名字', ['这', '那', '那里']);

// true

`Str::studly()`

Str::studly 方法将给定的字符串转换为 大驼峰式：

php

use Illuminate\Support\Str;

$converted = Str::studly('foo_bar');

// FooBar

`Str::substr()`

Str::substr 方法返回由开始和长度参数指定的字符串部分：

php

use Illuminate\Support\Str;

$converted = Str::substr('The Laravel Framework', 4, 7);

// Laravel

`Str::substrCount()`

Str::substrCount 方法返回给定值在给定字符串中出现的次数：

php

use Illuminate\Support\Str;

$count = Str::substrCount('如果你喜欢冰淇淋，你会喜欢雪糕。', '喜欢');

// 2

`Str::substrReplace()`

Str::substrReplace 方法替换字符串部分内的文本，从第三个参数指定的位置开始，替换第四个参数指定的字符数。向方法的第四个参数传递 0 将在指定位置插入字符串，而不替换字符串中任何现有字符：

php

use Illuminate\Support\Str;

$result = Str::substrReplace('1300', ':', 2);
// 13:

$result = Str::substrReplace('1300', ':', 2, 0);
// 13:00

`Str::swap()`

Str::swap 方法使用 PHP 的 strtr 函数替换给定字符串中的多个值：

php

use Illuminate\Support\Str;

$string = Str::swap([
    'Tacos' => 'Burritos',
    'great' => 'fantastic',
], 'Tacos are great!');

// Burritos are fantastic!

`Str::take()`

Str::take 方法返回字符串开头指定数量的字符：

php

use Illuminate\Support\Str;

$taken = Str::take('构建一些了不起的东西！', 5);

// 构建一些

`Str::title()`

Str::title 方法将给定的字符串转换为 首字母大写：

php

use Illuminate\Support\Str;

$converted = Str::title('a nice title uses the correct case');

// A Nice Title Uses The Correct Case

`Str::toBase64()`

Str::toBase64 方法将给定的字符串转换为 Base64：

php

use Illuminate\Support\Str;

$base64 = Str::toBase64('Laravel');

// TGFyYXZlbA==

`Str::transliterate()`

Str::transliterate 方法将尝试将给定的字符串转换为其最接近的 ASCII 表示形式：

php

use Illuminate\Support\Str;

$email = Str::transliterate('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ');

// 'test@laravel.com'

`Str::trim()`

Str::trim 方法从给定字符串的开头和结尾去除空白（或其他字符）。与 PHP 的原生 trim 函数不同，Str::trim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::trim(' foo bar ');

// 'foo bar'

`Str::ltrim()`

Str::ltrim 方法从给定字符串的开头去除空白（或其他字符）。与 PHP 的原生 ltrim 函数不同，Str::ltrim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::ltrim('  foo bar  ');

// 'foo bar  '

`Str::rtrim()`

Str::rtrim 方法从给定字符串的结尾去除空白（或其他字符）。与 PHP 的原生 rtrim 函数不同，Str::rtrim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::rtrim('  foo bar  ');

// '  foo bar'

`Str::ucfirst()`

Str::ucfirst 方法返回给定的字符串，并将首字母大写：

php

use Illuminate\Support\Str;

$string = Str::ucfirst('foo bar');

// Foo bar

`Str::ucsplit()`

Str::ucsplit 方法通过大写字符将给定的字符串拆分为数组：

php

use Illuminate\Support\Str;

$segments = Str::ucsplit('FooBar');

// [0 => 'Foo', 1 => 'Bar']

`Str::ucwords()`

Str::ucwords 方法将给定字符串中每个单词的首字母转换为大写：

php

use Illuminate\Support\Str;

$string = Str::ucwords('laravel framework');

// Laravel Framework

`Str::upper()`

Str::upper 方法将给定的字符串转换为大写：

php

use Illuminate\Support\Str;

$string = Str::upper('laravel');

// LARAVEL

`Str::ulid()`

Str::ulid 方法生成一个 ULID，它是一个紧凑的、按时间排序的唯一标识符：

php

use Illuminate\Support\Str;

return (string) Str::ulid();

// 01gd6r360bp37zj17nxb55yv40

如果你想要获取一个表示给定 ULID 创建日期和时间的 Illuminate\Support\Carbon 日期实例，你可以使用 Laravel 的 Carbon 集成提供的 createFromId 方法：

php

use Illuminate\Support\Carbon;
use Illuminate\Support\Str;

$date = Carbon::createFromId((string) Str::ulid());

在测试期间，“伪造” Str::ulid 方法返回的值可能很有用。为此，你可以使用 createUlidsUsing 方法：

php

use Symfony\Component\Uid\Ulid;

Str::createUlidsUsing(function () {
    return new Ulid('01HRDBNHHCKNW2AK4Z29SN82T9');
});

要指示 ulid 方法恢复正常生成 ULID，你可以调用 createUlidsNormally 方法：

php

Str::createUlidsNormally();

`Str::unwrap()`

Str::unwrap 方法从给定字符串的开头和结尾移除指定的字符串：

php

use Illuminate\Support\Str;

Str::unwrap('-Laravel-', '-');

// Laravel

Str::unwrap('{framework: "Laravel"}', '{', '}');

// framework: "Laravel"

`Str::uuid()`

Str::uuid 方法生成一个 UUID（版本 4）：

php

use Illuminate\Support\Str;

return (string) Str::uuid();

在测试期间，“伪造” Str::uuid 方法返回的值可能很有用。为此，你可以使用 createUuidsUsing 方法：

php

use Ramsey\Uuid\Uuid;

Str::createUuidsUsing(function () {
    return Uuid::fromString('eadbfeac-5258-45c2-bab7-ccb9b5ef74f9');
});

要指示 uuid 方法恢复正常生成 UUID，你可以调用 createUuidsNormally 方法：

php

Str::createUuidsNormally();

`Str::uuid7()`

Str::uuid7 方法生成一个 UUID（版本 7）：

php

use Illuminate\Support\Str;

return (string) Str::uuid7();

可以传递一个 DateTimeInterface 作为可选参数，用于生成有序的 UUID：

php

return (string) Str::uuid7(time: now());

`Str::wordCount()`

Str::wordCount 方法返回字符串包含的单词数：

php

use Illuminate\Support\Str;

Str::wordCount('Hello, world!'); // 2

`Str::wordWrap()`

Str::wordWrap 方法将字符串换行到给定的字符数：

php

use Illuminate\Support\Str;

$text = "The quick brown fox jumped over the lazy dog."

Str::wordWrap($text, characters: 20, break: "<br />\n");

/*
The quick brown fox<br />
jumped over the lazy<br />
dog.
*/

`Str::words()`

Str::words 方法限制字符串中的单词数。可以通过其第三个参数向此方法传递一个附加字符串，以指定应附加到截断字符串末尾的字符串：

php

use Illuminate\Support\Str;

return Str::words('完美平衡，正如万物应有的样子。', 3, ' >>>');

// 完美平衡，正如 >>>

`Str::wrap()`

Str::wrap 方法用附加的字符串或一对字符串包装给定的字符串：

php

use Illuminate\Support\Str;

Str::wrap('Laravel', '"');

// "Laravel"

Str::wrap('is', before: 'This ', after: ' Laravel!');

// This is Laravel!

`str()`

str 函数返回给定字符串的一个新的 Illuminate\Support\Stringable 实例。此函数等同于 Str::of 方法：

php

$string = str('Taylor')->append(' Otwell');

// 'Taylor Otwell'

如果没有向 str 函数提供参数，该函数将返回一个 Illuminate\Support\Str 的实例：

php

$snake = str()->snake('FooBar');

// 'foo_bar'

`trans()`

trans 函数使用你的语言文件翻译给定的翻译键：

php

echo trans('messages.welcome');

如果指定的翻译键不存在，trans 函数将返回给定的键。因此，使用上面的示例，如果翻译键不存在，trans 函数将返回 messages.welcome。

`trans_choice()`

trans_choice 函数根据给定的数量对给定的翻译键进行变形翻译：

php

echo trans_choice('messages.notifications', $unreadCount);

如果指定的翻译键不存在，trans_choice 函数将返回给定的键。因此，使用上面的示例，如果翻译键不存在，trans_choice 函数将返回 messages.notifications。

流畅的字符串

流畅的字符串为处理字符串值提供了更流畅、面向对象的接口，允许你使用比传统字符串操作更易读的语法将多个字符串操作链式调用在一起。

`after`

after 方法返回字符串中给定值之后的所有内容。如果该值不存在于字符串中，则返回整个字符串：

php

use Illuminate\Support\Str;

$slice = Str::of('这是我的名字')->after('这是');

// ' 我的名字'

`afterLast`

afterLast 方法返回字符串中最后一次出现给定值之后的所有内容。如果该值不存在于字符串中，则返回整个字符串：

php

use Illuminate\Support\Str;

$slice = Str::of('App\Http\Controllers\Controller')->afterLast('\\');

// 'Controller'

`apa`

apa 方法根据 APA 指南将给定的字符串转换为标题大小写：

php

use Illuminate\Support\Str;

$converted = Str::of('a nice title uses the correct case')->apa();

// A Nice Title Uses the Correct Case

`append`

append 方法将给定的值附加到字符串：

php

use Illuminate\Support\Str;

$string = Str::of('Taylor')->append(' Otwell');

// 'Taylor Otwell'

`ascii`

ascii 方法将尝试将字符串音译为 ASCII 值：

php

use Illuminate\Support\Str;

$string = Str::of('ü')->ascii();

// 'u'

`basename`

basename 方法将返回给定字符串的尾部名称组件：

php

use Illuminate\Support\Str;

$string = Str::of('/foo/bar/baz')->basename();

// 'baz'

如果需要，你可以提供一个将从尾部组件中删除的“扩展名”：

php

use Illuminate\Support\Str;

$string = Str::of('/foo/bar/baz.jpg')->basename('.jpg');

// 'baz'

`before`

before 方法返回字符串中给定值之前的所有内容：

php

use Illuminate\Support\Str;

$slice = Str::of('这是我的名字')->before('我的名字');

// '这是 '

`beforeLast`

beforeLast 方法返回字符串中最后一次出现给定值之前的所有内容：

php

use Illuminate\Support\Str;

$slice = Str::of('这是我的名字')->beforeLast('是');

// '这'

`between`

between 方法返回字符串中两个值之间的部分：

php

use Illuminate\Support\Str;

$converted = Str::of('这是我的名字')->between('这', '名字');

// '是我的 '

`betweenFirst`

betweenFirst 方法返回字符串中两个值之间可能的最小部分：

php

use Illuminate\Support\Str;

$converted = Str::of('[a] bc [d]')->betweenFirst('[', ']');

// 'a'

`camel`

camel 方法将给定的字符串转换为 驼峰式：

php

use Illuminate\Support\Str;

$converted = Str::of('foo_bar')->camel();

// 'fooBar'

`charAt`

charAt 方法返回指定索引处的字符。如果索引超出范围，则返回 false：

php

use Illuminate\Support\Str;

$character = Str::of('这是我的名字。')->charAt(6);

// '名'

`classBasename`

classBasename 方法返回给定类的类名，并移除类的命名空间：

php

use Illuminate\Support\Str;

$class = Str::of('Foo\Bar\Baz')->classBasename();

// 'Baz'

`chopStart`

chopStart 方法仅在给定值出现在字符串开头时移除该值的第一次出现：

php

use Illuminate\Support\Str;

$url = Str::of('https://laravel.com')->chopStart('https://');

// 'laravel.com'

你也可以传递一个数组。如果字符串以数组中的任何一个值开头，则该值将从字符串中移除：

php

use Illuminate\Support\Str;

$url = Str::of('http://laravel.com')->chopStart(['https://', 'http://']);

// 'laravel.com'

`chopEnd`

chopEnd 方法仅在给定值出现在字符串末尾时移除该值的最后一次出现：

php

use Illuminate\Support\Str;

$url = Str::of('https://laravel.com')->chopEnd('.com');

// 'https://laravel'

你也可以传递一个数组。如果字符串以数组中的任何一个值结尾，则该值将从字符串中移除：

php

use Illuminate\Support\Str;

$url = Str::of('http://laravel.com')->chopEnd(['.com', '.io']);

// 'http://laravel'

`contains`

contains 方法确定给定的字符串是否包含给定的值。默认情况下，此方法区分大小写：

php

use Illuminate\Support\Str;

$contains = Str::of('这是我的名字')->contains('我的');

// true

你也可以传递一个值数组，以确定给定的字符串是否包含数组中的任何值：

php

use Illuminate\Support\Str;

$contains = Str::of('这是我的名字')->contains(['我的', 'foo']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$contains = Str::of('这是我的名字')->contains('MY', ignoreCase: true);

// true

`containsAll`

containsAll 方法确定给定的字符串是否包含给定数组中的所有值：

php

use Illuminate\Support\Str;

$containsAll = Str::of('这是我的名字')->containsAll(['我的', '名字']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$containsAll = Str::of('这是我的名字')->containsAll(['MY', 'NAME'], ignoreCase: true);

// true

`decrypt`

decrypt 方法解密加密的字符串：

php

use Illuminate\Support\Str;

$decrypted = $encrypted->decrypt();

// 'secret'

对于 decrypt 的反向操作，请参阅 encrypt 方法。

`deduplicate`

deduplicate 方法将字符串中连续出现的某个字符替换为该字符的单个实例。默认情况下，该方法对空格进行去重：

php

use Illuminate\Support\Str;

$result = Str::of('The   Laravel   Framework')->deduplicate();

// The Laravel Framework

你可以通过将不同的字符作为第二个参数传递给该方法来指定要去重的字符：

php

use Illuminate\Support\Str;

$result = Str::of('The---Laravel---Framework')->deduplicate('-');

// The-Laravel-Framework

`dirname`

dirname 方法返回给定字符串的父目录部分：

php

use Illuminate\Support\Str;

$string = Str::of('/foo/bar/baz')->dirname();

// '/foo/bar'

如有必要，你可以指定要从字符串中修剪的目录层级数：

php

use Illuminate\Support\Str;

$string = Str::of('/foo/bar/baz')->dirname(2);

// '/foo'

`doesntContain()`

doesntContain 方法确定给定的字符串是否不包含给定的值。此方法是 contains 方法的反向操作。默认情况下，此方法区分大小写：

php

use Illuminate\Support\Str;

$doesntContain = Str::of('这是名字')->doesntContain('我的');

// true

你也可以传递一个值数组，以确定给定的字符串是否不包含数组中的任何值：

php

use Illuminate\Support\Str;

$doesntContain = Str::of('这是名字')->doesntContain(['我的', '框架']);

// true

你可以通过将 ignoreCase 参数设置为 true 来禁用区分大小写：

php

use Illuminate\Support\Str;

$doesntContain = Str::of('这是我的名字')->doesntContain('MY', ignoreCase: true);

// false

`doesntEndWith`

doesntEndWith 方法确定给定的字符串是否不以给定的值结尾：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->doesntEndWith('狗');

// true

你也可以传递一个值数组，以确定给定的字符串是否不以数组中的任何值结尾：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->doesntEndWith(['this', 'foo']);

// true

$result = Str::of('这是我的名字')->doesntEndWith(['名字', 'foo']);

// false

`doesntStartWith`

doesntStartWith 方法确定给定的字符串是否不以给定的值开头：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->doesntStartWith('那');

// true

你也可以传递一个值数组，以确定给定的字符串是否不以数组中的任何值开头：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->doesntStartWith(['什么', '那', '那里']);

// true

`encrypt`

encrypt 方法加密字符串：

php

use Illuminate\Support\Str;

$encrypted = Str::of('secret')->encrypt();

对于 encrypt 的反向操作，请参阅 decrypt 方法。

`endsWith`

endsWith 方法确定给定的字符串是否以给定的值结尾：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->endsWith('名字');

// true

你也可以传递一个值数组，以确定给定的字符串是否以数组中的任何值结尾：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->endsWith(['名字', 'foo']);

// true

$result = Str::of('这是我的名字')->endsWith(['this', 'foo']);

// false

`exactly`

exactly 方法确定给定的字符串是否与另一个字符串完全匹配：

php

use Illuminate\Support\Str;

$result = Str::of('Laravel')->exactly('Laravel');

// true

`excerpt`

excerpt 方法从字符串中提取与其中某个短语的首次实例相匹配的摘录：

php

use Illuminate\Support\Str;

$excerpt = Str::of('这是我的名字')->excerpt('我的', [
    'radius' => 3
]);

// '...是我的名字...' // 注：中文语境可能需要调整，但按原示例翻译

radius 选项默认为 100，允许你定义截断字符串两侧应出现的字符数。

此外，你可以使用 omission 选项来更改将前置和附加到截断字符串的字符串：

php

use Illuminate\Support\Str;

$excerpt = Str::of('这是我的名字')->excerpt('名字', [
    'radius' => 3,
    'omission' => '(...) '
]);

// '(...) 我的名字'

`explode`

explode 方法按给定的分隔符拆分字符串，并返回包含拆分后字符串的每个部分的集合：

php

use Illuminate\Support\Str;

$collection = Str::of('foo bar baz')->explode(' ');

// collect(['foo', 'bar', 'baz'])

`finish`

finish 方法在字符串末尾添加给定值的单个实例（如果该字符串尚未以该值结尾）：

php

use Illuminate\Support\Str;

$adjusted = Str::of('this/string')->finish('/');

// this/string/

$adjusted = Str::of('this/string/')->finish('/');

// this/string/

`fromBase64`

fromBase64 方法解码给定的 Base64 字符串：

php

use Illuminate\Support\Str;

$decoded = Str::of('TGFyYXZlbA==')->fromBase64();

// Laravel

`hash`

hash 方法使用给定的算法对字符串进行哈希：

php

use Illuminate\Support\Str;

$hashed = Str::of('secret')->hash(algorithm: 'sha256');

// '2bb80d537b1da3e38bd30361aa855686bde0eacd7162fef6a25fe97bf527a25b'

`headline`

headline 方法会将使用大小写、连字符或下划线分隔的字符串转换为以空格分隔的字符串，且每个单词的首字母大写：

php

use Illuminate\Support\Str;

$headline = Str::of('taylor_otwell')->headline();

// Taylor Otwell

$headline = Str::of('EmailNotificationSent')->headline();

// Email Notification Sent

`initials`

initials 方法会将字符串转换为其首字母缩写：

php

use Illuminate\Support\Str;

$initials = Str::of('Taylor Otwell')->initials()->upper();

// TO

`inlineMarkdown`

inlineMarkdown 方法使用 CommonMark 将 GitHub 风格的 Markdown 转换为内联 HTML。但是，与 markdown 方法不同，它不会将所有生成的 HTML 包装在块级元素中：

php

use Illuminate\Support\Str;

$html = Str::of('**Laravel**')->inlineMarkdown();

// <strong>Laravel</strong>

Markdown 安全性

php

use Illuminate\Support\Str;

Str::of('注入: <script>alert("Hello XSS!");</script>')->inlineMarkdown([
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);

// 注入: alert(&quot;Hello XSS!&quot;);

`is`

is 方法确定给定的字符串是否与给定的模式匹配。星号可用作通配符值：

php

use Illuminate\Support\Str;

$matches = Str::of('foobar')->is('foo*');

// true

$matches = Str::of('foobar')->is('baz*');

// false

`isAscii`

isAscii 方法确定给定的字符串是否为 ASCII 字符串：

php

use Illuminate\Support\Str;

$result = Str::of('Taylor')->isAscii();

// true

$result = Str::of('ü')->isAscii();

// false

`isEmpty`

isEmpty 方法确定给定的字符串是否为空：

php

use Illuminate\Support\Str;

$result = Str::of('  ')->trim()->isEmpty();

// true

$result = Str::of('Laravel')->trim()->isEmpty();

// false

`isNotEmpty`

isNotEmpty 方法确定给定的字符串是否不为空：

php

use Illuminate\Support\Str;

$result = Str::of('  ')->trim()->isNotEmpty();

// false

$result = Str::of('Laravel')->trim()->isNotEmpty();

// true

`isJson`

isJson 方法确定给定的字符串是否为有效的 JSON：

php

use Illuminate\Support\Str;

$result = Str::of('[1,2,3]')->isJson();

// true

$result = Str::of('{"first": "John", "last": "Doe"}')->isJson();

// true

$result = Str::of('{first: "John", last: "Doe"}')->isJson();

// false

`isUlid`

isUlid 方法确定给定的字符串是否为 ULID：

php

use Illuminate\Support\Str;

$result = Str::of('01gd6r360bp37zj17nxb55yv40')->isUlid();

// true

$result = Str::of('Taylor')->isUlid();

// false

`isUrl`

isUrl 方法确定给定的字符串是否为 URL：

php

use Illuminate\Support\Str;

$result = Str::of('http://example.com')->isUrl();

// true

$result = Str::of('Taylor')->isUrl();

// false

isUrl 方法将多种协议视为有效。但是，你可以通过将它们提供给 isUrl 方法来指定应视为有效的协议：

php

$result = Str::of('http://example.com')->isUrl(['http', 'https']);

`isUuid`

isUuid 方法确定给定的字符串是否为 UUID：

php

use Illuminate\Support\Str;

$result = Str::of('5ace9ab9-e9cf-4ec6-a19d-5881212a452c')->isUuid();

// true

$result = Str::of('Taylor')->isUuid();

// false

你还可以验证给定的 UUID 是否匹配特定版本（1、3、4、5、6、7 或 8）的 UUID 规范：

php

use Illuminate\Support\Str;

$isUuid = Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->isUuid(version: 4);

// true

$isUuid = Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->isUuid(version: 1);

// false

`kebab`

kebab 方法将给定的字符串转换为 短横线命名：

php

use Illuminate\Support\Str;

$converted = Str::of('fooBar')->kebab();

// foo-bar

`lcfirst`

lcfirst 方法返回给定的字符串，并将首字母转换为小写：

php

use Illuminate\Support\Str;

$string = Str::of('Foo Bar')->lcfirst();

// foo Bar

`length`

length 方法返回给定字符串的长度：

php

use Illuminate\Support\Str;

$length = Str::of('Laravel')->length();

// 7

`limit`

limit 方法将给定的字符串截断为指定的长度：

php

use Illuminate\Support\Str;

$truncated = Str::of('敏捷的棕色狐狸跃过懒狗')->limit(20);

// 敏捷的棕色狐狸跃过...

你也可以传递第二个参数来更改将附加到截断字符串末尾的字符串：

php

$truncated = Str::of('敏捷的棕色狐狸跃过懒狗')->limit(20, ' (...)');

// 敏捷的棕色狐狸跃过 (...)

如果希望在截断字符串时保留完整的单词，可以利用 preserveWords 参数。当此参数为 true 时，字符串将截断到最近的完整单词边界：

php

$truncated = Str::of('敏捷的棕色狐狸')->limit(12, preserveWords: true);

// 敏捷的棕色...

`lower`

lower 方法将给定的字符串转换为小写：

php

use Illuminate\Support\Str;

$result = Str::of('LARAVEL')->lower();

// 'laravel'

`markdown`

markdown 方法将 GitHub 风格的 Markdown 转换为 HTML：

php

use Illuminate\Support\Str;

$html = Str::of('# Laravel')->markdown();

// <h1>Laravel</h1>

$html = Str::of('# Taylor <b>Otwell</b>')->markdown([
    'html_input' => 'strip',
]);

// <h1>Taylor Otwell</h1>

Markdown 安全性

php

use Illuminate\Support\Str;

Str::of('注入: <script>alert("Hello XSS!");</script>')->markdown([
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);

// <p>注入: alert(&quot;Hello XSS!&quot;);</p>

`mask`

mask 方法用重复字符遮蔽字符串的一部分，可用于混淆字符串的片段，如电子邮件地址和电话号码：

php

use Illuminate\Support\Str;

$string = Str::of('taylor@example.com')->mask('*', 3);

// tay***************

如果需要，你可以向 mask 方法提供负数作为第三个或第四个参数，这将指示该方法从距离字符串末尾的给定位置开始遮蔽：

php

$string = Str::of('taylor@example.com')->mask('*', -15, 3);

// tay***@example.com

$string = Str::of('taylor@example.com')->mask('*', 4, -4);

// tayl**********.com

`match`

match 方法将返回与给定正则表达式模式匹配的字符串部分：

php

use Illuminate\Support\Str;

$result = Str::of('foo bar')->match('/bar/');

// 'bar'

$result = Str::of('foo bar')->match('/foo (.*)/');

// 'bar'

`matchAll`

matchAll 方法将返回一个集合，其中包含与给定正则表达式模式匹配的字符串部分：

php

use Illuminate\Support\Str;

$result = Str::of('bar foo bar')->matchAll('/bar/');

// collect(['bar', 'bar'])

如果你在表达式中指定了一个匹配组，Laravel 将返回第一个匹配组的匹配项集合：

php

use Illuminate\Support\Str;

$result = Str::of('bar fun bar fly')->matchAll('/f(\w*)/');

// collect(['un', 'ly']);

如果未找到匹配项，将返回一个空集合。

`isMatch`

isMatch 方法如果字符串匹配给定的正则表达式，将返回 true：

php

use Illuminate\Support\Str;

$result = Str::of('foo bar')->isMatch('/foo (.*)/');

// true

$result = Str::of('laravel')->isMatch('/foo (.*)/');

// false

`newLine`

newLine 方法将一个“换行”字符附加到字符串：

php

use Illuminate\Support\Str;

$padded = Str::of('Laravel')->newLine()->append('Framework');

// 'Laravel
//  Framework'

`padBoth`

padBoth 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的两侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::of('James')->padBoth(10, '_');

// '__James___'

$padded = Str::of('James')->padBoth(10);

// '  James   '

`padLeft`

padLeft 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的左侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::of('James')->padLeft(10, '-=');

// '-=-=-James'

$padded = Str::of('James')->padLeft(10);

// '     James'

`padRight`

padRight 方法包装了 PHP 的 str_pad 函数，用另一个字符串填充字符串的右侧，直到最终字符串达到所需长度：

php

use Illuminate\Support\Str;

$padded = Str::of('James')->padRight(10, '-');

// 'James-----'

$padded = Str::of('James')->padRight(10);

// 'James     '

`pipe`

pipe 方法允许你通过将当前值传递给给定的可调用对象来转换字符串：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$hash = Str::of('Laravel')->pipe('md5')->prepend('Checksum: ');

// 'Checksum: a5c95b86291ea299fcbe64458ed12702'

$closure = Str::of('foo')->pipe(function (Stringable $str) {
    return 'bar';
});

// 'bar'

`plural`

plural 方法将单数词字符串转换为其复数形式。此函数支持 Laravel 复数化器支持的任何语言：

php

use Illuminate\Support\Str;

$plural = Str::of('car')->plural();

// cars

$plural = Str::of('child')->plural();

// children

你可以向函数提供一个整数参数，以获取字符串的单数或复数形式：

php

use Illuminate\Support\Str;

$plural = Str::of('child')->plural(2);

// children

$plural = Str::of('child')->plural(1);

// child

你可以提供 prependCount 参数以在复数化字符串前加上格式化的 $count：

php

use Illuminate\Support\Str;

$label = Str::of('car')->plural(1000, prependCount: true);

// 1,000 cars

`position`

position 方法返回子字符串在字符串中首次出现的位置。如果子字符串在字符串中不存在，则返回 false：

php

use Illuminate\Support\Str;

$position = Str::of('Hello, World!')->position('Hello');

// 0

$position = Str::of('Hello, World!')->position('W');

// 7

`prepend`

prepend 方法将给定的值前置到字符串：

php

use Illuminate\Support\Str;

$string = Str::of('Framework')->prepend('Laravel ');

// Laravel Framework

`remove`

remove 方法从字符串中移除给定的值或值数组：

php

use Illuminate\Support\Str;

$string = Str::of('Arkansas is quite beautiful!')->remove('quite ');

// Arkansas is beautiful!

你还可以向 remove 方法传递 false 作为第二个参数，以在移除字符串时忽略大小写。

`repeat`

repeat 方法重复给定的字符串：

php

use Illuminate\Support\Str;

$repeated = Str::of('a')->repeat(5);

// aaaaa

`replace`

replace 方法替换字符串中的给定字符串：

php

use Illuminate\Support\Str;

$replaced = Str::of('Laravel 6.x')->replace('6.x', '7.x');

// Laravel 7.x

replace 方法还接受一个 caseSensitive 参数。默认情况下，replace 方法区分大小写：

php

$replaced = Str::of('macOS 13.x')->replace(
    'macOS', 'iOS', caseSensitive: false
);

`replaceArray`

replaceArray 方法使用数组顺序替换字符串中的给定值：

php

use Illuminate\Support\Str;

$string = '活动将在 ? 和 ? 之间举行';

$replaced = Str::of($string)->replaceArray('?', ['8:30', '9:00']);

// 活动将在 8:30 和 9:00 之间举行

`replaceFirst`

replaceFirst 方法替换字符串中第一次出现的给定值：

php

use Illuminate\Support\Str;

$replaced = Str::of('the quick brown fox jumps over the lazy dog')->replaceFirst('the', 'a');

// a quick brown fox jumps over the lazy dog

`replaceLast`

replaceLast 方法替换字符串中最后一次出现的给定值：

php

use Illuminate\Support\Str;

$replaced = Str::of('the quick brown fox jumps over the lazy dog')->replaceLast('the', 'a');

// the quick brown fox jumps over a lazy dog

`replaceMatches`

replaceMatches 方法用给定的替换字符串替换字符串中与模式匹配的所有部分：

php

use Illuminate\Support\Str;

$replaced = Str::of('(+1) 501-555-1000')->replaceMatches('/[^A-Za-z0-9]++/', '');

// '15015551000'

replaceMatches 方法还接受一个闭包，该闭包将为字符串中与给定模式匹配的每个部分调用，允许你在闭包内执行替换逻辑并返回替换后的值：

php

use Illuminate\Support\Str;

$replaced = Str::of('123')->replaceMatches('/\d/', function (array $matches) {
    return '['.$matches[0].']';
});

// '[1][2][3]'

`replaceStart`

replaceStart 方法仅在给定值出现在字符串开头时替换该值的第一次出现：

php

use Illuminate\Support\Str;

$replaced = Str::of('Hello World')->replaceStart('Hello', 'Laravel');

// Laravel World

$replaced = Str::of('Hello World')->replaceStart('World', 'Laravel');

// Hello World

`replaceEnd`

replaceEnd 方法仅在给定值出现在字符串末尾时替换该值的最后一次出现：

php

use Illuminate\Support\Str;

$replaced = Str::of('Hello World')->replaceEnd('World', 'Laravel');

// Hello Laravel

$replaced = Str::of('Hello World')->replaceEnd('Hello', 'Laravel');

// Hello World

`scan`

scan 方法根据 sscanf PHP 函数支持的格式，将输入从字符串解析到集合中：

php

use Illuminate\Support\Str;

$collection = Str::of('filename.jpg')->scan('%[^.].%s');

// collect(['filename', 'jpg'])

`singular`

singular 方法将字符串转换为其单数形式。此函数支持 Laravel 复数化器支持的任何语言：

php

use Illuminate\Support\Str;

$singular = Str::of('cars')->singular();

// car

$singular = Str::of('children')->singular();

// child

`slug`

slug 方法从给定的字符串生成一个 URL 友好的“slug”：

php

use Illuminate\Support\Str;

$slug = Str::of('Laravel Framework')->slug('-');

// laravel-framework

`snake`

snake 方法将给定的字符串转换为 蛇形命名：

php

use Illuminate\Support\Str;

$converted = Str::of('fooBar')->snake();

// foo_bar

`split`

split 方法使用正则表达式将字符串拆分为集合：

php

use Illuminate\Support\Str;

$segments = Str::of('one, two, three')->split('/[\s,]+/');

// collect(["one", "two", "three"])

`squish`

squish 方法从字符串中删除所有多余的空格，包括单词之间的多余空格：

php

use Illuminate\Support\Str;

$string = Str::of('    laravel    framework    ')->squish();

// laravel framework

`start`

start 方法在字符串开头添加给定值的单个实例（如果该字符串尚未以该值开头）：

php

use Illuminate\Support\Str;

$adjusted = Str::of('this/string')->start('/');

// /this/string

$adjusted = Str::of('/this/string')->start('/');

// /this/string

`startsWith`

startsWith 方法确定给定的字符串是否以给定的值开头：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->startsWith('这');

// true

你也可以传递一个值数组，以确定给定的字符串是否以数组中的任何值开头：

php

use Illuminate\Support\Str;

$result = Str::of('这是我的名字')->startsWith(['这', '那']);

// true

`stripTags`

stripTags 方法从字符串中删除所有 HTML 和 PHP 标签：

php

use Illuminate\Support\Str;

$result = Str::of('<a href="https://laravel.com">Taylor <b>Otwell</b></a>')->stripTags();

// Taylor Otwell

$result = Str::of('<a href="https://laravel.com">Taylor <b>Otwell</b></a>')->stripTags('<b>');

// Taylor <b>Otwell</b>

`studly`

studly 方法将给定的字符串转换为 大驼峰式：

php

use Illuminate\Support\Str;

$converted = Str::of('foo_bar')->studly();

// FooBar

`substr`

substr 方法返回由给定的开始和长度参数指定的字符串部分：

php

use Illuminate\Support\Str;

$string = Str::of('Laravel Framework')->substr(8);

// Framework

$string = Str::of('Laravel Framework')->substr(8, 5);

// Frame

`substrReplace`

substrReplace 方法替换字符串部分内的文本，从第二个参数指定的位置开始，替换第三个参数指定的字符数。向方法的第三个参数传递 0 将在指定位置插入字符串，而不替换字符串中任何现有字符：

php

use Illuminate\Support\Str;

$string = Str::of('1300')->substrReplace(':', 2);

// 13:

$string = Str::of('The Framework')->substrReplace(' Laravel', 3, 0);

// The Laravel Framework

`swap`

swap 方法使用 PHP 的 strtr 函数替换字符串中的多个值：

php

use Illuminate\Support\Str;

$string = Str::of('Tacos are great!')
    ->swap([
        'Tacos' => 'Burritos',
        'great' => 'fantastic',
    ]);

// Burritos are fantastic!

`take`

take 方法返回字符串开头指定数量的字符：

php

use Illuminate\Support\Str;

$taken = Str::of('构建一些了不起的东西！')->take(5);

// 构建一些

`tap`

tap 方法将字符串传递给给定的闭包，允许你在不影响字符串本身的情况下检查和操作字符串。tap 方法返回原始字符串，无论闭包返回什么：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('Laravel')
    ->append(' Framework')
    ->tap(function (Stringable $string) {
        dump('附加后的字符串: '.$string);
    })
    ->upper();

// LARAVEL FRAMEWORK

`test`

test 方法确定字符串是否匹配给定的正则表达式模式：

php

use Illuminate\Support\Str;

$result = Str::of('Laravel Framework')->test('/Laravel/');

// true

`title`

title 方法将给定的字符串转换为 首字母大写：

php

use Illuminate\Support\Str;

$converted = Str::of('a nice title uses the correct case')->title();

// A Nice Title Uses The Correct Case

`toBase64`

toBase64 方法将给定的字符串转换为 Base64：

php

use Illuminate\Support\Str;

$base64 = Str::of('Laravel')->toBase64();

// TGFyYXZlbA==

`toHtmlString`

toHtmlString 方法将给定的字符串转换为 Illuminate\Support\HtmlString 的实例，该实例在 Blade 模板中渲染时不会被转义：

php

use Illuminate\Support\Str;

$htmlString = Str::of('Nuno Maduro')->toHtmlString();

`toUri`

toUri 方法将给定的字符串转换为 Illuminate\Support\Uri 的实例：

php

use Illuminate\Support\Str;

$uri = Str::of('https://example.com')->toUri();

`transliterate`

transliterate 方法将尝试将给定的字符串转换为其最接近的 ASCII 表示形式：

php

use Illuminate\Support\Str;

$email = Str::of('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ')->transliterate();

// 'test@laravel.com'

`trim`

trim 方法修剪给定的字符串。与 PHP 的原生 trim 函数不同，Laravel 的 trim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::of('  Laravel  ')->trim();

// 'Laravel'

$string = Str::of('/Laravel/')->trim('/');

// 'Laravel'

`ltrim`

ltrim 方法修剪字符串的左侧。与 PHP 的原生 ltrim 函数不同，Laravel 的 ltrim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::of('  Laravel  ')->ltrim();

// 'Laravel  '

$string = Str::of('/Laravel/')->ltrim('/');

// 'Laravel/'

`rtrim`

rtrim 方法修剪给定字符串的右侧。与 PHP 的原生 rtrim 函数不同，Laravel 的 rtrim 方法还会去除 Unicode 空白字符：

php

use Illuminate\Support\Str;

$string = Str::of('  Laravel  ')->rtrim();

// '  Laravel'

$string = Str::of('/Laravel/')->rtrim('/');

// '/Laravel'

`ucfirst`

ucfirst 方法返回给定的字符串，并将首字母大写：

php

use Illuminate\Support\Str;

$string = Str::of('foo bar')->ucfirst();

// Foo bar

`ucsplit`

ucsplit 方法通过大写字符将给定的字符串拆分为一个集合：

php

use Illuminate\Support\Str;

$string = Str::of('Foo Bar')->ucsplit();

// collect(['Foo ', 'Bar'])

`ucwords`

ucwords 方法将给定字符串中每个单词的首字母转换为大写：

php

use Illuminate\Support\Str;

$string = Str::of('laravel framework')->ucwords();

// Laravel Framework

`unwrap`

unwrap 方法从给定字符串的开头和结尾移除指定的字符串：

php

use Illuminate\Support\Str;

Str::of('-Laravel-')->unwrap('-');

// Laravel

Str::of('{framework: "Laravel"}')->unwrap('{', '}');

// framework: "Laravel"

`upper`

upper 方法将给定的字符串转换为大写：

php

use Illuminate\Support\Str;

$adjusted = Str::of('laravel')->upper();

// LARAVEL

`when`

when 方法在给定条件为 true 时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('Taylor')
    ->when(true, function (Stringable $string) {
        return $string->append(' Otwell');
    });

// 'Taylor Otwell'

如有必要，你可以向 when 方法传递另一个闭包作为第三个参数。此闭包将在条件参数评估为 false 时执行。

`whenContains`

whenContains 方法在字符串包含给定值时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('tony stark')
    ->whenContains('tony', function (Stringable $string) {
        return $string->title();
    });

// 'Tony Stark'

如有必要，你可以传递另一个闭包作为第三个参数。如果字符串不包含给定的值，则将调用此闭包。

你也可以传递一个值数组，以确定给定的字符串是否包含数组中的任何值：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('tony stark')
    ->whenContains(['tony', 'hulk'], function (Stringable $string) {
        return $string->title();
    });

// Tony Stark

`whenContainsAll`

whenContainsAll 方法在字符串包含所有给定的子字符串时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('tony stark')
    ->whenContainsAll(['tony', 'stark'], function (Stringable $string) {
        return $string->title();
    });

// 'Tony Stark'

如有必要，你可以传递另一个闭包作为第三个参数。如果条件参数评估为 false，则将调用此闭包。

`whenDoesntEndWith`

whenDoesntEndWith 方法在字符串不以给定的子字符串结尾时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('disney world')->whenDoesntEndWith('land', function (Stringable $string) {
    return $string->title();
});

// 'Disney World'

`whenDoesntStartWith`

whenDoesntStartWith 方法在字符串不以给定的子字符串开头时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('disney world')->whenDoesntStartWith('sea', function (Stringable $string) {
    return $string->title();
});

// 'Disney World'

`whenEmpty`

whenEmpty 方法在字符串为空时调用给定的闭包。如果闭包返回一个值，则该值也将由 whenEmpty 方法返回。如果闭包没有返回值，则将返回流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('  ')->trim()->whenEmpty(function (Stringable $string) {
    return $string->prepend('Laravel');
});

// 'Laravel'

`whenNotEmpty`

whenNotEmpty 方法在字符串不为空时调用给定的闭包。如果闭包返回一个值，则该值也将由 whenNotEmpty 方法返回。如果闭包没有返回值，则将返回流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('Framework')->whenNotEmpty(function (Stringable $string) {
    return $string->prepend('Laravel ');
});

// 'Laravel Framework'

`whenStartsWith`

whenStartsWith 方法在字符串以给定的子字符串开头时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('disney world')->whenStartsWith('disney', function (Stringable $string) {
    return $string->title();
});

// 'Disney World'

`whenEndsWith`

whenEndsWith 方法在字符串以给定的子字符串结尾时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('disney world')->whenEndsWith('world', function (Stringable $string) {
    return $string->title();
});

// 'Disney World'

`whenExactly`

whenExactly 方法在字符串与给定的字符串完全匹配时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('laravel')->whenExactly('laravel', function (Stringable $string) {
    return $string->title();
});

// 'Laravel'

`whenNotExactly`

whenNotExactly 方法在字符串不与给定的字符串完全匹配时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('framework')->whenNotExactly('laravel', function (Stringable $string) {
    return $string->title();
});

// 'Framework'

`whenIs`

whenIs 方法在字符串匹配给定模式时调用给定的闭包。星号可用作通配符值。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('foo/bar')->whenIs('foo/*', function (Stringable $string) {
    return $string->append('/baz');
});

// 'foo/bar/baz'

`whenIsAscii`

whenIsAscii 方法在字符串是 7 位 ASCII 码时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('laravel')->whenIsAscii(function (Stringable $string) {
    return $string->title();
});

// 'Laravel'

`whenIsUlid`

whenIsUlid 方法在字符串是有效的 ULID 时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;

$string = Str::of('01gd6r360bp37zj17nxb55yv40')->whenIsUlid(function (Stringable $string) {
    return $string->substr(0, 8);
});

// '01gd6r36'

`whenIsUuid`

whenIsUuid 方法在字符串是有效的 UUID 时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('a0a2a2d2-0b87-4a18-83f2-2529882be2de')->whenIsUuid(function (Stringable $string) {
    return $string->substr(0, 8);
});

// 'a0a2a2d2'

`whenTest`

whenTest 方法在字符串匹配给定的正则表达式时调用给定的闭包。闭包将接收流畅的字符串实例：

php

use Illuminate\Support\Str;
use Illuminate\Support\Stringable;

$string = Str::of('laravel framework')->whenTest('/laravel/', function (Stringable $string) {
    return $string->title();
});

// 'Laravel Framework'

`wordCount`

wordCount 方法返回字符串包含的单词数：

php

use Illuminate\Support\Str;

Str::of('Hello, world!')->wordCount(); // 2

`words`

words 方法限制字符串中的单词数。如有必要，你可以指定将附加到截断字符串的附加字符串：

php

use Illuminate\Support\Str;

$string = Str::of('完美平衡，正如万物应有的样子。')->words(3, ' >>>');

// 完美平衡，正如 >>>

`wrap`

wrap 方法用附加的字符串或一对字符串包装给定的字符串：

php

use Illuminate\Support\Str;

Str::of('Laravel')->wrap('"');

// "Laravel"

Str::is('is')->wrap(before: 'This ', after: ' Laravel!');

// This is Laravel!

字符串 ​

简介 ​

可用方法 ​

字符串 ​

流畅的字符串 ​

字符串 ​

__() ​

class_basename() ​

e() ​

preg_replace_array() ​

Str::after() ​

Str::afterLast() ​

Str::apa() ​

Str::ascii() ​

Str::before() ​

Str::beforeLast() ​

Str::between() ​

Str::betweenFirst() ​

Str::camel() ​

Str::charAt() ​

Str::chopStart() ​

Str::chopEnd() ​

Str::contains() ​

Str::containsAll() ​

Str::doesntContain() ​

Str::deduplicate() ​

Str::doesntEndWith() ​

Str::doesntStartWith() ​

Str::endsWith() ​

Str::excerpt() ​

Str::finish() ​

Str::fromBase64() ​

Str::headline() ​

Str::initials() ​

Str::inlineMarkdown() ​

Markdown 安全性 ​

Str::is() ​

Str::isAscii() ​

Str::isJson() ​

Str::isUrl() ​

Str::isUlid() ​

Str::isUuid() ​

Str::kebab() ​

Str::lcfirst() ​

Str::length() ​

Str::limit() ​

Str::lower() ​

Str::markdown() ​

Markdown 安全性 ​

Str::mask() ​

Str::match() ​

Str::matchAll() ​

Str::isMatch() ​

Str::orderedUuid() ​

Str::padBoth() ​

Str::padLeft() ​

Str::padRight() ​

Str::password() ​

Str::plural() ​

Str::pluralStudly() ​

Str::position() ​

Str::random() ​

Str::remove() ​

Str::repeat() ​

Str::replace() ​

Str::replaceArray() ​

Str::replaceFirst() ​

Str::replaceLast() ​

Str::replaceMatches() ​

Str::replaceStart() ​

Str::replaceEnd() ​

Str::reverse() ​

Str::singular() ​

Str::slug() ​

Str::snake() ​

Str::squish() ​

Str::start() ​

Str::startsWith() ​

Str::studly() ​

Str::substr() ​

字符串

简介

可用方法

字符串

流畅的字符串

字符串

`__()`

`class_basename()`

`e()`

`preg_replace_array()`

`Str::after()`

`Str::afterLast()`

`Str::apa()`

`Str::ascii()`

`Str::before()`

`Str::beforeLast()`

`Str::between()`

`Str::betweenFirst()`

`Str::camel()`

`Str::charAt()`

`Str::chopStart()`

`Str::chopEnd()`

`Str::contains()`

`Str::containsAll()`

`Str::doesntContain()`

`Str::deduplicate()`

`Str::doesntEndWith()`

`Str::doesntStartWith()`

`Str::endsWith()`

`Str::excerpt()`

`Str::finish()`

`Str::fromBase64()`

`Str::headline()`

`Str::initials()`

`Str::inlineMarkdown()`

Markdown 安全性

`Str::is()`

`Str::isAscii()`

`Str::isJson()`

`Str::isUrl()`

`Str::isUlid()`

`Str::isUuid()`

`Str::kebab()`

`Str::lcfirst()`

`Str::length()`

`Str::limit()`

`Str::lower()`

`Str::markdown()`

Markdown 安全性

`Str::mask()`

`Str::match()`

`Str::matchAll()`

`Str::isMatch()`

`Str::orderedUuid()`

`Str::padBoth()`

`Str::padLeft()`

`Str::padRight()`

`Str::password()`

`Str::plural()`

`Str::pluralStudly()`

`Str::position()`

`Str::random()`

`Str::remove()`

`Str::repeat()`

`Str::replace()`

`Str::replaceArray()`

`Str::replaceFirst()`

`Str::replaceLast()`

`Str::replaceMatches()`

`Str::replaceStart()`

`Str::replaceEnd()`

`Str::reverse()`

`Str::singular()`

`Str::slug()`

`Str::snake()`

`Str::squish()`

`Str::start()`

`Str::startsWith()`

`Str::studly()`

`Str::substr()`