버전: 11.x

문자열 (Strings)

소개
사용 가능한 메서드

소개

라라벨은 문자열 값을 다루는 다양한 함수들을 제공합니다. 이 함수들 중 상당수는 라라벨 프레임워크 내부에서 사용되지만, 필요하다면 여러분의 애플리케이션에서도 자유롭게 활용할 수 있습니다.

사용 가능한 메서드

Fluent 문자열 메서드

after afterLast apa append ascii basename before beforeLast between betweenFirst camel charAt classBasename chopStart chopEnd contains containsAll deduplicate dirname endsWith exactly excerpt explode finish headline 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 transliterate trim ltrim rtrim ucfirst ucsplit unwrap upper when whenContains whenContainsAll whenEmpty whenNotEmpty whenStartsWith whenEndsWith whenExactly whenNotExactly whenIs whenIsAscii whenIsUlid whenIsUuid whenTest wordCount words wrap

문자열

`__()`

__ 함수는 언어 파일을 사용하여 지정된 번역 문자열 또는 번역 키를 번역합니다.

echo __('Welcome to our application');

echo __('messages.welcome');

만약 지정한 번역 문자열이나 키가 존재하지 않을 경우, __ 함수는 전달한 값을 그대로 반환합니다. 즉, 위 예시에서 해당 번역 키가 존재하지 않으면 __ 함수는 messages.welcome을 반환하게 됩니다.

`class_basename()`

class_basename 함수는 주어진 클래스에서 네임스페이스를 제거한 클래스명만 반환합니다.

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

// Baz

`e()`

e 함수는 PHP의 htmlspecialchars 함수를 실행하는데, 이때 double_encode 옵션이 기본적으로 true로 설정되어 있습니다.

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

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

`preg_replace_array()`

preg_replace_array 함수는 문자열에서 특정 패턴을 찾아 배열에 있는 값들로 순차적으로 대체합니다.

$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 메서드는 문자열에서 지정한 값 뒤에 있는 모든 내용을 반환합니다. 만약 해당 값이 문자열에 없다면 전체 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// ' my name'

`Str::afterLast()`

Str::afterLast 메서드는 문자열에서 주어진 값이 마지막으로 등장한 이후의 모든 내용을 반환합니다. 만약 해당 값이 문자열에 없다면 전체 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// 'Controller'

`Str::apa()`

Str::apa 메서드는 주어진 문자열을 APA 가이드라인에 따라 타이틀 케이스(Title Case)로 변환합니다.

use Illuminate\Support\Str;

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

// 'Creating a Project'

`Str::ascii()`

Str::ascii 메서드는 문자열을 ASCII로 변환(음역/전각→반각)하려고 시도합니다.

use Illuminate\Support\Str;

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

// 'u'

`Str::before()`

Str::before 메서드는 문자열에서 지정한 값이 시작되기 전까지의 모든 내용을 반환합니다.

use Illuminate\Support\Str;

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

// 'This is '

`Str::beforeLast()`

Str::beforeLast 메서드는 문자열에서 지정한 값이 마지막으로 등장하기 전까지의 모든 내용을 반환합니다.

use Illuminate\Support\Str;

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

// 'This '

`Str::between()`

Str::between 메서드는 두 값 사이에 위치한 문자열의 일부를 반환합니다.

use Illuminate\Support\Str;

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

// ' is my '

`Str::betweenFirst()`

Str::betweenFirst 메서드는 두 값 사이 가운데 가장 짧게 해당되는(처음 나오는) 문자열의 일부를 반환합니다.

use Illuminate\Support\Str;

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

// 'a'

`Str::camel()`

Str::camel 메서드는 주어진 문자열을 camelCase 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// 'fooBar'

`Str::charAt()`

Str::charAt 메서드는 지정한 인덱스(위치)의 문자를 반환합니다. 만약 인덱스가 범위를 벗어나면 false를 반환합니다.

use Illuminate\Support\Str;

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

// 's'

`Str::chopStart()`

Str::chopStart 메서드는 주어진 값이 문자열의 시작 부분에 있을 때 한 번만 해당 값을 제거합니다.

use Illuminate\Support\Str;

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

// 'laravel.com'

두 번째 인수로 배열을 전달할 수도 있습니다. 이 경우, 배열에 포함된 값 중 하나라도 문자열의 시작에 있으면 해당 값을 제거합니다.

use Illuminate\Support\Str;

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

// 'laravel.com'

`Str::chopEnd()`

Str::chopEnd 메서드는 주어진 값이 문자열의 끝에 있을 때 한 번만 해당 값을 제거합니다.

use Illuminate\Support\Str;

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

// 'app/Models/Photograph'

두 번째 인수로 배열을 전달할 수도 있습니다. 이 경우, 배열의 값 중 하나라도 문자열의 끝에 있다면 해당 값을 제거합니다.

use Illuminate\Support\Str;

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

// 'laravel.com'

`Str::contains()`

Str::contains 메서드는 지정한 문자열이 주어진 값(부분 문자열)을 포함하고 있는지 확인합니다. 기본적으로 대소문자를 구분합니다.

use Illuminate\Support\Str;

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

// true

배열 형태로 값들을 전달하면, 주어진 문자열이 배열 내 값들 중 하나라도 포함하고 있는지 확인할 수 있습니다.

use Illuminate\Support\Str;

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

// true

대소문자를 무시하고 비교하려면 ignoreCase 인수를 true로 설정하면 됩니다.

use Illuminate\Support\Str;

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

// true

`Str::containsAll()`

Str::containsAll 메서드는 주어진 문자열이 배열에 있는 모든 값을 포함하는지 확인합니다.

use Illuminate\Support\Str;

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

// true

대소문자를 무시하고 비교하려면 ignoreCase 인수를 true로 설정하면 됩니다.

use Illuminate\Support\Str;

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

// true

`Str::doesntContain()`

Str::doesntContain 메서드는 주어진 문자열이 특정 값을 포함하지 않는지 확인합니다. 기본적으로 대소문자를 구분합니다.

use Illuminate\Support\Str;

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

// true

배열 형태로 값들을 전달하면, 주어진 문자열이 배열 내의 값들 중 어느 것도 포함하고 있지 않은지 확인할 수 있습니다.

use Illuminate\Support\Str;

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

// true

대소문자를 무시하고 비교하려면 ignoreCase 인수를 true로 설정하면 됩니다.

use Illuminate\Support\Str;

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

// true

`Str::deduplicate()`

Str::deduplicate 메서드는 주어진 문자열에서 연속적으로 반복되는 특정 문자를 한 번만 남기고 모두 제거합니다. 기본적으로 공백(스페이스)을 대상으로 동작합니다.

use Illuminate\Support\Str;

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

// The Laravel Framework

두 번째 인수로 다른 문자를 지정하여 해당 문자에 대해 중복 제거를 수행할 수도 있습니다.

use Illuminate\Support\Str;

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

// The-Laravel-Framework

`Str::endsWith()`

Str::endsWith 메서드는 주어진 문자열이 특정 값으로 끝나는지를 확인합니다.

use Illuminate\Support\Str;

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

// true

여러 값을 배열로 전달하여, 주어진 문자열이 배열 안의 값 중 하나로 끝나는지도 확인할 수 있습니다.

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 메서드는 지정한 문자열 내부에서 특정 구문(문구)이 처음 나타나는 위치를 기준으로, 해당 부분을 포함한 발췌(일부 문자열)를 추출합니다.

use Illuminate\Support\Str;

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

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

radius 옵션(기본값은 100)을 사용하면, 잘려진 문자열 양쪽에 남길 문자 수를 지정할 수 있습니다.

또한, omission 옵션을 사용하면 잘려진 문자열 앞뒤에 붙일 문자열을 정의할 수 있습니다.

use Illuminate\Support\Str;

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

// '(...) my name'

`Str::finish()`

Str::finish 메서드는 주어진 문자열이 특정 값으로 끝나지 않을 경우, 해당 값을 문자열 끝에 단 한 번만 추가합니다.

use Illuminate\Support\Str;

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

// this/string/

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

// this/string/

`Str::headline()`

Str::headline 메서드는 대소문자, 하이픈(-), 밑줄(_)로 구분된 문자열을, 각 단어의 첫 글자가 대문자인 공백 구분 문자열로 변환합니다.

use Illuminate\Support\Str;

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

// Steve Jobs

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

// Email Notification Sent

`Str::inlineMarkdown()`

Str::inlineMarkdown 메서드는 GitHub 마크다운 구문을 CommonMark를 이용하여 인라인 HTML로 변환합니다. 다만, markdown 메서드와 달리 생성된 HTML 전체를 블록 요소로 감싸지 않습니다.

use Illuminate\Support\Str;

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

// <strong>Laravel</strong>

마크다운 보안

기본적으로 마크다운은 원시(HTML) 코드를 허용하므로, 사용자 입력을 그대로 사용할 경우 XSS(크로스 사이트 스크립팅) 취약점에 노출될 수 있습니다. CommonMark 보안 문서에 따르면, html_input 옵션을 사용하여 원시 HTML을 escape(이스케이프)하거나 제거할 수 있으며, allow_unsafe_links 옵션으로 안전하지 않은 링크 허용 여부를 지정할 수 있습니다. 만약 일부 원시 HTML을 허용해야 한다면, 변환된 마크다운을 HTML Purifier와 같은 필터를 통해 추가로 검증하는 것이 안전합니다.

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 메서드는 주어진 문자열이 지정한 패턴과 일치하는지 확인합니다. 이때 * (애스터리스크)는 와일드카드(임의 문자)로 사용할 수 있습니다.

use Illuminate\Support\Str;

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

// true

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

// false

대소문자 구분을 끄고 비교하려면 ignoreCase 인수를 true로 설정하면 됩니다.

use Illuminate\Support\Str;

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

// true

`Str::isAscii()`

Str::isAscii 메서드는 주어진 문자열이 7비트 ASCII(아스키) 문자인지 확인합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`Str::isJson()`

Str::isJson 메서드는 주어진 문자열이 올바른 JSON 형식인지 확인합니다.

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 형식인지 확인합니다.

use Illuminate\Support\Str;

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

// true

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

// false

isUrl 메서드는 다양한 프로토콜을 유효한 것으로 간주합니다. 다만, 유효하다고 판단할 프로토콜을 직접 지정할 수도 있습니다.

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

`Str::isUlid()`

Str::isUlid 메서드는 주어진 문자열이 유효한 ULID 형식인지 확인합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`Str::isUuid()`

Str::isUuid 메서드는 주어진 문자열이 올바른 UUID 형식인지 확인합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`Str::kebab()`

Str::kebab 메서드는 주어진 문자열을 kebab-case 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// foo-bar

`Str::lcfirst()`

Str::lcfirst 메서드는 주어진 문자열의 첫 글자를 소문자로 변환하여 반환합니다.

use Illuminate\Support\Str;

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

// foo Bar

`Str::length()`

Str::length 메서드는 주어진 문자열의 길이를 반환합니다.

use Illuminate\Support\Str;

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

// 7

`Str::limit()`

Str::limit 메서드는 주어진 문자열을 지정한 길이만큼만 잘라 반환합니다.

use Illuminate\Support\Str;

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

// The quick brown fox...

잘린 문자열 끝에 붙는 내용을 변경하고 싶다면, 세 번째 인수로 원하는 문자열을 전달할 수 있습니다.

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

// The quick brown fox (...)

단어 전체를 유지하면서 잘라내고 싶다면, preserveWords 인수를 true로 지정합니다. 이 경우, 문자열은 가능한 한 단어 경계를 기준으로 잘립니다.

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

// The quick...

`Str::lower()`

Str::lower 메서드는 주어진 문자열을 모두 소문자로 변환합니다.

use Illuminate\Support\Str;

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

// laravel

`Str::markdown()`

Str::markdown 메서드는 GitHub 마크다운 구문을 CommonMark를 이용하여 HTML로 변환합니다.

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>

마크다운 보안

기본적으로 마크다운은 원시(HTML) 코드를 허용하므로, 사용자 입력을 사용할 때에는 XSS(크로스 사이트 스크립팅) 취약점에 주의해야 합니다. CommonMark 보안 문서에 따르면, html_input 옵션을 사용하여 원시 HTML을 escape(이스케이프)하거나 제거할 수 있으며, allow_unsafe_links 옵션을 통해 안전하지 않은 링크 허용 여부를 지정할 수 있습니다. 만약 일부 원시 HTML을 허용해야 한다면, 마크다운 결과물을 HTML Purifier와 같은 필터로 추가 검증하는 것이 안전합니다.

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 메서드는 문자열 일부를 특정 문자를 반복해서 덮어씌워, 이메일 주소나 전화번호 등 민감 정보 일부를 숨기는 데 사용할 수 있습니다.

use Illuminate\Support\Str;

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

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

필요하다면, 세 번째 인수에 음수 값을 전달하여 문자열 끝에서부터 지정한 거리에서 마스킹을 시작할 수도 있습니다.

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

// tay***@example.com

`Str::orderedUuid()`

Str::orderedUuid 메서드는 "타임스탬프 우선" 방식의 UUID를 생성합니다. 이렇게 생성한 값은 인덱스가 지정된 데이터베이스 컬럼에 효율적으로 저장할 수 있으며, 이전에 생성된 UUID보다 항상 뒤에 정렬됩니다.

use Illuminate\Support\Str;

return (string) Str::orderedUuid();

`Str::padBoth()`

Str::padBoth 메서드는 PHP의 str_pad 함수를 감싸서, 지정한 문자열 양쪽에 다른 문자열(채우기 문자열)을 반복해서 붙여 원하는 길이에 도달할 때까지 확장합니다.

use Illuminate\Support\Str;

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

// '__James___'

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

// '  James   '

`Str::padLeft()`

Str::padLeft 메서드는 PHP의 str_pad 함수를 감싸서, 문자열의 왼쪽에 다른 문자열로 원하는 길이에 도달할 때까지 확장합니다.

use Illuminate\Support\Str;

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

// '-=-=-James'

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

// '     James'

`Str::padRight()`

Str::padRight 메서드는 PHP의 str_pad 함수를 감싸서, 문자열의 오른쪽에 다른 문자열로 원하는 길이에 도달할 때까지 확장합니다.

use Illuminate\Support\Str;

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

// 'James-----'

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

// 'James     '

`Str::password()`

Str::password 메서드는 원하는 길이의 보안성이 높은 무작위 비밀번호를 생성합니다. 비밀번호는 문자, 숫자, 특수문자, 공백 등을 조합하여 만들어지며, 기본적으로 32자 길이의 문자열을 생성합니다.

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 메서드는 단어의 단수 형태의 문자열을 복수형으로 변환합니다. 이 기능은 라라벨의 복수화 기능이 지원하는 모든 언어를 지원합니다.

use Illuminate\Support\Str;

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

// cars

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

// children

두 번째 인수로 정수를 입력하면, 해당 값이 1이면 단수형을, 1이 아니면 복수형을 반환합니다.

use Illuminate\Support\Str;

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

// children

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

// child

`Str::pluralStudly()`

Str::pluralStudly 메서드는 Studly Case(각 단어의 첫 글자만 대문자인 형태)로 작성된 단어를 복수형으로 변환합니다. 이 기능 역시 라라벨의 복수화 기능이 지원하는 모든 언어를 지원합니다.

use Illuminate\Support\Str;

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

// VerifiedHumans

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

// UserFeedback

두 번째 인수로 정수를 입력하면, 해당 값이 1이면 단수형을, 1이 아니면 복수형을 반환합니다.

use Illuminate\Support\Str;

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

// VerifiedHumans

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

// VerifiedHuman

`Str::position()`

Str::position 메서드는 문자열 안에서 특정 부분 문자열이 처음 나타나는 위치(인덱스)를 반환합니다. 만약 부분 문자열이 존재하지 않으면, false를 반환합니다.

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 함수를 사용합니다.

use Illuminate\Support\Str;

$random = Str::random(40);

테스트 중에는, Str::random 메서드가 반환하는 값을 "가짜" 값으로 설정하면 도움이 될 수 있습니다. 이를 위해 createRandomStringsUsing 메서드를 사용할 수 있습니다.

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

random 메서드가 다시 원래대로 무작위 값을 생성하도록 하려면, createRandomStringsNormally 메서드를 호출하면 됩니다.

Str::createRandomStringsNormally();

`Str::remove()`

Str::remove 메서드는 주어진 값 또는 값들의 배열을 문자열에서 제거합니다.

use Illuminate\Support\Str;

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

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

// Ptr Pipr pickd a pck of pickld ppprs.

또한 remove 메서드의 세 번째 인수로 false를 전달하여, 문자열을 제거할 때 대소문자를 구분하지 않도록 설정할 수 있습니다.

`Str::repeat()`

Str::repeat 메서드는 주어진 문자열을 반복하여 반환합니다.

use Illuminate\Support\Str;

$string = 'a';

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

// aaaaa

`Str::replace()`

Str::replace 메서드는 문자열 내에 지정한 값을 다른 값으로 대체합니다.

use Illuminate\Support\Str;

$string = 'Laravel 10.x';

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

// Laravel 11.x

replace 메서드는 caseSensitive 인수도 받을 수 있습니다. 기본적으로 replace 메서드는 대소문자를 구분하여 동작합니다.

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

`Str::replaceArray()`

Str::replaceArray 메서드는 배열을 이용하여 문자열 내의 지정한 값을 순서대로 교체합니다.

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 메서드는 문자열에서 지정한 값이 처음 등장하는 부분만 새로운 값으로 대체합니다.

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 메서드는 문자열에서 지정한 값이 마지막으로 등장하는 부분만 새로운 값으로 대체합니다.

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 메서드는 주어진 패턴과 일치하는 문자열의 모든 부분을 지정한 문자로 대체합니다.

use Illuminate\Support\Str;

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

// '15015551000'

replaceMatches 메서드는 또한 패턴과 일치하는 각 부분에 대해 호출되는 클로저를 인수로 받을 수 있으며, 클로저 내에서 교체 로직을 정의하고 반환값을 지정할 수 있습니다.

use Illuminate\Support\Str;

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

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

`Str::replaceStart()`

Str::replaceStart 메서드는 지정한 값이 문자열 처음에 등장할 경우에만 그 부분을 새로운 값으로 대체합니다.

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 메서드는 지정한 값이 문자열 마지막에 등장할 경우에만 그 부분을 새로운 값으로 대체합니다.

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 메서드는 주어진 문자열의 글자 순서를 뒤집어 반환합니다.

use Illuminate\Support\Str;

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

// dlroW olleH

`Str::singular()`

Str::singular 메서드는 문자열을 단수형으로 변환합니다. 이 함수는 라라벨의 복수화 플러리저가 지원하는 모든 언어를 지원합니다.

use Illuminate\Support\Str;

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

// car

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

// child

`Str::slug()`

Str::slug 메서드는 주어진 문자열을 URL에 사용하기 적합한 "슬러그(slug)" 형태로 변환합니다.

use Illuminate\Support\Str;

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

// laravel-5-framework

`Str::snake()`

Str::snake 메서드는 주어진 문자열을 snake_case 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// foo_bar

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

// foo-bar

`Str::squish()`

Str::squish 메서드는 문자열 내에 불필요하게 여러 번 들어간 공백(띄어쓰기 포함)을 모두 제거하고, 단어 사이의 공백도 하나만 남기도록 정리합니다.

use Illuminate\Support\Str;

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

// laravel framework

`Str::start()`

Str::start 메서드는 문자열이 지정한 값으로 시작하지 않을 경우, 해당 값을 문자열 앞에 한 번만 추가합니다.

use Illuminate\Support\Str;

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

// /this/string

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

// /this/string

`Str::startsWith()`

Str::startsWith 메서드는 주어진 문자열이 특정 값으로 시작하는지 판단합니다.

use Illuminate\Support\Str;

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

// true

값을 여러 개 담은 배열을 전달하면, 문자열이 배열 내 값 중 하나로 시작할 경우 startsWith는 true를 반환합니다.

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

// true

`Str::studly()`

Str::studly 메서드는 주어진 문자열을 StudlyCase(낙타표기 대문자) 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// FooBar

`Str::substr()`

Str::substr 메서드는 시작 위치와 길이를 지정하여, 해당 구간의 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// Laravel

`Str::substrCount()`

Str::substrCount 메서드는 문자열 내에 지정한 값이 몇 번 등장하는지 횟수를 반환합니다.

use Illuminate\Support\Str;

$count = Str::substrCount('If you like ice cream, you will like snow cones.', 'like');

// 2

`Str::substrReplace()`

Str::substrReplace 메서드는 세 번째 인수로 지정된 위치에서 시작하여, 네 번째 인수로 지정한 개수만큼의 문자를 주어진 값으로 교체합니다. 네 번째 인수로 0을 전달하면, 기존 문자열은 손대지 않고 해당 위치에 값을 삽입합니다.

use Illuminate\Support\Str;

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

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

`Str::swap()`

Str::swap 메서드는 PHP의 strtr 함수를 이용하여, 여러 가지 값을 한 번에 교체합니다.

use Illuminate\Support\Str;

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

// Burritos are fantastic!

`Str::take()`

Str::take 메서드는 문자열의 앞에서부터 지정한 개수만큼의 문자를 반환합니다.

use Illuminate\Support\Str;

$taken = Str::take('Build something amazing!', 5);

// Build

`Str::title()`

Str::title 메서드는 주어진 문자열을 Title Case(각 단어의 첫 글자를 대문자로)로 변환합니다.

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로 인코딩합니다.

use Illuminate\Support\Str;

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

// TGFyYXZlbA==

`Str::transliterate()`

Str::transliterate 메서드는 주어진 문자열을 가장 가까운 ASCII 문자로 변환합니다.

use Illuminate\Support\Str;

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

// '[email protected]'

`Str::trim()`

Str::trim 메서드는 문자열의 앞과 뒤에 있는 공백(또는 다른 지정한 문자)을 제거합니다. PHP의 기본 trim 함수와 달리, Str::trim은 유니코드 공백 문자도 함께 제거합니다.

use Illuminate\Support\Str;

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

// 'foo bar'

`Str::ltrim()`

Str::ltrim 메서드는 문자열 시작 부분의 공백(또는 지정한 문자)을 제거합니다. PHP의 기본 ltrim 함수와 달리, Str::ltrim은 유니코드 공백 문자도 제거합니다.

use Illuminate\Support\Str;

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

// 'foo bar  '

`Str::rtrim()`

Str::rtrim 메서드는 문자열 끝부분에서 공백(또는 지정한 문자)을 제거합니다. PHP의 기본 rtrim 함수와 달리, Str::rtrim은 유니코드 공백 문자도 함께 제거합니다.

use Illuminate\Support\Str;

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

// '  foo bar'

`Str::ucfirst()`

Str::ucfirst 메서드는 주어진 문자열의 첫 글자를 대문자로 변환해서 반환합니다.

use Illuminate\Support\Str;

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

// Foo bar

`Str::ucsplit()`

Str::ucsplit 메서드는 대문자 기준으로 문자열을 분할해서 배열로 반환합니다.

use Illuminate\Support\Str;

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

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

`Str::upper()`

Str::upper 메서드는 주어진 문자열을 모두 대문자로 변환합니다.

use Illuminate\Support\Str;

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

// LARAVEL

`Str::ulid()`

Str::ulid 메서드는 ULID(Compact, 시간순으로 정렬되는 고유 식별자)를 생성합니다.

use Illuminate\Support\Str;

return (string) Str::ulid();

// 01gd6r360bp37zj17nxb55yv40

주어진 ULID가 생성된 일시를 나타내는 Illuminate\Support\Carbon 날짜 인스턴스가 필요하다면, 라라벨의 Carbon 통합에서 제공하는 createFromId 메서드를 사용할 수 있습니다.

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

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

테스트 시 Str::ulid 메서드가 반환하는 값을 임의로 지정(페이크) 하고 싶다면, createUlidsUsing 메서드를 사용할 수 있습니다.

use Symfony\Component\Uid\Ulid;

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

ULID를 다시 정상적으로 자동 생성 방식으로 돌리려면, createUlidsNormally 메서드를 호출하면 됩니다.

Str::createUlidsNormally();

`Str::unwrap()`

Str::unwrap 메서드는 주어진 문자열의 시작과 끝에서 지정된 값을 제거합니다.

use Illuminate\Support\Str;

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

// Laravel

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

// framework: "Laravel"

`Str::uuid()`

Str::uuid 메서드는 UUID(버전 4)를 생성합니다.

use Illuminate\Support\Str;

return (string) Str::uuid();

테스트 시 Str::uuid 메서드가 반환하는 값을 임의로 지정하고 싶다면, createUuidsUsing 메서드를 사용할 수 있습니다.

use Ramsey\Uuid\Uuid;

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

UUID를 다시 정상적으로 자동 생성 방식으로 돌리려면, createUuidsNormally 메서드를 호출하면 됩니다.

Str::createUuidsNormally();

`Str::wordCount()`

Str::wordCount 메서드는 문자열이 포함하고 있는 단어의 개수를 반환합니다.

use Illuminate\Support\Str;

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

`Str::wordWrap()`

Str::wordWrap 메서드는 문자열을 지정한 글자 수에 맞춰 줄바꿈합니다.

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 메서드는 문자열의 단어 수를 제한합니다. 세 번째 인수로 추가 문자열을 전달하여, 잘린 문자열 끝에 어떤 문자열을 붙일지 지정할 수 있습니다.

use Illuminate\Support\Str;

return Str::words('Perfectly balanced, as all things should be.', 3, ' >>>');

// Perfectly balanced, as >>>

`Str::wrap()`

Str::wrap 메서드는 지정한 문자열(또는 문자열 쌍)로 주어진 문자열을 감쌉니다.

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 메서드와 동일합니다.

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

// 'Taylor Otwell'

만약 str 함수에 인수를 전달하지 않으면, Illuminate\Support\Str의 인스턴스를 반환합니다.

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

// 'foo_bar'

`trans()`

trans 함수는 지정한 번역 키를 사용해서 언어 파일의 내용을 번역합니다.

echo trans('messages.welcome');

지정한 번역 키가 존재하지 않으면, trans 함수는 전달된 키를 그대로 반환합니다. 따라서 위 예시에서 해당 번역 키가 없으면 messages.welcome이 반환됩니다.

`trans_choice()`

trans_choice 함수는 지정한 번역 키를 단수/복수 형태에 따라 번역합니다.

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

지정한 번역 키가 존재하지 않으면, trans_choice 함수는 전달된 키를 그대로 반환합니다. 따라서 위 예시에서 해당 번역 키가 없으면 messages.notifications가 반환됩니다.

플루언트 문자열(Fluent Strings)

플루언트 문자열은 문자열 값을 다룰 때 좀 더 읽기 쉽고, 체이닝이 가능한 객체 지향적 인터페이스를 제공합니다. 전통적인 문자열 함수보다 가독성이 높고, 여러 문자열 조작을 연속적으로 연결해 쓸 수 있습니다.

`after`

after 메서드는 주어진 값 이후에 오는 모든 문자열을 반환합니다. 만약 그 값이 문자열에 없으면 전체 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// ' my name'

`afterLast`

afterLast 메서드는 주어진 값이 문자열에 마지막으로 등장한 이후의 모든 문자열을 반환합니다. 만약 그 값이 문자열에 없으면 전체 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// 'Controller'

`apa`

apa 메서드는 APA 스타일 가이드라인에 따라 문자열을 타이틀 케이스로 변환합니다.

use Illuminate\Support\Str;

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

// A Nice Title Uses the Correct Case

`append`

append 메서드는 전달한 값을 문자열 끝에 이어붙입니다.

use Illuminate\Support\Str;

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

// 'Taylor Otwell'

`ascii`

ascii 메서드는 문자열을 가능한 한 ASCII 문자로 변환(음역)합니다.

use Illuminate\Support\Str;

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

// 'u'

`basename`

basename 메서드는 주어진 문자열의 마지막 이름 부분(파일/디렉터리명 등)만 반환합니다.

use Illuminate\Support\Str;

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

// 'baz'

필요하다면 확장자를 지정하여 마지막 위치에서 확장자를 제거할 수도 있습니다.

use Illuminate\Support\Str;

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

// 'baz'

`before`

before 메서드는 주어진 값 앞까지의 모든 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// 'This is '

`beforeLast`

beforeLast 메서드는 주어진 값이 마지막으로 등장하기 전까지의 모든 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// 'This '

`between`

between 메서드는 두 값 사이에 있는 부분 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// ' is my '

`betweenFirst`

betweenFirst 메서드는 두 값 사이에서 가장 짧게 끊을 수 있는 부분 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// 'a'

`camel`

camel 메서드는 주어진 문자열을 camelCase 형태로 변환합니다.

use Illuminate\Support\Str;

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

// 'fooBar'

`charAt`

charAt 메서드는 지정한 인덱스의 문자를 반환합니다. 만약 인덱스가 범위를 벗어났을 경우 false를 반환합니다.

use Illuminate\Support\Str;

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

// 's'

`classBasename`

classBasename 메서드는 지정한 클래스 문자열에서 네임스페이스를 제거하고 클래스명만 반환합니다.

use Illuminate\Support\Str;

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

// 'Baz'

`chopStart`

chopStart 메서드는 주어진 값이 문자열의 시작 부분에 있을 경우, 처음 등장하는 값만 잘라냅니다.

use Illuminate\Support\Str;

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

// 'laravel.com'

배열을 전달하여 여러 값 중 하나로 시작할 경우 해당 값을 잘라낼 수도 있습니다.

use Illuminate\Support\Str;

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

// 'laravel.com'

`chopEnd`

chopEnd 메서드는 주어진 값이 문자열의 끝에 있을 경우, 마지막 등장하는 값만 잘라냅니다.

use Illuminate\Support\Str;

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

// 'https://laravel'

배열을 전달하여 여러 값 중 하나로 끝날 경우 해당 값을 잘라낼 수도 있습니다.

use Illuminate\Support\Str;

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

// 'http://laravel'

`contains`

contains 메서드는 지정한 문자열이 포함되어 있는지 확인합니다. 기본적으로 대소문자를 구분합니다.

use Illuminate\Support\Str;

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

// true

값들의 배열을 전달하여, 배열 안에 하나라도 포함되면 true를 반환할 수 있습니다.

use Illuminate\Support\Str;

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

// true

ignoreCase 인수를 true로 지정하면 대소문자 구분 없이 검사합니다.

use Illuminate\Support\Str;

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

// true

`containsAll`

containsAll 메서드는 주어진 배열에 들어있는 모든 값이 문자열에 모두 포함되어 있는지 검사합니다.

use Illuminate\Support\Str;

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

// true

ignoreCase 인수를 true로 지정하면 대소문자 구분 없이 검사할 수 있습니다.

use Illuminate\Support\Str;

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

// true

`deduplicate`

deduplicate 메서드는 연속된 동일 문자를 하나로 합쳐줍니다. 기본값은 공백 문자입니다.

use Illuminate\Support\Str;

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

// The Laravel Framework

두 번째 인수로 중복 제거 대상을 다른 문자로 지정할 수도 있습니다.

use Illuminate\Support\Str;

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

// The-Laravel-Framework

`dirname`

dirname 메서드는 주어진 문자열의 상위 디렉터리 경로 부분을 반환합니다.

use Illuminate\Support\Str;

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

// '/foo/bar'

필요하다면 트리밍할 디렉터리 깊이(레벨)를 추가로 지정할 수 있습니다.

use Illuminate\Support\Str;

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

// '/foo'

`endsWith`

endsWith 메서드는 주어진 값(문자열)로 끝나는지 확인합니다.

use Illuminate\Support\Str;

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

// true

여러 값을 배열로 전달해서, 그 중 하나로 끝나는지 확인할 수도 있습니다.

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 메서드는 두 문자열이 완전히 동일한지(일치하는지) 확인합니다.

use Illuminate\Support\Str;

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

// true

`excerpt`

excerpt 메서드는 문자열 안에서 지정한 구절을 기준으로 해당 구절이 포함된 일부만 잘라서 반환합니다.

use Illuminate\Support\Str;

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

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

radius 옵션(기본값 100)을 사용하여, 잘린 문자열 좌우로 몇 글자까지 보여줄지 지정할 수 있습니다.

또한 omission 옵션으로 잘린 문자열 앞뒤에 붙일 문자열(기호 등)을 변경할 수 있습니다.

use Illuminate\Support\Str;

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

// '(...) my name'

`explode`

explode 메서드는 주어진 구분자(delimiter)로 문자열을 나누고, 분할된 각 부분을 포함한 컬렉션을 반환합니다.

use Illuminate\Support\Str;

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

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

`finish`

finish 메서드는 문자열이 지정한 값으로 끝나지 않으면, 값을 한 번만 추가합니다. 이미 값으로 끝날 경우에는 추가하지 않습니다.

use Illuminate\Support\Str;

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

// this/string/

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

// this/string/

`headline`

headline 메서드는 케이스 구분, 하이픈(-), 언더스코어(_)로 구분된 문자열을 공백으로 구분하고, 각 단어의 첫 글자를 대문자로 변환합니다.

use Illuminate\Support\Str;

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

// Taylor Otwell

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

// Email Notification Sent

`inlineMarkdown`

inlineMarkdown 메서드는 GitHub 형식의 마크다운을 CommonMark를 사용해 인라인 HTML로 변환합니다. 단, markdown 메서드와 달리 생성된 HTML 전체를 블록 레벨 요소로 감싸지 않습니다.

use Illuminate\Support\Str;

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

// <strong>Laravel</strong>

마크다운 보안

기본적으로 마크다운은 원시 HTML을 지원합니다. 이로 인해 사용자의 원본 입력 데이터에 대해 사용하면 교차 사이트 스크립팅(XSS) 취약점이 발생할 수 있습니다. CommonMark 보안 문서에 따라, html_input 옵션으로 원시 HTML을 이스케이프하거나 제거(strip)할 수 있고, allow_unsafe_links 옵션을 통해 위험한 링크 허용 여부를 지정할 수 있습니다. 만약 일부 원시 HTML만 허용하려면, 변환된 마크다운 결과를 HTML Purifier 등으로 추가 필터링해야 합니다.

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 메서드는 주어진 문자열이 특정 패턴과 일치하는지 확인합니다. 별표(*)는 와일드카드로 사용할 수 있습니다.

use Illuminate\Support\Str;

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

// true

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

// false

`isAscii`

isAscii 메서드는 주어진 문자열이 ASCII 문자열인지 판별합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`isEmpty`

isEmpty 메서드는 주어진 문자열이 비어 있는지 판별합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`isNotEmpty`

isNotEmpty 메서드는 주어진 문자열이 비어 있지 않은지 판별합니다.

use Illuminate\Support\Str;

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

// false

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

// true

`isJson`

isJson 메서드는 주어진 문자열이 올바른 JSON 형식인지 판별합니다.

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인지 판별합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`isUrl`

isUrl 메서드는 주어진 문자열이 URL 형식인지 판별합니다.

use Illuminate\Support\Str;

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

// true

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

// false

isUrl 메서드는 다양한 프로토콜을 유효한 것으로 인식합니다. 그러나 유효하다고 간주할 프로토콜을 배열로 지정하여 제한할 수도 있습니다.

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

`isUuid`

isUuid 메서드는 주어진 문자열이 UUID인지 판별합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`kebab`

kebab 메서드는 주어진 문자열을 kebab-case 형태로 변환합니다.

use Illuminate\Support\Str;

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

// foo-bar

`lcfirst`

lcfirst 메서드는 주어진 문자열의 첫 글자를 소문자로 바꿔서 반환합니다.

use Illuminate\Support\Str;

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

// foo Bar

`length`

length 메서드는 주어진 문자열의 길이를 반환합니다.

use Illuminate\Support\Str;

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

// 7

`limit`

limit 메서드는 주어진 문자열을 지정한 길이만큼 잘라냅니다.

use Illuminate\Support\Str;

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

// The quick brown fox...

잘린 문자열 끝에 덧붙일 텍스트를 두 번째 인수로 지정할 수도 있습니다.

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

// The quick brown fox (...)

문자열을 잘라낼 때 단어 경계를 유지하고 싶을 경우, preserveWords 인수를 true로 설정할 수 있습니다. 이 경우 가장 가까운 단어 단위까지 잘립니다.

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

// The quick...

`lower`

lower 메서드는 주어진 문자열을 모두 소문자로 변환합니다.

use Illuminate\Support\Str;

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

// 'laravel'

`markdown`

markdown 메서드는 GitHub 양식의 마크다운을 HTML로 변환합니다.

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>

마크다운 보안

기본적으로 마크다운은 원시 HTML을 지원하므로, 사용자 입력을 그대로 처리할 경우 크로스사이트 스크립팅(XSS) 취약점에 노출될 수 있습니다. CommonMark 보안 문서에 따르면, html_input 옵션을 사용하여 원시 HTML을 이스케이프하거나 제거할 수 있으며, allow_unsafe_links 옵션을 통해 위험한 링크 허용 여부를 지정할 수 있습니다. 만약 일부 원시 HTML만 허용해야 할 필요가 있다면 마크다운을 HTML Purifier와 같은 라이브러리로 추가 필터링하는 것을 권장합니다.

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 메서드는 문자열의 일부를 지정한 문자로 반복 마스킹하여, 이메일 주소나 전화번호와 같은 민감한 정보의 일부를 가릴 때 사용할 수 있습니다.

use Illuminate\Support\Str;

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

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

필요하다면, 세 번째 또는 네 번째 인수(마스킹 위치 관련)에 음수 값을 전달할 수도 있습니다. 이 경우 문자열 끝에서부터 해당 위치 기준으로 마스킹이 시작됩니다.

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

// tay***@example.com

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

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

`match`

match 메서드는 주어진 정규표현식 패턴과 일치하는 문자열 부분을 반환합니다.

use Illuminate\Support\Str;

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

// 'bar'

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

// 'bar'

`matchAll`

matchAll 메서드는 주어진 정규표현식 패턴과 일치하는 부분을 모두 찾아 컬렉션으로 반환합니다.

use Illuminate\Support\Str;

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

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

표현식에 매칭 그룹을 지정하면, 라라벨은 첫 번째 매칭 그룹에 해당하는 모든 결과를 컬렉션으로 반환합니다.

use Illuminate\Support\Str;

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

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

일치하는 결과가 없으면 빈 컬렉션이 반환됩니다.

`isMatch`

isMatch 메서드는 문자열이 특정 정규표현식 패턴과 일치하면 true를 반환합니다.

use Illuminate\Support\Str;

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

// true

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

// false

`newLine`

newLine 메서드는 문자열 끝에 줄바꿈 문자(End of Line)를 추가합니다.

use Illuminate\Support\Str;

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

// 'Laravel
//  Framework'

`padBoth`

padBoth 메서드는 PHP의 str_pad 함수를 감싸고 있으며, 지정한 문자열로 양쪽(앞뒤)을 채워서 최종적으로 지정한 길이가 되도록 만듭니다.

use Illuminate\Support\Str;

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

// '__James___'

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

// '  James   '

`padLeft`

padLeft 메서드는 PHP의 str_pad 함수를 감싸고 있으며, 문자열의 왼쪽(앞쪽)을 지정한 문장열로 채워, 최종적으로 지정한 길이가 되도록 만듭니다.

use Illuminate\Support\Str;

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

// '-=-=-James'

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

// '     James'

`padRight`

padRight 메서드는 PHP의 str_pad 함수를 감싸고 있으며, 문자열의 오른쪽(뒤쪽)을 지정한 문자열로 채워서 최종 길이가 되도록 만듭니다.

use Illuminate\Support\Str;

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

// 'James-----'

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

// 'James     '

`pipe`

pipe 메서드는 현재 문자열 값을 인수로 주어진 콜러블(함수)에 전달하여 변환할 수 있게 해줍니다.

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 메서드는 단수형 단어 문자열을 복수형으로 변환합니다. 이 함수는 라라벨의 복수화 기능에서 지원하는 모든 언어를 지원합니다.

use Illuminate\Support\Str;

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

// cars

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

// children

두 번째 인수로 정수를 함께 전달하면, 해당 숫자에 맞는 단수 또는 복수형 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// children

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

// child

`position`

position 메서드는 주어진 문자열 내에서 특정 부분 문자열이 처음 등장하는 위치(인덱스)를 반환합니다. 만약 찾는 부분 문자열이 존재하지 않으면 false를 반환합니다.

use Illuminate\Support\Str;

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

// 0

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

// 7

`prepend`

prepend 메서드는 주어진 값들을 기존 문자열의 앞에 붙입니다.

use Illuminate\Support\Str;

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

// Laravel Framework

`remove`

remove 메서드는 주어진 값 또는 값으로 이뤄진 배열을 문자열에서 제거합니다.

use Illuminate\Support\Str;

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

// Arkansas is beautiful!

문자열 제거 시 대소문자를 무시하려면 두 번째 인수로 false를 전달할 수 있습니다.

`repeat`

repeat 메서드는 지정된 횟수만큼 문자열을 반복하여 만듭니다.

use Illuminate\Support\Str;

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

// aaaaa

`replace`

replace 메서드는 문자열에서 지정한 값을 다른 값으로 교체합니다.

use Illuminate\Support\Str;

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

// Laravel 7.x

replace 메서드는 caseSensitive 인수를 받을 수도 있습니다. 기본적으로 replace는 대소문자를 구분합니다.

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

`replaceArray`

replaceArray 메서드는 문자열에서 지정한 값을 배열의 값으로 순차적으로 치환합니다.

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 메서드는 문자열에서 지정한 값이 처음 나타나는 부분만 다른 값으로 교체합니다.

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 메서드는 문자열에서 주어진 값이 마지막으로 나타나는 부분만을 다른 값으로 대체합니다.

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 메서드는 특정 패턴에 일치하는 문자열의 모든 부분을 지정한 치환 문자열로 대체합니다.

use Illuminate\Support\Str;

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

// '15015551000'

replaceMatches 메서드는 콜렉션(closure)도 인자로 받을 수 있으며, 해당 콜렉션은 주어진 패턴과 일치하는 각 부분에서 호출되어, 치환 로직을 직접 구현하고 그 반환 값을 치환에 사용할 수 있습니다.

use Illuminate\Support\Str;

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

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

`replaceStart`

replaceStart 메서드는 주어진 값이 문자열의 시작 부분에 있을 때에만, 해당 값을 다른 값으로 한 번만 대체합니다.

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 메서드는 주어진 값이 문자열의 끝 부분에 있을 때에만, 해당 값을 마지막 한 번만 대체합니다.

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 함수가 지원하는 포맷을 사용해 입력값을 파싱한 후, 그 결과를 컬렉션으로 반환합니다.

use Illuminate\Support\Str;

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

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

`singular`

singular 메서드는 문자열을 단수형으로 변환합니다. 이 기능은 라라벨의 복수화 도우미가 지원하는 모든 언어를 지원합니다.

use Illuminate\Support\Str;

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

// car

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

// child

`slug`

slug 메서드는 주어진 문자열을 URL에 친화적인 "슬러그(slug)" 형태로 변환합니다.

use Illuminate\Support\Str;

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

// laravel-framework

`snake`

snake 메서드는 주어진 문자열을 snake_case 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// foo_bar

`split`

split 메서드는 정규표현식을 사용해 문자열을 분할하고, 그 결과를 컬렉션으로 반환합니다.

use Illuminate\Support\Str;

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

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

`squish`

squish 메서드는 문자열의 앞뒤와 단어 사이에 있는 불필요한 공백을 모두 제거합니다.

use Illuminate\Support\Str;

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

// laravel framework

`start`

start 메서드는 문자열이 특정 값으로 시작하지 않을 경우, 해당 값을 문자열의 앞에 한 번만 추가합니다.

use Illuminate\Support\Str;

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

// /this/string

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

// /this/string

`startsWith`

startsWith 메서드는 주어진 문자열이 특정 값으로 시작하는지 확인합니다.

use Illuminate\Support\Str;

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

// true

`stripTags`

stripTags 메서드는 문자열에서 모든 HTML 및 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(각 단어가 대문자로 시작)로 변환합니다.

use Illuminate\Support\Str;

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

// FooBar

`substr`

substr 메서드는 지정한 시작 지점부터 길이만큼의 부분 문자열을 반환합니다.

use Illuminate\Support\Str;

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

// Framework

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

// Frame

`substrReplace`

substrReplace 메서드는 두 번째 인자로 지정한 위치부터, 세 번째 인자로 지정한 글자 수만큼 기존 문자열을 대체합니다. 세 번째 인자에 0을 전달하면, 문자열의 지정 위치에 새 문자열을 삽입하고 기존 문자는 삭제하지 않습니다.

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 함수를 사용하여, 문자열 내의 여러 값을 한 번에 치환합니다.

use Illuminate\Support\Str;

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

// Burritos are fantastic!

`take`

take 메서드는 문자열의 앞부분에서 지정한 개수만큼의 문자만을 반환합니다.

use Illuminate\Support\Str;

$taken = Str::of('Build something amazing!')->take(5);

// Build

`tap`

tap 메서드는 문자열 값을 전달받은 클로저(closure)에 넘겨주어, 그 값을 별도로 확인·조작할 수 있게 해줍니다. 단, 클로저에서 무엇을 반환하든, 최종적으로는 원래의 문자열 인스턴스가 반환됩니다.

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 메서드는 주어진 문자열이 지정한 정규표현식 패턴과 일치하는지 판별합니다.

use Illuminate\Support\Str;

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

// true

`title`

title 메서드는 주어진 문자열을 Title Case(각 단어의 첫 글자만 대문자)로 변환합니다.

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 인코딩 형식으로 변환합니다.

use Illuminate\Support\Str;

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

// TGFyYXZlbA==

`toHtmlString`

toHtmlString 메서드는 주어진 문자열을 Illuminate\Support\HtmlString 인스턴스로 변환하여, Blade 템플릿에서 렌더링할 때 이스케이프 처리되지 않도록 합니다.

use Illuminate\Support\Str;

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

`transliterate`

transliterate 메서드는 주어진 문자열을 가능한 한 가장 가까운 ASCII 문자로 변환하려고 시도합니다.

use Illuminate\Support\Str;

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

// '[email protected]'

`trim`

trim 메서드는 문자열 앞뒤의 공백을 제거합니다. PHP의 기본 trim 함수와 달리, 라라벨의 trim 메서드는 유니코드 공백 문자까지 모두 제거합니다.

use Illuminate\Support\Str;

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

// 'Laravel'

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

// 'Laravel'

`ltrim`

ltrim 메서드는 문자열의 왼쪽(앞) 부분의 공백을 제거합니다. PHP의 기본 ltrim 함수와 달리, 라라벨의 ltrim 메서드는 유니코드 공백 문자까지 모두 제거합니다.

use Illuminate\Support\Str;

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

// 'Laravel  '

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

// 'Laravel/'

`rtrim`

rtrim 메서드는 주어진 문자열의 오른쪽(뒤) 부분의 공백을 제거합니다. PHP의 기본 rtrim 함수와 달리, 라라벨의 rtrim 메서드는 유니코드 공백 문자까지 모두 제거합니다.

use Illuminate\Support\Str;

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

// '  Laravel'

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

// '/Laravel'

`ucfirst`

ucfirst 메서드는 주어진 문자열의 첫 글자만 대문자로 변환합니다.

use Illuminate\Support\Str;

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

// Foo bar

`ucsplit`

ucsplit 메서드는 주어진 문자열을 대문자 기준으로 분할하여 컬렉션으로 반환합니다.

use Illuminate\Support\Str;

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

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

`unwrap`

unwrap 메서드는 주어진 문자열의 앞과 뒤에서 특정 문자열을 제거합니다.

use Illuminate\Support\Str;

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

// Laravel

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

// framework: "Laravel"

`upper`

upper 메서드는 주어진 문자열을 모두 대문자로 변환합니다.

use Illuminate\Support\Str;

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

// LARAVEL

`when`

when 메서드는 주어진 조건이 true일 때, 해당 클로저를 실행합니다. 클로저는 플루언트 문자열 인스턴스를 전달받게 됩니다.

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

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

// 'Taylor Otwell'

필요하다면, 세 번째 인자로 다른 클로저를 전달할 수 있습니다. 이 클로저는 조건이 false로 평가될 때 실행됩니다.

`whenContains`

whenContains 메서드는 문자열이 지정한 값을 포함할 때 지정한 클로저를 실행합니다. 클로저에는 플루언트 문자열 인스턴스가 전달됩니다.

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

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

// 'Tony Stark'

필요한 경우 세 번째 인자로 다른 클로저를 전달할 수 있습니다. 이 클로저는 문자열이 주어진 값을 포함하지 않을 때 실행됩니다.

또한, 배열 형태로 여러 값을 전달하여, 문자열에 그중 하나라도 포함되어 있는지 판별할 수도 있습니다.

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 메서드는 문자열이 전달한 모든 하위 문자열을 포함하고 있을 때, 지정한 클로저를 실행합니다. 클로저에는 플루언트 문자열 인스턴스가 전달됩니다.

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로 판별될 때 실행됩니다.

`whenEmpty`

whenEmpty 메서드는 문자열이 비어있을 때, 지정한 클로저를 실행합니다. 클로저에서 값을 반환하면 그 값이 whenEmpty의 반환값이 되고, 반환값이 없으면 플루언트 문자열 인스턴스를 반환합니다.

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

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

// 'Laravel'

`whenNotEmpty`

whenNotEmpty 메서드는 문자열이 비어 있지 않을 때, 지정한 클로저를 실행합니다. 클로저에서 반환값이 있으면 해당 값이 반환되고, 없으면 플루언트 문자열 인스턴스가 반환됩니다.

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

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

// 'Laravel Framework'

`whenStartsWith`

whenStartsWith 메서드는 현재 문자열이 주어진 하위 문자열로 시작할 경우, 전달한 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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 메서드는 현재 문자열이 주어진 하위 문자열로 끝날 경우, 전달한 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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 메서드는 현재 문자열이 전달된 문자열과 정확하게 일치할 경우, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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

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

// 'Laravel'

`whenNotExactly`

whenNotExactly 메서드는 현재 문자열이 전달된 문자열과 정확히 일치하지 않을 경우, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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

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

// 'Framework'

`whenIs`

whenIs 메서드는 현재 문자열이 주어진 패턴과 일치할 때 클로저를 실행합니다. 패턴에서 별표(*)는 와일드카드로 사용할 수 있습니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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일 경우, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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

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

// 'Laravel'

`whenIsUlid`

whenIsUlid 메서드는 문자열이 유효한 ULID일 경우, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

use Illuminate\Support\Str;

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

// '01gd6r36'

`whenIsUuid`

whenIsUuid 메서드는 문자열이 유효한 UUID일 경우, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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 메서드는 현재 문자열이 주어진 정규 표현식과 일치할 때, 클로저를 실행합니다. 이 클로저는 유창한 문자열 인스턴스를 인수로 받습니다.

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 메서드는 문자열 내에 포함된 단어의 개수를 반환합니다.

use Illuminate\Support\Str;

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

`words`

words 메서드는 문자열의 단어 수를 제한합니다. 필요에 따라, 잘린 문자열 뒤에 추가로 붙일 문자열을 지정할 수 있습니다.

use Illuminate\Support\Str;

$string = Str::of('Perfectly balanced, as all things should be.')->words(3, ' >>>');

// Perfectly balanced, as >>>

`wrap`

wrap 메서드는 현재 문자열의 앞뒤를 추가 문자열로 감쌉니다. 또는, 각각 앞, 뒤에 별도의 문자열을 지정할 수도 있습니다.

use Illuminate\Support\Str;

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

// "Laravel"

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

// This is Laravel!

소개​

사용 가능한 메서드​

문자열 관련 함수​

Fluent 문자열 메서드​

문자열​

__()​

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

Str::isUlid()​

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

소개

사용 가능한 메서드

문자열 관련 함수

Fluent 문자열 메서드

문자열

`__()`

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

`Str::isUlid()`

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