헬퍼 함수들

시작하기

라라벨은 다양한 글로벌 "헬퍼" PHP 함수들을 포함하고 있습니다. 그 중 많은 기능은 프레임워크가 스스로 사용하지만 여러분의 애플리케이션에도 자유롭게 사용하실 수 있습니다.

사용 가능한 메소드

배열 & 객체

경로

문자열

URLs

기타

메소드 목록

배열 & 객체

array_add() {#collection-method .first-collection-method}

array_add 함수는 배열 내에 키가 존재하지 않는 경우 주어진 key/value 쌍을 배열에 추가합니다:

$array = array_add(['name' => 'Desk'], 'price', 100);

// ['name' => 'Desk', 'price' => 100]

array_collapse() {#collection-method}

array_collapse 함수는 배열들의 배열(여러개의 배열)을 하나의 배열로 통합합니다:

$array = array_collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]);

// [1, 2, 3, 4, 5, 6, 7, 8, 9]

array_divide() {#collection-method}

array_divide 함수는 주어진 배열에서 키(key)들을 담고 있는 배열과 값(value)들을 담고 있는 배열, 총 2개의 배열들을 반환합니다:

[$keys, $values] = array_divide(['name' => 'Desk']);

// $keys: ['name']

// $values: ['Desk']

array_dot() {#collection-method}

array_dot 함수는 다차원 배열을 ‘점(.)’으로 배열 깊이를 표기하면서 단일 레벨의 배열로 만듭니다:

$array = ['products' => ['desk' => ['price' => 100]]];

$flattened = array_dot($array);

// ['products.desk.price' => 100]

array_except() {#collection-method}

array_except 메소드는 주어진 키 / 값 쌍을 배열에서 제거합니다.

$array = ['name' => 'Desk', 'price' => 100];

$filtered = array_except($array, ['price']);

// ['name' => 'Desk']

array_first() {#collection-method}

array_first 함수는 넘겨진 배열 중 주어진 조건을 만족하는 첫번째 요소를 반환합니다:

$array = [100, 200, 300];

$first = array_first($array, function ($value, $key) {
    return $value >= 150;
});

// 200

메소드에 세번째 파라미터로 기본 값을 지정할 수 있습니다. 배열의 어떠한 값도 조건을 통과하지 못했을 때 이 값이 반환됩니다:

$first = array_first($array, $callback, $default);

array_flatten() {#collection-method}

array_flatten 함수는 다차원 배열을 단일 레벨의 1차원 배열로 만듭니다:

$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']];

$flattened = array_flatten($array);

// ['Joe', 'PHP', 'Ruby']

array_forget() {#collection-method}

array_forget 함수는 “점(.)”표기법을 사용하여 중첩 배열로부터 주어진 키/ 값 쌍을 제거합니다:

$array = ['products' => ['desk' => ['price' => 100]]];

array_forget($array, 'products.desk');

// ['products' => []]

array_get() {#collection-method}

array_get 함수는 “점(.)”표기법으로 중첩 배열로부터 주어진 값을 찾습니다:

$array = ['products' => ['desk' => ['price' => 100]]];

$price = array_get($array, 'products.desk.price');

// 100

array_get 함수는 특정 키를 찾지 못한 경우 반환되는 기본값을 지정할 수도 있습니다.

$discount = array_get($array, 'products.desk.discount', 0);

// 0

array_has() {#collection-method}

array_has 함수는 "점(.)" 표기를 이용하여 배열에 주어진 아이템 또는 아이템들이 존재하는지 확인합니다:

$array = ['product' => ['name' => 'Desk', 'price' => 100]];

$contains = array_has($array, 'product.name');

// true

$contains = array_has($array, ['product.price', 'product.discount']);

// false

array_last() {#collection-method}

array_last 함수는 전달된 조건을 통과하는 아이템의 가장 마지막 요소를 반환합니다:

$array = [100, 200, 300, 110];

$last = array_last($array, function ($value, $key) {
    return $value >= 150;
});

// 300

메소드의 세번째 인자로 기본값을 전달할 수 있습니다. 이 값은 조건을 통과하는 값이 없을 때 반환됩니다:

$last = array_last($array, $callback, $default);

array_only() {#collection-method}

array_only 함수는 특정한 키 / 값 쌍만을 배열로부터 반환합니다:

$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];

$slice = array_only($array, ['name', 'price']);

// ['name' => 'Desk', 'price' => 100]

array_pluck() {#collection-method}

array_pluck 함수는 배열로부터 주어진 키 / 값 쌍의 리스트를 조회합니다:

$array = [
    ['developer' => ['id' => 1, 'name' => 'Taylor']],
    ['developer' => ['id' => 2, 'name' => 'Abigail']],
];

$names = array_pluck($array, 'developer.name');

// ['Taylor', 'Abigail']

리스트만들어 지는 결과가 어떻게 키로 변환될지 지정할 수도 있습니다:

$names = array_pluck($array, 'developer.name', 'developer.id');

// [1 => 'Taylor', 2 => 'Abigail']

array_prepend() {#collection-method}

array_prepend 함수는 배열의 시작부분에 아이템을 추가할 것입니다:

$array = ['one', 'two', 'three', 'four'];

$array = array_prepend($array, 'zero');

// ['zero', 'one', 'two', 'three', 'four']

필요한 경우, 아이템의 키를 지정할 수도 있습니다:

$array = ['price' => 100];

$array = array_prepend($array, 'Desk', 'name');

// ['name' => 'Desk', 'price' => 100]

array_pull() {#collection-method}

array_pull 함수는 배열에서 주어진 키 / 값 쌍을 반환함과 동시에 제거합니다:

$array = ['name' => 'Desk', 'price' => 100];

$name = array_pull($array, 'name');

// $name: Desk

// $array: ['price' => 100]

메소드의 세번째 인자로 기본값을 전달 할 수 있습니다. 키가 존재하지 않는 경우 이 값이 반환됩니다:

$value = array_pull($array, $key, $default);

array_random() {#collection-method}

array_random 함수는 배열에서 임의의 값을 반환합니다:

$array = [1, 2, 3, 4, 5];

$random = array_random($array);

// 4 - (retrieved randomly)

두번째 인자로 몇개의 아이템을 반환할지 값을 지정할 수 있습니다. 이 인자를 지정하면, 하나의 아이템이 포함되더라도 배열이 반환 됩니다:

$items = array_random($array, 2);

// [2, 5] - (retrieved randomly)

array_set() {#collection-method}

array_set 함수는 "점(.)" 표기법을 이용하여 중첩된 배열 내에 값을 설정합니다:

$array = ['products' => ['desk' => ['price' => 100]]];

array_set($array, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 200]]]

array_sort() {#collection-method}

array_sort 함수는 값을 기반으로 정렬을 수행합니다:

$array = ['Desk', 'Table', 'Chair'];

$sorted = array_sort($array);

// ['Chair', 'Desk', 'Table']

또한 주어진 클로저의 결과 값으로 배열을 정렬 할 수 있습니다:

$array = [
    ['name' => 'Desk'],
    ['name' => 'Table'],
    ['name' => 'Chair'],
];

$sorted = array_values(array_sort($array, function ($value) {
    return $value['name'];
}));

/*
    [
        ['name' => 'Chair'],
        ['name' => 'Desk'],
        ['name' => 'Table'],
    ]
*/

array_sort_recursive() {#collection-method}

array_sort_recursive 함수는 sort 함수를 이용하여 반복적으로 배열을 정렬합니다:

$array = [
    ['Roman', 'Taylor', 'Li'],
    ['PHP', 'Ruby', 'JavaScript'],
];

$sorted = array_sort_recursive($array);

/*
    [
        ['Li', 'Roman', 'Taylor'],
        ['JavaScript', 'PHP', 'Ruby'],
    ]
*/

array_where() {#collection-method}

array_where 함수는 주어진 클로져를 사용하여 배열을 필터링합니다:

$array = [100, '200', 300, '400', 500];

$filtered = array_where($array, function ($value, $key) {
    return is_string($value);
});

// [1 => '200', 3 => '400']

array_wrap() {#collection-method}

array_wrap 함수는 주어진 값을 배열로 만듭니다. 만약 함수에 전달된 값이 배열이라면, 결과에는 변경사항이 없습니다:

$string = 'Laravel';

$array = array_wrap($string);

// ['Laravel']

주어진 값이 null인 경우, 빈 배열이 반환됩니다:

$nothing = null;

$array = array_wrap($nothing);

// []

data_fill() {#collection-method}

data_fill 함수는 "점" 표기법을 사용하여 중첩된 배열 또는 객체 내부에 빠진 값을 채워넣습니다:

$data = ['products' => ['desk' => ['price' => 100]]];

data_fill($data, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 100]]]

data_fill($data, 'products.desk.discount', 10);

// ['products' => ['desk' => ['price' => 100, 'discount' => 10]]]

이 함수는 또한 별표를 와일드카드로 받아들여, 해당하는 대상을 채워넣습니다:

$data = [
    'products' => [
        ['name' => 'Desk 1', 'price' => 100],
        ['name' => 'Desk 2'],
    ],
];

data_fill($data, 'products.*.price', 200);

/*
    [
        'products' => [
            ['name' => 'Desk 1', 'price' => 100],
            ['name' => 'Desk 2', 'price' => 200],
        ],
    ]
*/

data_get() {#collection-method}

data_get 함수는 "점" 표기법을 사용하여 중첩된 배열 또는 객체 안에서 값을 조회합니다:

$data = ['products' => ['desk' => ['price' => 100]]];

$price = data_get($data, 'products.desk.price');

// 100

data_get 함수는 또한 지정된 키를 찾을 수 없는 경우 반환될 기본값을 인자로 받습니다:

$discount = data_get($data, 'products.desk.discount', 0);

// 0

data_set() {#collection-method}

data_set 함수는 "dot" 표기법을 사용하여 중첩된 배열 또는 객체 안의 값을 설정합니다:

$data = ['products' => ['desk' => ['price' => 100]]];

data_set($data, 'products.desk.price', 200);

// ['products' => ['desk' => ['price' => 200]]]

이 함수는 또한 별표를 와일드카드로 받아들여, 해당하는 대상을 설정합니다:

$data = [
    'products' => [
        ['name' => 'Desk 1', 'price' => 100],
        ['name' => 'Desk 2', 'price' => 150],
    ],
];

data_set($data, 'products.*.price', 200);

/*
    [
        'products' => [
            ['name' => 'Desk 1', 'price' => 200],
            ['name' => 'Desk 2', 'price' => 200],
        ],
    ]
*/

기본적으로 존재하는 값은 덮어쓰게 됩니다. 값이 존재하지 않을 때만, 새로운 값을 설정하고자 한다면, 세번째 인자로 false를 전달하면 됩니다:

$data = ['products' => ['desk' => ['price' => 100]]];

data_set($data, 'products.desk.price', 200, false);

// ['products' => ['desk' => ['price' => 100]]]

head() {#collection-method}

head 함수는 배열의 첫번째 요소를 반환합니다:

$array = [100, 200, 300];

$first = head($array);

// 100

last() {#collection-method}

last 함수는 배열의 마지막 요소를 반환합니다:

$array = [100, 200, 300];

$last = last($array);

// 300

경로

app_path() {#collection-method}

app_path 함수는 app 디렉토리에 대한 절대 경로를 반환합니다. app_path 함수를 사용하면 애플리케이션 디렉토리에서 특정 파일의 절대 경로를 생성할 수도 있습니다:

$path = app_path();

$path = app_path('Http/Controllers/Controller.php');

base_path() {#collection-method}

base_path 함수는 프로젝트의 루트 디렉토리에 대한 절대 경로를 반환합니다. base_path 함수를 사용하여 프로젝트 루트 디렉토리에 대한 특정 파일의 절대 경로를 생성할 수도 있습니다:

$path = base_path();

$path = base_path('vendor/bin');

config_path() {#collection-method}

config_path 함수는 애플리케이션의 config 디렉토리에 대한 절대 경로를 반환합니다. config_path 함수를 사용하여, 애플리케이션의 설정 디렉토리 안에 있는 파일에 대한 절대 경로를 생성할 수도 있습니다:

$path = config_path();

$path = config_path('app.php');

database_path() {#collection-method}

database_path 함수는 애플리케이션의 database 디렉토리에 대한 절대 경로를 반환합니다. database_path 함수를 사용하여, 애플리케이션의 데이터베이스 디렉토리 안에 있는 파일에 대한 절대 경로를 생성할 수도 있습니다:

$path = database_path();

$path = database_path('factories/UserFactory.php');

mix() {#collection-method}

mix 함수는 버전이 지정된 Mix 파일에 대한 경로를 반환합니다:

$path = mix('css/app.css');

public_path() {#collection-method}

public_path 함수는 public 디렉토리에 대한 절대경로를 반환합니다. public_path 함수를 사용하여, 애플리케이션의 public 디렉토리 안에 있는 파일에 대한 절대 경로를 생성할 수도 있습니다:

$path = public_path();

$path = public_path('css/app.css');

resource_path() {#collection-method}

resource_path 함수는 resources 디렉토리에 대한 절대경로를 반환합니다. resource_path 함수를 사용하여 리소스 디렉토리 안에 있는 파일에 대한 절대 경로를 생성할 수도 있습니다:

$path = resource_path();

$path = resource_path('assets/sass/app.scss');

storage_path() {#collection-method}

storage_path 함수는 storage 디렉토리에 대한 절대경로를 반환합니다. storage_path 함수를 사용하여 스토리지 디렉토리 안에 있는 파일에 대한 절대 경로를 생성할 수도 있습니다:

$path = storage_path();

$path = storage_path('app/file.txt');

문자열

__() {#collection-method}

__ 함수는 주어진 다국어 문자열 또는 다국어 키를 다국어 파일을 사용하여 변환합니다:

echo __('Welcome to our application');

echo __('messages.welcome');

지정된 다국어 문자열이나 키가 존재하지 않는 경우, __ 함수는 주어진 값을 그대로 반환합니다. 따라서 예제와 같이 __ 함수는 다국어 키가 존재하지 않는다면 messages.welcome를 그대로 반환합니다.

camel_case() {#collection-method}

camel_case 함수는 주어진 문자열을 camelCase 형태로 변환합니다:

$converted = camel_case('foo_bar');

// fooBar

class_basename() {#collection-method}

class_basename은 클래스의 네임스페이스를 제거한 클래스의 클래스 명을 반환합니다:

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

// Baz

e() {#collection-method}

e 함수는 주어진 문자열에 PHP의 htmlspecialchars 함수를 duuble_encode 옵션이 기본적으로 true 인 형태로 실행한 결과를 반환합니다:

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

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

ends_with() {#collection-method}

ends_with 함수는 주어진 문자열이 특정 값으로 끝나는지 알아냅니다:

$result = ends_with('This is my name', 'name');

// true

kebab_case() {#collection-method}

kebab_case 함수는 주어진 문자열을 kebab-case로 변환합니다: (역자주 : 단어와 단어를 '-'로 연결한 형태)

$converted = kebab_case('fooBar');

// foo-bar

preg_replace_array() {#collection-method}

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

snake_case() {#collection-method}

snake_case 함수는 주어진 문자열을 snake_case 형태로 변환합니다:

$converted = snake_case('fooBar');

// foo_bar

starts_with() {#collection-method}

starts_with 함수는 문자열이 주어진 문자열으로 시작하는지 판별합니다:

$result = starts_with('This is my name', 'This');

// true

str_after() {#collection-method}

str_after 함수는 문자열에서 주어진 문자열 다음의 모든 값을 반환합니다:

$slice = str_after('This is my name', 'This is');

// ' my name'

str_before() {#collection-method}

str_before 함수는 문자열에 주어진 문자열 이전의 모든 값을 반환합니다:

$slice = str_before('This is my name', 'my name');

// 'This is '

str_contains() {#collection-method}

str_contains 함수는 주어진 문자열이 특정 문자열을 포함하는지 판별합니다 (대소문자를 구분합니다):

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

// true

또한 주어진 문자열이 특정 문자열을 포함하고 있는지 판별하기 위한 배열을 전달할 수도 있습니다:

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

// true

str_finish() {#collection-method}

str_finish 함수는 문자열이 주어진 값으로 끝나지 않는다면 해당 값을 추가합니다:

$adjusted = str_finish('this/string', '/');

// this/string/

$adjusted = str_finish('this/string/', '/');

// this/string/

str_is() {#collection-method}

str_is 함수는 주어진 문자열이 주어진 패턴과 대응되는지 확인합니다. 와일드카드를 표시하기 위해 별표를 사용할 수 있습니다:

$matches = str_is('foo*', 'foobar');

// true

$matches = str_is('baz*', 'foobar');

// false

str_limit() {#collection-method}

str_limit 함수는 주어진 문자열을 지정된 길이로 제한합니다:

$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 (...)

Str::orderedUuid() {#collection-method}

Str::orderedUuid 메소드는 인덱싱된 데이터베이스 컬럼에 효과적으로 저장될 수 있도록 "타임스탬프와 같은 정렬이 가능한" UUID를 생성합니다:

(역자주 : 이 헬퍼함수의 결과로 생성되는 UUID의 첫번째 부분은 시간에 따라서 증감하는 형태를 보입니다)

use Illuminate\Support\Str;

return (string) Str::orderedUuid();

str_plural() {#collection-method}

str_plural 함수는 문자열을 복수형태로 변환합니다. 이 함수는 현재 영어에만 적용 가능합니다:

$plural = str_plural('car');

// cars

$plural = str_plural('child');

// children

문자열의 단일 혹은 복수 형태를 조회하기 위해서, 함수의 두번째 인자로 정수를 전달할 수 있습니다:

$plural = str_plural('child', 2);

// children

$plural = str_plural('child', 1);

// child

str_random() {#collection-method}

str_random 함수는 지정된 길이의 문자열을 무작위로 생성합니다. 이 함수는 PHP의 random_bytes 함수를 사용합니다:

$random = str_random(40);

str_replace_array() {#collection-method}

str_replace_array 함수는 주어진 값을 순차적으로 배열값으로 치환합니다:

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

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

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

str_replace_first() {#collection-method}

str_replace_first 함수는 문자열에서 주어진 값이 발견된 첫번째 부분을 교체합니다:

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

// a quick brown fox jumps over the lazy dog

str_replace_last() {#collection-method}

str_replace_last 함수는 문자열에서 주어진 값이 발견된 마지막 부분을 교체합니다:

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

// the quick brown fox jumps over a lazy dog

str_singular() {#collection-method}

str_singular 함수는 문자열을 단수 형태로 변환합니다. 이 함수는 현재 영어에만 적용 가능합니다:

$singular = str_singular('cars');

// car

$singular = str_singular('children');

// child

str_slug() {#collection-method}

str_slug 함수는 주어진 문자열로부터 URL에 알맞은 "slug"를 생성합니다:

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

// laravel-5-framework

str_start() {#collection-method}

str_start 함수는 문자열이 주어진 값으로 시작하지 않은 경우에 이를 추가합니다:

$adjusted = str_start('this/string', '/');

// /this/string

$adjusted = str_start('/this/string', '/');

// /this/string

studly_case() {#collection-method}

studly_case 함수는 주어진 문자열을 StudlyCase 형태로 변환합니다:

$converted = studly_case('foo_bar');

// FooBar

title_case() {#collection-method}

title_case 함수는 주어진 문자열을 Title Case 로 변환합니다(단어별로 앞글자를 대문자, 단어 사이를 공백이 포함되는 형태):

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

// A Nice Title Uses The Correct Case

trans() {#collection-method}

trans 함수는 다국어 파일을 이용하여 주어진 다국어 키를 변환합니다:

echo trans('messages.welcome');

지정된 다국어 키가 존재하지 않는다면, trans 함수는 주어진 키를 반환합니다. 따라서 예제에서 다국어 키가 존재하지 않는다면 trans 함수는 messages.welcome를 그대로 반환합니다.

trans_choice() {#collection-method}

trans_choice 함수는 주어진, 수량(단수, 복수 처리)을 이용하여 주어진 다국어 키를 번역합니다:

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

지정된 다국어 키가 존재하지 않는다면, trans_choice 함수는 주어진 키를 반환합니다. 따라서 예제에서 다국어 키가 존재하지 않는다면 trans_choice 함수는 messages.notifications를 그대로 반환합니다.

Str::uuid() {#collection-method}

Str::uuid 메소드는 UUID (version 4)를 생성합니다:

use Illuminate\Support\Str;

return (string) Str::uuid();

URLs

action() {#collection-method}

action 함수는 주어진 컨트롤러 메소드로 URL을 생성합니다. 컨트롤러의 전체 네임스페이스를 전달하지 않아도 됩니다. 대신, App\Http\Controllers 네임스페이스에 따른 컨트롤러 클래스 이름을 전달하면 됩니다.:

$url = action('HomeController@index');

메소드가 라우트 파라미터를 받아들인다면, 두번째 인자로 메소드에 전달하십시오:

$url = action('UserController@profile', ['id' => 1]);

asset() {#collection-method}

asset 함수는 HTTP요청의 현재 scheme(HTTP나 HTTPS)을 이용하여 asset을 사용하기 위한 URL을 생성합니다:

$url = asset('img/photo.jpg');

secure_asset() {#collection-method}

secure_asset 함수는 HTTPS를 이용하여 asset을 사용하기 위한 URL을 생성합니다:

$url = secure_asset('img/photo.jpg');

route() {#collection-method}

route 함수는 주어진 라우트 이름으로 URL을 생성합니다:

$url = route('routeName');

라우트가 파라미터를 가진다면 파라미터를 두번째 인자로 메소드에 전달하세요:

$url = route('routeName', ['id' => 1]);

기본적으로 route 함수는 절대경로 URL을 생성합니다. 만약 상태경로의 URL을 생성하려면 세번째 인자를 false로 전달하면 됩니다:

$url = route('routeName', ['id' => 1], false);

secure_url() {#collection-method}

secure_url 함수는 주어진 경로에 대한 전체 HTTPS URL을 생성합니다:

$url = secure_url('user/profile');

$url = secure_url('user/profile', [1]);

url() {#collection-method}

url 함수는 주어진 경로에 대한 전체 URL을 생성합니다:

$url = url('user/profile');

$url = url('user/profile', [1]);

경로를 전달하지 않으면, Illuminate\Routing\UrlGenerator 인스턴스가 반환됩니다:

$current = url()->current();

$full = url()->full();

$previous = url()->previous();

기타 함수들

abort() {#collection-method}

abort 함수는 Exception 핸들러에 의해서 렌더링 될 수 있는 HTTP exception을 발생시킵니다:

abort(403);

exception 의 응답 텍스트를 제공하거나, 커스텀 헤더를 지정할 수도 있습니다:

abort(403, 'Unauthorized.', $headers);

abort_if() {#collection-method}

abort_if 함수는 주어진 조건식이 true 일때 HTTP exception을 발생시킵니다:

abort_if(! Auth::user()->isAdmin(), 403);

abort 메소드와 같이, exception 의 응답 텍스트를 세번째 인자로 전달할 수 있으며, 네번째 인자로 커스텀 응답 헤더를 전달할 수도 있습니다.

abort_unless() {#collection-method}

abort_unless 함수는 주어진 조건식이 false 일때 HTTP exception 을 발생시킵니다:

abort_unless(Auth::user()->isAdmin(), 403);

abort 메소드와 같이, exception 의 응답 텍스트를 세번째 인자로 전달할 수 있으며, 네번째 인자로 커스텀 응답 헤더를 전달할 수도 있습니다.

app() {#collection-method}

app 함수는 서비스 컨테이너 인스턴스를 반환합니다:

$container = app();

컨테이너에 의존성을 해결하고자 하는 클래스나 인터페이스의 이름을 전달할 수도 있습니다:

$api = app('HelpSpot\API');

auth() {#collection-method}

auth 함수는 authenticator 인스턴스를 반환합니다. 편의를 위하여 Auth 파사드 대신 이용할 수 있습니다:

$user = auth()->user();

필요한 경우, 어떤 guard 인스턴스를 사용할지 지정할 수 있습니다:

$user = auth('admin')->user();

back() {#collection-method}

back() 함수는 사용자의 이전 위치로 리다이렉트 HTTP response-응답을 생성합니다:

return back($status = 302, $headers = [], $fallback = false);

return back();

bcrypt() {#collection-method}

bcrypt 함수는 Bcrypt를 이용하여 주어진 값을 해시 처리합니다. Hash 파사드 대신 사용할 수 있습니다:

$password = bcrypt('my-secret-password');

broadcast() {#collection-method}

broadcast 함수는 주어진 이벤트를 리스너들에게 broadcasts 합니다:

broadcast(new UserRegistered($user));

blank() {#collection-method}

blank 함수는 주어진 값이 "빈값"인지 판단하여 결과를 반환합니다:

blank('');
blank('   ');
blank(null);
blank(collect());

// true

blank(0);
blank(true);
blank(false);

// false

blank의 반대는, filled 메소드를 참고하십시오.

cache() {#collection-method}

cache 함수는 캐시로 부터 값을 가져오는데 사용할 수 있습니다. 캐시에서 주어진 키가 존재하지 않는 경우, 옵션으로 전달된 기본값(두번째인자)가 반환됩니다

$value = cache('key');

$value = cache('key', 'default');

함수에 키 / 값으로 된 배열을 전달하여 캐시에 아이템을 추가할 수 있습니다. 또한 캐시에 값이 얼마나 유지되어야 하는지에 대한 시간(분)을 숫자로 전달할 수도 있습니다.

cache(['key' => 'value'], 5);

cache(['key' => 'value'], now()->addSeconds(10));

class_uses_recursive() {#collection-method}

class_uses_recursive 함수는 모든 부모 클래스가 사용하는 trait를 포함하여 클래스가 사용하는 모든 trait을 반환합니다:

$traits = class_uses_recursive(App\User::class);

collect() {#collection-method}

collect 함수는 주어진 값으로부터 collection 인스턴스를 생성합니다:

$collection = collect(['taylor', 'abigail']);

config() {#collection-method}

config 함수는 설정 변수의 값을 가져옵니다. 설정 값은 파일명과 접근하고자 하는 옵션을 포함하는 "점(.)" 문법(syntax)를 사용하여 접근할 수 있습니다. 설정 옵션이 존재하지 않는다면 지정된 기본값이 반환됩니다:

$value = config('app.timezone');

$value = config('app.timezone', $default);

런타임에 설정 값을 키 / 값 형태로 전달하여 값을 설정할 수도 있습니다:

config(['app.debug' => true]);

cookie() {#collection-method}

cookie 함수는 새로운 쿠키 인스턴스를 생성합니다:

$cookie = cookie('name', 'value', $minutes);

csrf_field() {#collection-method}

csrf_field 함수는 CSRF 토큰 값을 포함하는 HTML hidden Input 필드를 생성합니다. 예를 들어 Blade syntax에서 사용할 수 있습니다:

{{ csrf_field() }}

csrf_token() {#collection-method}

csrf_token 함수는 현재 CSRF 토큰의 값을 조회합니다:

$token = csrf_token();

dd() {#collection-method}

dd 함수는 주어진 변수들을 Dump 처리하고 스크립트의 실행을 중단합니다:

dd($value);

dd($value1, $value2, $value3, ...);

스크립트 실행을 중단하고 싶지 않다면, dump 함수를 사용하십시오:

decrypt() {#collection-method}

decrypt 함수는 라라벨의 encrypter를 사용하여 주어진 값을 복호화 합니다:

$decrypted = decrypt($encrypted_value);

dispatch() {#collection-method}

dispatch 함수는 라라벨의 job queue에 주어진 job을 추가합니다:

dispatch(new App\Jobs\SendEmails);

dispatch_now() {#collection-method}

dispatch_now 함수는 주어진 job을 즉시 실행하고 handle 메소드의 값을 반환합니다:

$result = dispatch_now(new App\Jobs\SendEmails);

dump() {#collection-method}

dump 함수는 주어진 변수의 값을 덤프하여 표시합니다:

dump($value);

dump($value1, $value2, $value3, ...);

변수읙 값을 표시한 다음에 스크립트의 실행을 멈추고자 한다면, dd함수를 사용하십시오.

encrypt() {#collection-method}

encrypt 함수는 라라벨의 encrypter를 사용하여 주어진 값을 암호화합니다:

$encrypted = encrypt($unencrypted_value);

env() {#collection-method}

env 함수는 환경변수의 값을 가져오거나 기본값을 조회합니다:

$env = env('APP_ENV');

// Returns 'production' if APP_ENV is not set...
$env = env('APP_ENV', 'production');

{note} 배포과정에서 config:cache 명령어를 실행했다면, 설정 파일안에서 env 함수를 호출한 부분이 있는지 확인해야 합니다. 설정이 캐싱되고 나면, .env 파일은 로드하지 않고, 모든 env 함수는 null을 반환합니다.

event() {#collection-method}

event 함수는 주어진 event를 리스너들에게 보냅니다:

event(new UserRegistered($user));

factory() {#collection-method}

factory 함수는 주어진 클래스, 이름, 양을 위한 모델 팩토리 빌더를 생성합니다. testing이나 seeding 중에 이용할 수 있습니다:

$user = factory(App\User::class)->make();

filled() {#collection-method}

filled 함수는 주어진 값이 "빈값"이 아닌지 판별하여 결과를 반환합니다:

filled(0);
filled(true);
filled(false);

// true

filled('');
filled('   ');
filled(null);
filled(collect());

// false

filled의 반대는, blank 메소드를 확인하십시오.

info() {#collection-method}

info 함수는 로그에 정보를 기록합니다:

info('Some helpful information!');

문맥에대한 데이터를 함수에 배열로 전달할 수도 있습니다:

info('User login attempt failed.', ['id' => $user->id]);

logger() {#collection-method}

logger 함수는 로그debug 로그 레벨을 기록하는데 사용합니다:

logger('Debug message');

문맥에대한 데이터를 함수에 배열로 전달할 수도 있습니다:

logger('User has logged in.', ['id' => $user->id]);

함수에 아무런 값이 전달되지 않으면 logger 인스턴스가 반환됩니다:

logger()->error('You are not allowed here.');

method_field() {#collection-method}

method_field 함수는 HTTP 메소드 형식의 가짜(spoof) 값을 포함하는 HTML hidden Input 필드를 생성합니다. 예를 들어 Blade syntax에서 사용할 수 있습니다:

<form method="POST">
    {{ method_field('DELETE') }}
</form>

now() {#collection-method}

now 함수는 현재 시간을 기반으로한 Illuminate\Support\Carbon 인스턴스를 생성합니다:

$now = now();

old() {#collection-method}

old 함수는 세션에 저장된 이전 입력값(flashed)을 조회합니다: $value = old('value');

$value = old('value', 'default');

optional() {#collection-method}

optional 함수는 인자를 전달받아 해당 객체의 프로퍼티에 엑세스 합니다. 지정된 객체가 null 이라면, 프로퍼티에 엑세스 할 때 에러를 유발하는 대신에 null 을 반환합니다:

return optional($user->address)->street;

{!! old('name', optional($user)->name) !!}

또한 반환받은 객체에 메소드를 호출할수도 있습니다. 프로퍼티에 엑세스 하는 것과 같이, 주어진 객체가 null 이라면, 메소드 호출은 에러를 유발하는 대신에 null을 반환합니다:

return optional($user)->getTwitterProfile();

호출하려는 메소드가 객체에 실제로 존재하지 않는, 클로저를 optional 함수의 두번째 인자로 전달 할 수 있습니다:

return optional(User::find($id), function ($user) {
    return TwitterApi::findUser($user->twitter_id);
});

주어진 객체가 null이 아니라면, 클로저가 호출되어 결과값을 반환합니다. 만약 주어진 객체가 실제로 null 이라면, 클로저는 호출되지 않고 optional 헬퍼함수는 에러를 유발하는 대신에 null을 반환합니다.

policy() {#collection-method}

policy 메소도는 주어진 클래스를 위한 policy 인스턴스를 조회합니다:

$policy = policy(App\User::class);

redirect() {#collection-method}

redirect 함수는 리다이렉트 HTTP response-응답을 반환하거나, 인자 없이 호출되는 경우 리디렉터 인스턴스를 반환합니다:

return redirect($to = null, $status = 302, $headers = [], $secure = null);

return redirect('/home');

return redirect()->route('route.name');

report() {#collection-method}

report 함수는 exception 핸들러report 메소드를 사용하여 exception-예외를 보고합니다:

report($e);

request() {#collection-method}

request 함수는 현재의 요청 인스턴스를 반환하거나 입력 아이템을 가져옵니다:

$request = request();

$value = request('key', $default);

rescue() {#collection-method}

rescue 함수는 주어진 클로저를 실행하고, 실행중 발생하는 예외-exception을 받아냅니다. catch 된 모든 예외-exception은 exception 핸들러report 메소드로 전달되지만, request-요청 에 대한 처리는 계속됩니다:

return rescue(function () {
    return $this->method();
});

rescue 함수에는 두번째 인자를 전달 할 수 있는데, 이 인자는 클로저를 실행하는 동안 예외-exception가 발생하면 반환된 "기본값" 입니다:

return rescue(function () {
    return $this->method();
}, false);

return rescue(function () {
    return $this->method();
}, function () {
    return $this->failure();
});

resolve() {#collection-method}

resolve 함수는 서비스 컨테이너를 사용하여 주어진 클래스 또는 인터페이스를 의존성 해결하여 인스턴스를 반환합니다:

$api = resolve('HelpSpot\API');

response() {#collection-method}

response 함수는 응답 인스턴스를 생성하거나 응답 팩토리의 인스턴스를 가져옵니다:

return response('Hello World', 200, $headers);

return response()->json(['foo' => 'bar'], 200, $headers);

retry() {#collection-method}

retry 함수는 주어진 최대 횟수가 될 때까지 주어진 콜백을 실행하려고 시도합니다. 콜백이 예외-exception를 던지지 않는다면, 결과 값이 반환됩니다. 콜백이 예외-exception를 던지면 자동으로 다시 시도됩니다. 최대 재시도 횟수를 초과하면 예외가 던져집니다.

return retry(5, function () {
    // Attempt 5 times while resting 100ms in between attempts...
}, 100);

session() {#collection-method}

session 함수는 세션 값을 얻거나 지정하는 데에 사용할 수 있습니다.

$value = session('key');

키 / 값 쌍들의 배열을 함수로 전달하여 값을 설정할 수 있습니다:

session(['chairs' => 7, 'instruments' => 3]);

함수에 아무런 값도 전달되지 않는다면 세션 스토어가 반환됩니다:

$value = session()->get('key');

session()->put('key', $value);

tap() {#collection-method}

tap 함수는 임의의 $value 와 클로저 두개의 인자를 받아들입니다. $value 는 클로저에 전달되어 tap 함수에 의해서 반환됩니다. 반환되는 값은 클로저와 무관합니다:

$user = tap(User::first(), function ($user) {
    $user->name = 'taylor';

    $user->save();
});

tap 함수에 클로저를 전달하지 않는다면, 주어진 $value 에 모든 메소드를 호출할 수 있습니다. 메소드에서 반환하는 값은 메소드가 실제로 정의해서 반환하는 $value 와는 관계없이 항상 $value 가 됩니다. 예를 들어 Eloquent update 메소드는 일반적으로 정수값을 반환하지만, tap 메소드를 통해서 update 메소드를 호출을 체이닝하면 메소드가 모델 그 자체를 반환하도록 할 수 있습니다:

$user = tap($user)->update([
    'name' => $name,
    'email' => $email,
]);

today() {#collection-method}

today 함수는 현재 날짜를 기준으로한 Illuminate\Support\Carbon 인스턴스를 생성합니다:

$today = today();

throw_if() {#collection-method}

throw_if 함수는 주어진 결과가 true 인 경우에 주어진 exception-예외를 던집니다:

throw_if(! Auth::user()->isAdmin(), AuthorizationException::class);

throw_if(
    ! Auth::user()->isAdmin(),
    AuthorizationException::class,
    'You are not allowed to access this page'
);

throw_unless() {#collection-method}

throw_unless 함수는 주어진 결과가 false 인 경우에 주어진 exception-예외를 던집니다:

throw_unless(Auth::user()->isAdmin(), AuthorizationException::class);

throw_unless(
    Auth::user()->isAdmin(),
    AuthorizationException::class,
    'You are not allowed to access this page'
);

trait_uses_recursive() {#collection-method}

trait_uses_recursive 함수는 해당 trait에서 사용된 모든 trait을 반환합니다:

$traits = trait_uses_recursive(\Illuminate\Notifications\Notifiable::class);

transform() {#collection-method}

transform 함수는 주어진 값이 빈값이 아닌 경우에 Closure를 실행하고 Closure의 결과를 반환합니다:

$callback = function ($value) {
    return $value * 2;
};

$result = transform(5, $callback);

// 10

세번째 인자로 기본값 또는 Closure 가 전달될 수 있습니다. 이 값은 첫번째 인자가 빈값인 경우 반환됩니다:

$result = transform(null, $callback, 'The value is blank');

// The value is blank

validator() {#collection-method}

validator 함수는 주어진 인자를 통해서 새로운 validator 인스턴스를 생성합니다. 보다 편리하게 Validator 파사드를 사용할 수도 있습니다:

$validator = validator($data, $rules, $messages);

value() {#collection-method}

value 함수는 자신에게 주어진 값을 그대로 반환합니다. 그렇지만 함수에 Closure를 전달하면 Closure가 실행되고 그 결과물이 반환됩니다:

$result = value(true);

// true

$result = value(function () {
    return false;
});

// false

view() {#collection-method}

view 함수는 view 인스턴스를 조회합니다:

return view('auth.login');

with() {#collection-method}

with 함수는 자신에게 주어진 값을 그대로 반환합니다. 만약 함수에 두번째 인자로 Closure 가 전달되면, Closure 가 실행되어 그 결과를 반환합니다:

$callback = function ($value) {
    return (is_numeric($value)) ? $value * 2 : 0;
};

$result = with(5, $callback);

// 10

$result = with(null, $callback);

// 0

$result = with(5, null);

// 5