字符串

介绍
可用方法

介绍

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::endsWith Str::excerpt Str::finish Str::headline 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::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::upper Str::ulid Str::unwrap Str::uuid Str::wordCount Str::wordWrap Str::words Str::wrap str trans trans_choice

流畅字符串

字符串

`__()`

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

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('创建一个项目');

// '创建一个项目'

`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 方法将给定字符串转换为 camelCase：

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('这是我的名字', '我的', 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('这是我的名字', ['我的', '名字'], ignoreCase: true);

// true

`Str::doesntContain()`

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

php

use Illuminate\Support\Str;

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

// true

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

php

use Illuminate\Support\Str;

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

// true

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

php

use Illuminate\Support\Str;

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

// true

`Str::deduplicate()`

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

php

use Illuminate\Support\Str;

$result = Str::deduplicate('Laravel   框架');

// Laravel 框架

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

php

use Illuminate\Support\Str;

$result = Str::deduplicate('Laravel---框架', '-');

// Laravel-框架

`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('这是我的名字', ['这是', '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::headline()`

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

php

use Illuminate\Support\Str;

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

// Steve Jobs

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

// Email Notification Sent

`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，你应该通过 HTML 清理器传递编译后的 Markdown：

php

use Illuminate\Support\Str;

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

// Inject: 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

`Str::kebab()`

Str::kebab 方法将给定字符串转换为 kebab-case：

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('Inject: <script>alert("Hello XSS!");</script>', [
    'html_input' => 'strip',
    'allow_unsafe_links' => false,
]);

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

`Str::mask()`

Str::mask 方法使用重复字符掩盖字符串的一部分，可用于模糊化字符串的某些部分，例如电子邮件地址和电话号码：

php

use Illuminate\Support\Str;

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

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

如果需要，你可以提供一个负数作为第三个参数，这将指示该方法从字符串末尾的给定距离开始掩盖：

php

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

// tay***@example.com

`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('车');

// 车

$plural = Str::plural('孩子');

// 孩子

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

php

use Illuminate\Support\Str;

$plural = Str::plural('孩子', 2);

// 孩子

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

// 孩子

`Str::pluralStudly()`

Str::pluralStudly 方法将以 Studly 大写格式的单数单词字符串转换为复数形式。此函数支持 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.

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

`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 10.x';

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

// Laravel 11.x

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

php

Str::replace('Framework', 'Laravel', caseSensitive: false);

`Str::replaceArray()`

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

php

use Illuminate\Support\Str;

$string = 'The event will take place between ? and ?';

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

// The event will take place between 8:30 and 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 方法将给定字符串转换为 snake_case：

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('This is my name', 'This');

// true

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

php

$result = Str::startsWith('This is my name', ['This', 'That', 'There']);

// true

`Str::studly()`

Str::studly 方法将给定字符串转换为 StudlyCase：

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('If you like ice cream, you will like snow cones.', 'like');

// 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('Build something amazing!', 5);

// Build

`Str::title()`

Str::title 方法将给定字符串转换为 Title Case：

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::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::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('Perfectly balanced, as all things should be.', 3, ' >>>');

// Perfectly balanced, as >>>

`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('This is my name')->after('This');

// ' my name'

`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('This is my name')->before('my name');

// 'This is '

`beforeLast`

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

php

use Illuminate\Support\Str;

$slice = Str::of('This is my name')->beforeLast('is');

// 'This '

`between`

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

php

use Illuminate\Support\Str;

$converted = Str::of('This is my name')->between('This', 'name');

// ' is my '

`betweenFirst`

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

php

use Illuminate\Support\Str;

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

// 'a'

`camel`

camel 方法将给定字符串转换为 camelCase：

php

use Illuminate\Support\Str;

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

// 'fooBar'

`charAt`

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

php

use Illuminate\Support\Str;

$character = Str::of('This is my name.')->charAt(6);

// 's'

`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('This is my name')->contains('my');

// true

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

php

use Illuminate\Support\Str;

$contains = Str::of('This is my name')->contains(['my', 'foo']);

// true

您可以通过将 ignoreCase 参数设置为 true 来禁用大小写敏感性：

php

use Illuminate\Support\Str;

$contains = Str::of('This is my name')->contains('MY', ignoreCase: true);

// true

`containsAll`

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

php

use Illuminate\Support\Str;

$containsAll = Str::of('This is my name')->containsAll(['my', 'name']);

// true

您可以通过将 ignoreCase 参数设置为 true 来禁用大小写敏感性：

php

use Illuminate\Support\Str;

$containsAll = Str::of('This is my name')->containsAll(['MY', 'NAME'], ignoreCase: true);

// true

`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'

`endsWith`

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

php

use Illuminate\Support\Str;

$result = Str::of('This is my name')->endsWith('name');

// true

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

php

use Illuminate\Support\Str;

$result = Str::of('This is my name')->endsWith(['name', 'foo']);

// true

$result = Str::of('This is my name')->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('This is my name')->excerpt('my', [
    'radius' => 3
]);

// '...is my na...'

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

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

php

use Illuminate\Support\Str;

$excerpt = Str::of('This is my name')->excerpt('name', [
    'radius' => 3,
    'omission' => '(...) '
]);

// '(...) my name'

`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/

`headline`

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

php

use Illuminate\Support\Str;

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

// Taylor Otwell

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

// Email Notification Sent

`inlineMarkdown`

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

php

use Illuminate\Support\Str;

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

// <strong>Laravel</strong>

Markdown 安全性

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

php

use Illuminate\Support\Str;

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

// Inject: 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

`kebab`

kebab 方法将给定字符串转换为 kebab-case：

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('The quick brown fox jumps over the lazy dog')->limit(20);

// The quick brown fox...

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

php

$truncated = Str::of('The quick brown fox jumps over the lazy dog')->limit(20, ' (...)');

// The quick brown fox (...)

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

php

$truncated = Str::of('The quick brown fox')->limit(12, preserveWords: true);

// The quick...

`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 安全性

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

php

use Illuminate\Support\Str;

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

// <p>Inject: 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

`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!

您还可以将 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 = 'The event will take place between ? and ?';

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

// The event will take place between 8:30 and 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 方法将给定字符串转换为 snake_case：

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('This is my name')->startsWith('This');

// 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 方法将给定字符串转换为 StudlyCase：

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('Build something amazing!')->take(5);

// Build

`tap`

tap 方法将字符串传递给给定的闭包，允许您检查和与字符串交互，而不影响字符串本身。无论闭包返回什么，tap 方法都会返回原始字符串：

php

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

$string = Str::of('Laravel')
    ->append(' Framework')
    ->tap(function (Stringable $string) {
        dump('String after append: '.$string);
    })
    ->upper();

// LARAVEL FRAMEWORK

`test`

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

php

use Illuminate\Support\Str;

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

// true

`title`

title 方法将给定字符串转换为 Title Case：

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();

`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'])

`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'

如果需要，您可以将另一个闭包作为第三个参数传递给 when 方法。如果字符串不包含给定值，则将执行该闭包。

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

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'

如果需要，您可以将另一个闭包作为第三个参数传递给 when 方法。如果条件参数评估为 false，则将执行该闭包。

`whenEmpty`

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

php

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

$string = Str::of('  ')->whenEmpty(function (Stringable $string) {
    return $string->trim()->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('Perfectly balanced, as all things should be.')->words(3, ' >>>');

// Perfectly balanced, as >>>

`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::endsWith() ​

Str::excerpt() ​

Str::finish() ​

Str::headline() ​

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::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() ​

字符串

介绍

可用方法

字符串

流畅字符串

字符串

`__()`

`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::endsWith()`

`Str::excerpt()`

`Str::finish()`

`Str::headline()`

`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::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()`