字串

簡介
可用方法

簡介

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::counted 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

流暢字串 (Fluent Strings)

after afterLast apa append ascii basename before beforeLast between betweenFirst camel charAt classBasename chopStart chopEnd contains containsAll counted 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 __('Welcome to our application');

echo __('messages.welcome');

若指定的翻譯字串或金鑰不存在，__ 函數將會傳回給定的值。因此，延續上面的範例，若該翻譯金鑰不存在，__ 函數將會傳回 messages.welcome。

`class_basename()`

class_basename 函數會傳回給定類別的名稱，並移除其命名空間（Namespace）：

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 函數會使用陣列依序替換字串中符合給定模式（Pattern）的內容：

php

$string = 'The event will take place between :start and :end';

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

// The event will take place between 8:30 and 9:00

`Str::after()`

Str::after 方法會傳回字串中指定值之後的所有內容。若字串中不存在該值，則會傳回整個字串：

php

use Illuminate\Support\Str;

$slice = Str::after('This is my name', 'This is');

// ' my name'

`Str::afterLast()`

Str::afterLast 方法會傳回字串中最後一次出現指定值之後的所有內容。若字串中不存在該值，則會傳回整個字串：

php

use Illuminate\Support\Str;

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

// 'Controller'

`Str::apa()`

Str::apa 方法會遵循 APA 指南將給定的字串轉換為標題大小寫（Title Case）：

php

use Illuminate\Support\Str;

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

// 'Creating a Project'

`Str::ascii()`

Str::ascii 方法會嘗試將字串音譯（Transliterate）轉換為 ASCII 值：

php

use Illuminate\Support\Str;

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

// 'u'

`Str::before()`

Str::before 方法會傳回字串中指定值之前的所有內容：

php

use Illuminate\Support\Str;

$slice = Str::before('This is my name', 'my name');

// 'This is '

`Str::beforeLast()`

Str::beforeLast 方法會傳回字串中最後一次出現指定值之前的所有內容：

php

use Illuminate\Support\Str;

$slice = Str::beforeLast('This is my name', 'is');

// 'This '

`Str::between()`

Str::between 方法會傳回字串中介於兩個值之間的部分：

php

use Illuminate\Support\Str;

$slice = Str::between('This is my name', 'This', 'name');

// ' is my '

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

// 's'

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

// true

您也可以傳入值的陣列，來判斷給定的字串是否包含陣列中的任何一個值：

php

use Illuminate\Support\Str;

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

// true

您可以將 ignoreCase 引數設定為 true 來停用大小寫檢查：

php

use Illuminate\Support\Str;

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

// true

`Str::containsAll()`

Str::containsAll 方法用來判斷給定的字串是否包含指定陣列中的所有值：

php

use Illuminate\Support\Str;

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

// true

您可以將 ignoreCase 引數設定為 true 來停用大小寫檢查：

php

use Illuminate\Support\Str;

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

// true

`Str::doesntContain()`

Str::doesntContain 方法用來判斷給定的字串是否不包含指定的值。預設情況下，此方法會區分大小寫：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('This is name', 'my');

// true

您也可以傳入值的陣列，來判斷給定的字串是否不包含陣列中的任何一個值：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('This is name', ['my', 'framework']);

// true

您可以將 ignoreCase 引數設定為 true 來停用大小寫檢查：

php

use Illuminate\Support\Str;

$doesntContain = Str::doesntContain('This is name', '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('This is my name', 'dog');

// true

您也可以傳入一個包含多個值的陣列，來判斷指定的字串是否不以陣列中的任何一個值結尾：

php

use Illuminate\Support\Str;

$result = Str::doesntEndWith('This is my name', ['this', 'foo']);

// true

$result = Str::doesntEndWith('This is my name', ['name', 'foo']);

// false

`Str::doesntStartWith()`

Str::doesntStartWith 方法用於判斷指定的字串是否不以給定的值開頭：

php

use Illuminate\Support\Str;

$result = Str::doesntStartWith('This is my name', 'That');

// true

若傳入一個包含可能值的陣列，當字串不以任何給定的值開頭時，doesntStartWith 方法將回傳 true：

php

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

// true

`Str::endsWith()`

Str::endsWith 方法用於判斷指定的字串是否以給定的值結尾：

php

use Illuminate\Support\Str;

$result = Str::endsWith('This is my name', 'name');

// true

您也可以傳入一個包含多個值的陣列，來判斷指定的字串是否以陣列中的任何一個值結尾：

php

use Illuminate\Support\Str;

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

// true

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

// false

`Str::excerpt()`

Str::excerpt 方法會從給定的字串中，擷取與該字串中首次出現的片語相匹配的摘要片段：

php

use Illuminate\Support\Str;

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

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

radius 選項的預設值為 100，允許您定義截斷字串兩側應顯示的字元數量。

此外，您還可以使用 omission 選項來定義要在截斷字串的前後附加的字串：

php

use Illuminate\Support\Str;

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

// '(...) my name'

`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 包裹在區塊級元素 (block-level element) 中：

php

use Illuminate\Support\Str;

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

// <strong>Laravel</strong>

Markdown 安全性

預設情況下，Markdown 支援原始 HTML，當與未經處理的使用者輸入一起使用時，將暴露跨網站指令碼 (XSS) 漏洞。根據 CommonMark 安全性文件，您可以使用 html_input 選項來轉義 (escape) 或剝離 (strip) 原始 HTML，並使用 allow_unsafe_links 選項來指定是否允許不安全的連結。如果您需要允許某些原始 HTML，應該將編譯後的 Markdown 傳送至 HTML 清理工具 (HTML Purifier)：

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

您也可以驗證給定的 UUID 是否符合特定版本的 UUID 規格（1、3、4、5、6、7 或 8）：

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 方法將給定的字串轉換為 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('The quick brown fox jumps over the lazy dog', 20);

// The quick brown fox...

您可以傳遞第三個引數給此方法，以變更要附加在截斷字串末端的字串：

php

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

// The quick brown fox (...)

如果您想在截斷字串時保留完整的單字，可以使用 preserveWords 引數。當此引數為 true 時，字串將會被截斷至最接近的完整單字邊界：

php

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

// The quick...

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

預設情況下，Markdown 支援原生 HTML，當與未經處理的使用者輸入一起使用時，這會暴露跨網站指令碼 (XSS) 漏洞。根據 CommonMark 安全性文件，您可以使用 html_input 選項來轉義 (escape) 或剝離 (strip) 原生 HTML，並使用 allow_unsafe_links 選項來指定是否允許不安全的連結。如果您需要允許某些原生 HTML，您應該將編譯後的 Markdown 通過 HTML 淨化器 (HTML Purifier)：

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('[email protected]', '*', 3);

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

如果需要，您可以傳遞一個負數作為 mask 方法的第三個引數，這會指示該方法從字串末端指定的距離開始進行遮蔽：

php

$string = Str::mask('[email protected]', '*', -15, 3);

// tay***@example.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'])

如果您在運算式中指定了比對分組 (matching group)，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 方法會生成一個「時間戳記優先 (timestamp first)」的 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::counted()`

Str::counted 方法會根據給定的數量將單數形式的單字字串轉換為單數或複數形式，並在結果前加上格式化後的數量：

php

use Illuminate\Support\Str;

$label = Str::counted('order', 1);

// 1 order

$label = Str::counted('order', 1000);

// 1,000 orders

`Str::plural()`

Str::plural 方法將單字字串轉換為其複數形式。此函式支援 Laravel 複數化工具 (Pluralizer) 支援的任何語言：

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 方法將以 StudlyCaps (大駝峰) 格式命名的單字字串轉換為其複數形式。此函式支援 Laravel 複數化工具 (Pluralizer) 支援的任何語言：

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

在測試期間，「偽造 (Fake)」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 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 = '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 方法也接受一個閉包 (Closure)，該閉包將傳入符合給定模式的每個字串部分並被呼叫，讓您可以在閉包內執行替換邏輯並傳回替換後的值：

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 複數化工具 (Pluralizer) 支援的任何語言：

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('ⓣⓔⓢⓣ@ⓛⓐⓡⓐⓥⓔⓛ.ⓒⓞⓜ');

// '[email protected]'

`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 (version 4)：

php

use Illuminate\Support\Str;

return (string) Str::uuid();

在測試期間，「偽造 (fake)」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 (version 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('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 函式會翻譯給定的翻譯鍵並支援單複數轉換 (inflection)：

php

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

如果指定的翻譯鍵不存在，trans_choice 函式將傳回給定的翻譯鍵。因此，使用上述範例，如果該翻譯鍵不存在，trans_choice 函式將傳回 messages.notifications。

流暢字串 (Fluent Strings)

流暢字串 (Fluent strings) 為處理字串值提供了一個更加流暢、物件導向的介面，與傳統的字串操作相比，它允許您使用更具可讀性的語法將多個字串操作鏈結 (chain) 在一起。

`after`

after 方法會傳回字串中指定值之後的所有內容。若該值不存在於字串中，則會傳回整個字串：

php

use Illuminate\Support\Str;

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

// ' my name'

`afterLast`

afterLast 方法會傳回字串中最後一次出現指定值之後的所有內容。若該值不存在於字串中，則會傳回整個字串：

php

use Illuminate\Support\Str;

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

// 'Controller'

`apa`

apa 方法會遵循 APA 指南將給定的字串轉換為標題大小寫 (Title Case)：

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 方法將嘗試將字串音譯 (transliterate) 為 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 方法會傳回指定類別的類別名稱，並移除該類別的命名空間 (Namespace)：

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

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

// true

您也可以傳入一個陣列，以判斷給定字串是否不包含該陣列中的任何數值：

php

use Illuminate\Support\Str;

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

// true

您可以將 ignoreCase 參數設定為 true 來停用大小寫敏感度：

php

use Illuminate\Support\Str;

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

// false

`doesntEndWith`

doesntEndWith 方法用於判斷給定字串是否不以給定數值結尾：

php

use Illuminate\Support\Str;

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

// true

您也可以傳入一個陣列，以判斷給定字串是否不以該陣列中的任何數值結尾：

php

use Illuminate\Support\Str;

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

// true

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

// false

`doesntStartWith`

doesntStartWith 方法用於判斷給定字串是否不以給定數值開頭：

php

use Illuminate\Support\Str;

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

// true

您也可以傳入一個陣列，以判斷給定字串是否不以該陣列中的任何數值開頭：

php

use Illuminate\Support\Str;

$result = Str::of('This is my name')->doesntStartWith(['What', 'That', 'There']);

// 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('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/

`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 包裹在區塊級元素 (block-level element) 中：

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，您應該將編譯後的 Markdown 傳入 HTML 清理器 (HTML Purifier)：

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

您也可以驗證給定的 UUID 是否符合特定版本的 UUID 規範（1、3、4、5、6、7 或 8）：

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 方法將給定的字串轉換為 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，您應該將編譯後的 Markdown 送交 HTML 淨化器 (HTML Purifier) 處理：

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 方法使用重複的字元遮蔽字串的一部分，可用於混淆 Email 地址和電話號碼等字串片段：

php

use Illuminate\Support\Str;

$string = Str::of('[email protected]')->mask('*', 3);

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

如有需要，您可以為 mask 方法的第三或第四個引數傳入負數，這將指示該方法從距離字串末尾指定的長度開始遮蔽：

php

$string = Str::of('[email protected]')->mask('*', -15, 3);

// tay***@example.com

$string = Str::of('[email protected]')->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 方法允許您將字串的當前值傳遞給給定的 Callable 以轉換該字串：

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'

`counted`

counted 方法根據給定的數量將單數形式的單字字串轉換為單數或複數形式，並在結果前面加上格式化後的數量：

php

use Illuminate\Support\Str;

$label = Str::of('order')->counted(1);

// 1 order

$label = Str::of('order')->counted(1000);

// 1,000 orders

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

您還可以傳入 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

您也可以傳入一個包含多個值的陣列，來判斷該字串是否以陣列中的任何一個值開頭：

php

use Illuminate\Support\Str;

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

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

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

// '[email protected]'

`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 方法會依據大寫字元將給定的字串拆分成 Collection：

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('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!

字串 ​

簡介 ​

可用方法 ​

字串 ​

流暢字串 (Fluent Strings) ​

字串 ​

__() ​

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

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

字串

簡介

可用方法

字串

流暢字串 (Fluent Strings)

字串

`__()`

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

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