헬퍼

소개

Laravel에는 다양한 전역 "헬퍼" PHP 함수가 포함되어 있습니다. 이 함수들 중 다수는 프레임워크 자체에서 사용되지만, 편리하다고 생각되면 여러분의 애플리케이션에서도 자유롭게 사용할 수 있습니다.

사용 가능한 메서드

배열 & 객체

기타

배열 & 객체

`Arr::accessible()`

Arr::accessible 메서드는 주어진 값이 배열로 접근 가능한지 여부를 판단합니다:

php

use Illuminate\Support\Arr;
use Illuminate\Support\Collection;

$isAccessible = Arr::accessible(['a' => 1, 'b' => 2]);

// true

$isAccessible = Arr::accessible(new Collection);

// true

$isAccessible = Arr::accessible('abc');

// false

$isAccessible = Arr::accessible(new stdClass);

// false

`Arr::add()`

Arr::add 메서드는 주어진 키가 배열에 존재하지 않거나 null로 설정되어 있을 때, 해당 키/값 쌍을 배열에 추가합니다:

php

use Illuminate\Support\Arr;

$array = Arr::add(['name' => 'Desk'], 'price', 100);

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

$array = Arr::add(['name' => 'Desk', 'price' => null], 'price', 100);

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

`Arr::array()`

Arr::array 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다(Arr::get()과 동일). 단, 요청한 값이 array가 아니면 InvalidArgumentException을 발생시킵니다:

use Illuminate\Support\Arr;

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

$value = Arr::array($array, 'languages');

// ['PHP', 'Ruby']

$value = Arr::array($array, 'name');

// throws InvalidArgumentException

`Arr::boolean()`

Arr::boolean 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다(Arr::get()과 동일). 단, 요청한 값이 boolean이 아니면 InvalidArgumentException을 발생시킵니다:

use Illuminate\Support\Arr;

$array = ['name' => 'Joe', 'available' => true];

$value = Arr::boolean($array, 'available');

// true

$value = Arr::boolean($array, 'name');

// throws InvalidArgumentException

`Arr::collapse()`

Arr::collapse 메서드는 배열의 배열을 하나의 배열로 평탄화합니다:

php

use Illuminate\Support\Arr;

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

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

`Arr::crossJoin()`

Arr::crossJoin 메서드는 주어진 배열들을 교차 조인하여 가능한 모든 순열의 데카르트 곱을 반환합니다:

php

use Illuminate\Support\Arr;

$matrix = Arr::crossJoin([1, 2], ['a', 'b']);

/*
    [
        [1, 'a'],
        [1, 'b'],
        [2, 'a'],
        [2, 'b'],
    ]
*/

$matrix = Arr::crossJoin([1, 2], ['a', 'b'], ['I', 'II']);

/*
    [
        [1, 'a', 'I'],
        [1, 'a', 'II'],
        [1, 'b', 'I'],
        [1, 'b', 'II'],
        [2, 'a', 'I'],
        [2, 'a', 'II'],
        [2, 'b', 'I'],
        [2, 'b', 'II'],
    ]
*/

`Arr::divide()`

Arr::divide 메서드는 주어진 배열의 키와 값을 각각 별도의 배열로 반환합니다:

php

use Illuminate\Support\Arr;

[$keys, $values] = Arr::divide(['name' => 'Desk']);

// $keys: ['name']

// $values: ['Desk']

`Arr::dot()`

Arr::dot 메서드는 다차원 배열을 "dot" 표기법을 사용하여 깊이를 나타내는 단일 레벨 배열로 평탄화합니다:

php

use Illuminate\Support\Arr;

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

$flattened = Arr::dot($array);

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

`Arr::except()`

Arr::except 메서드는 주어진 키/값 쌍을 배열에서 제거합니다:

php

use Illuminate\Support\Arr;

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

$filtered = Arr::except($array, ['price']);

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

`Arr::exists()`

Arr::exists 메서드는 주어진 키가 배열에 존재하는지 확인합니다:

php

use Illuminate\Support\Arr;

$array = ['name' => 'John Doe', 'age' => 17];

$exists = Arr::exists($array, 'name');

// true

$exists = Arr::exists($array, 'salary');

// false

`Arr::first()`

Arr::first 메서드는 주어진 조건을 통과하는 배열의 첫 번째 요소를 반환합니다:

php

use Illuminate\Support\Arr;

$array = [100, 200, 300];

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

// 200

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

php

use Illuminate\Support\Arr;

$first = Arr::first($array, $callback, $default);

`Arr::flatten()`

Arr::flatten 메서드는 다차원 배열을 단일 레벨 배열로 평탄화합니다:

php

use Illuminate\Support\Arr;

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

$flattened = Arr::flatten($array);

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

`Arr::float()`

Arr::float 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다(Arr::get()과 동일). 단, 요청한 값이 float가 아니면 InvalidArgumentException을 발생시킵니다:

use Illuminate\Support\Arr;

$array = ['name' => 'Joe', 'balance' => 123.45];

$value = Arr::float($array, 'balance');

// 123.45

$value = Arr::float($array, 'name');

// throws InvalidArgumentException

`Arr::forget()`

Arr::forget 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 주어진 키/값 쌍을 제거합니다:

php

use Illuminate\Support\Arr;

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

Arr::forget($array, 'products.desk');

// ['products' => []]

`Arr::from()`

Arr::from 메서드는 다양한 입력 타입을 일반 PHP 배열로 변환합니다. 배열, 객체, 그리고 Arrayable, Enumerable, Jsonable, JsonSerializable 등 Laravel의 여러 인터페이스를 지원합니다. 또한 Traversable 및 WeakMap 인스턴스도 처리합니다:

php

use Illuminate\Support\Arr;

Arr::from((object) ['foo' => 'bar']); // ['foo' => 'bar']

class TestJsonableObject implements Jsonable
{
    public function toJson($options = 0)
    {
        return json_encode(['foo' => 'bar']);
    }
}

Arr::from(new TestJsonableObject); // ['foo' => 'bar']

`Arr::get()`

Arr::get 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다:

php

use Illuminate\Support\Arr;

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

$price = Arr::get($array, 'products.desk.price');

// 100

Arr::get 메서드는 기본값도 받을 수 있으며, 지정한 키가 배열에 없을 경우 이 값이 반환됩니다:

php

use Illuminate\Support\Arr;

$discount = Arr::get($array, 'products.desk.discount', 0);

// 0

`Arr::has()`

Arr::has 메서드는 "dot" 표기법을 사용하여 배열에 주어진 항목 또는 항목들이 존재하는지 확인합니다:

php

use Illuminate\Support\Arr;

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

$contains = Arr::has($array, 'product.name');

// true

$contains = Arr::has($array, ['product.price', 'product.discount']);

// false

`Arr::hasAll()`

Arr::hasAll 메서드는 "dot" 표기법을 사용하여 주어진 배열에 지정된 모든 키가 존재하는지 확인합니다:

php

use Illuminate\Support\Arr;

$array = ['name' => 'Taylor', 'language' => 'PHP'];

Arr::hasAll($array, ['name']); // true
Arr::hasAll($array, ['name', 'language']); // true
Arr::hasAll($array, ['name', 'IDE']); // false

`Arr::hasAny()`

Arr::hasAny 메서드는 "dot" 표기법을 사용하여 주어진 집합 중 하나라도 배열에 존재하는지 확인합니다:

php

use Illuminate\Support\Arr;

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

$contains = Arr::hasAny($array, 'product.name');

// true

$contains = Arr::hasAny($array, ['product.name', 'product.discount']);

// true

$contains = Arr::hasAny($array, ['category', 'product.discount']);

// false

`Arr::integer()`

Arr::integer 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다(Arr::get()과 동일). 단, 요청한 값이 int가 아니면 InvalidArgumentException을 발생시킵니다:

use Illuminate\Support\Arr;

$array = ['name' => 'Joe', 'age' => 42];

$value = Arr::integer($array, 'age');

// 42

$value = Arr::integer($array, 'name');

// throws InvalidArgumentException

`Arr::isAssoc()`

Arr::isAssoc 메서드는 주어진 배열이 연관 배열(associative array)인지 여부를 반환합니다. 배열의 키가 0부터 시작하는 연속된 숫자가 아니면 "연관 배열"로 간주합니다:

php

use Illuminate\Support\Arr;

$isAssoc = Arr::isAssoc(['product' => ['name' => 'Desk', 'price' => 100]]);

// true

$isAssoc = Arr::isAssoc([1, 2, 3]);

// false

`Arr::isList()`

Arr::isList 메서드는 주어진 배열의 키가 0부터 시작하는 연속된 정수일 경우 true를 반환합니다:

php

use Illuminate\Support\Arr;

$isList = Arr::isList(['foo', 'bar', 'baz']);

// true

$isList = Arr::isList(['product' => ['name' => 'Desk', 'price' => 100]]);

// false

`Arr::join()`

Arr::join 메서드는 배열 요소를 문자열로 결합합니다. 두 번째 인자를 사용하여 마지막 요소의 결합 문자열을 지정할 수도 있습니다:

php

use Illuminate\Support\Arr;

$array = ['Tailwind', 'Alpine', 'Laravel', 'Livewire'];

$joined = Arr::join($array, ', ');

// Tailwind, Alpine, Laravel, Livewire

$joined = Arr::join($array, ', ', ' and ');

// Tailwind, Alpine, Laravel and Livewire

`Arr::keyBy()`

Arr::keyBy 메서드는 주어진 키로 배열을 키잉합니다. 동일한 키를 가진 항목이 여러 개 있으면 마지막 항목만 새 배열에 나타납니다:

php

use Illuminate\Support\Arr;

$array = [
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
];

$keyed = Arr::keyBy($array, 'product_id');

/*
    [
        'prod-100' => ['product_id' => 'prod-100', 'name' => 'Desk'],
        'prod-200' => ['product_id' => 'prod-200', 'name' => 'Chair'],
    ]
*/

`Arr::last()`

Arr::last 메서드는 주어진 조건을 통과하는 배열의 마지막 요소를 반환합니다:

php

use Illuminate\Support\Arr;

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

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

// 300

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

php

use Illuminate\Support\Arr;

$last = Arr::last($array, $callback, $default);

`Arr::map()`

Arr::map 메서드는 배열을 순회하며 각 값과 키를 콜백에 전달합니다. 배열 값은 콜백에서 반환된 값으로 대체됩니다:

php

use Illuminate\Support\Arr;

$array = ['first' => 'james', 'last' => 'kirk'];

$mapped = Arr::map($array, function (string $value, string $key) {
    return ucfirst($value);
});

// ['first' => 'James', 'last' => 'Kirk']

`Arr::mapSpread()`

Arr::mapSpread 메서드는 배열을 순회하며 각 중첩 항목 값을 콜백에 전달합니다. 콜백은 항목을 수정하여 반환할 수 있으며, 수정된 항목의 새 배열이 생성됩니다:

php

use Illuminate\Support\Arr;

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

$mapped = Arr::mapSpread($array, function (int $even, int $odd) {
    return $even + $odd;
});

/*
    [1, 5, 9, 13, 17]
*/

`Arr::mapWithKeys()`

Arr::mapWithKeys 메서드는 배열을 순회하며 각 값을 콜백에 전달합니다. 콜백은 단일 키/값 쌍을 포함하는 연관 배열을 반환해야 합니다:

php

use Illuminate\Support\Arr;

$array = [
    [
        'name' => 'John',
        'department' => 'Sales',
        'email' => '[email protected]',
    ],
    [
        'name' => 'Jane',
        'department' => 'Marketing',
        'email' => '[email protected]',
    ]
];

$mapped = Arr::mapWithKeys($array, function (array $item, int $key) {
    return [$item['email'] => $item['name']];
});

/*
    [
        '[email protected]' => 'John',
        '[email protected]' => 'Jane',
    ]
*/

`Arr::only()`

Arr::only 메서드는 주어진 배열에서 지정한 키/값 쌍만 반환합니다:

php

use Illuminate\Support\Arr;

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

$slice = Arr::only($array, ['name', 'price']);

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

`Arr::partition()`

Arr::partition 메서드는 PHP 배열 구조 분해와 결합하여, 주어진 조건을 통과하는 요소와 그렇지 않은 요소를 분리할 수 있습니다:

php

<?php

use Illuminate\Support\Arr;

$numbers = [1, 2, 3, 4, 5, 6];

[$underThree, $equalOrAboveThree] = Arr::partition($numbers, function (int $i) {
    return $i < 3;
});

dump($underThree);

// [1, 2]

dump($equalOrAboveThree);

// [3, 4, 5, 6]

`Arr::pluck()`

Arr::pluck 메서드는 배열에서 주어진 키의 모든 값을 가져옵니다:

php

use Illuminate\Support\Arr;

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

$names = Arr::pluck($array, 'developer.name');

// ['Taylor', 'Abigail']

결과 리스트의 키를 지정할 수도 있습니다:

php

use Illuminate\Support\Arr;

$names = Arr::pluck($array, 'developer.name', 'developer.id');

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

`Arr::prepend()`

Arr::prepend 메서드는 배열의 맨 앞에 항목을 추가합니다:

php

use Illuminate\Support\Arr;

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

$array = Arr::prepend($array, 'zero');

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

필요하다면 값에 사용할 키를 지정할 수도 있습니다:

php

use Illuminate\Support\Arr;

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

$array = Arr::prepend($array, 'Desk', 'name');

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

`Arr::prependKeysWith()`

Arr::prependKeysWith는 연관 배열의 모든 키 이름 앞에 지정한 접두사를 붙입니다:

php

use Illuminate\Support\Arr;

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

$keyed = Arr::prependKeysWith($array, 'product.');

/*
    [
        'product.name' => 'Desk',
        'product.price' => 100,
    ]
*/

`Arr::pull()`

Arr::pull 메서드는 배열에서 키/값 쌍을 반환하고 제거합니다:

php

use Illuminate\Support\Arr;

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

$name = Arr::pull($array, 'name');

// $name: Desk

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

키가 존재하지 않을 경우 반환할 기본값을 세 번째 인자로 전달할 수 있습니다:

php

use Illuminate\Support\Arr;

$value = Arr::pull($array, $key, $default);

`Arr::query()`

Arr::query 메서드는 배열을 쿼리 문자열로 변환합니다:

php

use Illuminate\Support\Arr;

$array = [
    'name' => 'Taylor',
    'order' => [
        'column' => 'created_at',
        'direction' => 'desc'
    ]
];

Arr::query($array);

// name=Taylor&order[column]=created_at&order[direction]=desc

`Arr::random()`

Arr::random 메서드는 배열에서 임의의 값을 반환합니다:

php

use Illuminate\Support\Arr;

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

$random = Arr::random($array);

// 4 - (임의로 추출됨)

반환할 항목의 개수를 두 번째 인자로 지정할 수도 있습니다. 이 인자를 제공하면 하나만 원해도 배열로 반환됩니다:

php

use Illuminate\Support\Arr;

$items = Arr::random($array, 2);

// [2, 5] - (임의로 추출됨)

`Arr::reject()`

Arr::reject 메서드는 주어진 클로저를 사용하여 배열에서 항목을 제거합니다:

php

use Illuminate\Support\Arr;

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

$filtered = Arr::reject($array, function (string|int $value, int $key) {
    return is_string($value);
});

// [0 => 100, 2 => 300, 4 => 500]

`Arr::select()`

Arr::select 메서드는 배열에서 값을 선택합니다:

php

use Illuminate\Support\Arr;

$array = [
    ['id' => 1, 'name' => 'Desk', 'price' => 200],
    ['id' => 2, 'name' => 'Table', 'price' => 150],
    ['id' => 3, 'name' => 'Chair', 'price' => 300],
];

Arr::select($array, ['name', 'price']);

// [['name' => 'Desk', 'price' => 200], ['name' => 'Table', 'price' => 150], ['name' => 'Chair', 'price' => 300]]

`Arr::set()`

Arr::set 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열 내에 값을 설정합니다:

php

use Illuminate\Support\Arr;

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

Arr::set($array, 'products.desk.price', 200);

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

`Arr::shuffle()`

Arr::shuffle 메서드는 배열의 항목을 무작위로 섞습니다:

php

use Illuminate\Support\Arr;

$array = Arr::shuffle([1, 2, 3, 4, 5]);

// [3, 2, 5, 1, 4] - (무작위로 생성됨)

`Arr::sole()`

Arr::sole 메서드는 주어진 클로저를 사용하여 배열에서 단일 값을 가져옵니다. 조건을 만족하는 값이 여러 개면 Illuminate\Support\MultipleItemsFoundException 예외가, 하나도 없으면 Illuminate\Support\ItemNotFoundException 예외가 발생합니다:

php

use Illuminate\Support\Arr;

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

$value = Arr::sole($array, fn (string $value) => $value === 'Desk');

// 'Desk'

`Arr::sort()`

Arr::sort 메서드는 배열을 값 기준으로 정렬합니다:

php

use Illuminate\Support\Arr;

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

$sorted = Arr::sort($array);

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

클로저의 결과로 배열을 정렬할 수도 있습니다:

php

use Illuminate\Support\Arr;

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

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

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

`Arr::sortDesc()`

Arr::sortDesc 메서드는 배열을 값 기준으로 내림차순 정렬합니다:

php

use Illuminate\Support\Arr;

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

$sorted = Arr::sortDesc($array);

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

클로저의 결과로 배열을 정렬할 수도 있습니다:

php

use Illuminate\Support\Arr;

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

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

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

`Arr::sortRecursive()`

Arr::sortRecursive 메서드는 숫자 인덱스 하위 배열에는 sort 함수를, 연관 하위 배열에는 ksort 함수를 사용하여 배열을 재귀적으로 정렬합니다:

php

use Illuminate\Support\Arr;

$array = [
    ['Roman', 'Taylor', 'Li'],
    ['PHP', 'Ruby', 'JavaScript'],
    ['one' => 1, 'two' => 2, 'three' => 3],
];

$sorted = Arr::sortRecursive($array);

/*
    [
        ['JavaScript', 'PHP', 'Ruby'],
        ['one' => 1, 'three' => 3, 'two' => 2],
        ['Li', 'Roman', 'Taylor'],
    ]
*/

내림차순으로 정렬하려면 Arr::sortRecursiveDesc 메서드를 사용할 수 있습니다.

php

$sorted = Arr::sortRecursiveDesc($array);

`Arr::string()`

Arr::string 메서드는 "dot" 표기법을 사용하여 깊이 중첩된 배열에서 값을 가져옵니다(Arr::get()과 동일). 단, 요청한 값이 string이 아니면 InvalidArgumentException을 발생시킵니다:

use Illuminate\Support\Arr;

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

$value = Arr::string($array, 'name');

// Joe

$value = Arr::string($array, 'languages');

// throws InvalidArgumentException

`Arr::take()`

Arr::take 메서드는 지정한 개수만큼의 항목을 가진 새 배열을 반환합니다:

php

use Illuminate\Support\Arr;

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

$chunk = Arr::take($array, 3);

// [0, 1, 2]

음수를 전달하면 배열의 끝에서부터 지정한 개수만큼의 항목을 가져옵니다:

php

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

$chunk = Arr::take($array, -2);

// [4, 5]

`Arr::toCssClasses()`

Arr::toCssClasses 메서드는 조건부로 CSS 클래스 문자열을 컴파일합니다. 배열의 키는 추가할 클래스(들)를, 값은 불리언 표현식을 나타냅니다. 배열 요소의 키가 숫자라면 항상 렌더링된 클래스 목록에 포함됩니다:

php

use Illuminate\Support\Arr;

$isActive = false;
$hasError = true;

$array = ['p-4', 'font-bold' => $isActive, 'bg-red' => $hasError];

$classes = Arr::toCssClasses($array);

/*
    'p-4 bg-red'
*/

`Arr::toCssStyles()`

Arr::toCssStyles는 조건부로 CSS 스타일 문자열을 컴파일합니다. 배열의 키는 추가할 스타일(들)을, 값은 불리언 표현식을 나타냅니다. 배열 요소의 키가 숫자라면 항상 렌더링된 스타일 목록에 포함됩니다:

php

use Illuminate\Support\Arr;

$hasColor = true;

$array = ['background-color: blue', 'color: blue' => $hasColor];

$classes = Arr::toCssStyles($array);

/*
    'background-color: blue; color: blue;'
*/

이 메서드는 Laravel의 Blade 컴포넌트의 속성 백과 클래스 병합 및 @class Blade 지시어 기능을 지원합니다.

`Arr::undot()`

Arr::undot 메서드는 "dot" 표기법을 사용하는 단일 차원 배열을 다차원 배열로 확장합니다:

php

use Illuminate\Support\Arr;

$array = [
    'user.name' => 'Kevin Malone',
    'user.occupation' => 'Accountant',
];

$array = Arr::undot($array);

// ['user' => ['name' => 'Kevin Malone', 'occupation' => 'Accountant']]

`Arr::where()`

Arr::where 메서드는 주어진 클로저를 사용하여 배열을 필터링합니다:

php

use Illuminate\Support\Arr;

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

$filtered = Arr::where($array, function (string|int $value, int $key) {
    return is_string($value);
});

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

`Arr::whereNotNull()`

Arr::whereNotNull 메서드는 주어진 배열에서 모든 null 값을 제거합니다:

php

use Illuminate\Support\Arr;

$array = [0, null];

$filtered = Arr::whereNotNull($array);

// [0 => 0]

`Arr::wrap()`

Arr::wrap 메서드는 주어진 값을 배열로 감쌉니다. 값이 이미 배열이라면 수정 없이 반환됩니다:

php

use Illuminate\Support\Arr;

$string = 'Laravel';

$array = Arr::wrap($string);

// ['Laravel']

값이 null이면 빈 배열이 반환됩니다:

php

use Illuminate\Support\Arr;

$array = Arr::wrap(null);

// []

`data_fill()`

data_fill 함수는 "dot" 표기법을 사용하여 중첩 배열 또는 객체 내에 누락된 값을 설정합니다:

php

$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]]]

이 함수는 와일드카드로 별표(*)도 허용하며, 대상에 맞게 값을 채웁니다:

php

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

data_get 함수는 "dot" 표기법을 사용하여 중첩 배열 또는 객체에서 값을 가져옵니다:

php

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

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

// 100

data_get 함수는 기본값도 받을 수 있으며, 지정한 키가 없을 경우 이 값이 반환됩니다:

php

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

// 0

이 함수는 별표(*) 와일드카드도 허용하며, 배열 또는 객체의 모든 키를 대상으로 할 수 있습니다:

php

$data = [
    'product-one' => ['name' => 'Desk 1', 'price' => 100],
    'product-two' => ['name' => 'Desk 2', 'price' => 150],
];

data_get($data, '*.name');

// ['Desk 1', 'Desk 2'];

{first}와 {last} 플레이스홀더를 사용하여 배열의 첫 번째 또는 마지막 항목을 가져올 수 있습니다:

php

$flight = [
    'segments' => [
        ['from' => 'LHR', 'departure' => '9:00', 'to' => 'IST', 'arrival' => '15:00'],
        ['from' => 'IST', 'departure' => '16:00', 'to' => 'PKX', 'arrival' => '20:00'],
    ],
];

data_get($flight, 'segments.{first}.arrival');

// 15:00

`data_set()`

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

php

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

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

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

이 함수는 별표(*) 와일드카드도 허용하며, 대상에 맞게 값을 설정합니다:

php

$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를 전달하세요:

php

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

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

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

`data_forget()`

data_forget 함수는 "dot" 표기법을 사용하여 중첩 배열 또는 객체 내의 값을 제거합니다:

php

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

data_forget($data, 'products.desk.price');

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

이 함수는 별표(*) 와일드카드도 허용하며, 대상에 맞게 값을 제거합니다:

php

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

data_forget($data, 'products.*.price');

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

`head()`

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

php

$array = [100, 200, 300];

$first = head($array);

// 100

`last()`

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

php

$array = [100, 200, 300];

$last = last($array);

// 300

숫자

`Number::abbreviate()`

Number::abbreviate 메서드는 단위를 축약한 사람이 읽기 쉬운 숫자 형식을 반환합니다:

php

use Illuminate\Support\Number;

$number = Number::abbreviate(1000);

// 1K

$number = Number::abbreviate(489939);

// 490K

$number = Number::abbreviate(1230000, precision: 2);

// 1.23M

`Number::clamp()`

Number::clamp 메서드는 주어진 숫자가 지정한 범위 내에 있도록 보장합니다. 숫자가 최소값보다 작으면 최소값을, 최대값보다 크면 최대값을 반환합니다:

php

use Illuminate\Support\Number;

$number = Number::clamp(105, min: 10, max: 100);

// 100

$number = Number::clamp(5, min: 10, max: 100);

// 10

$number = Number::clamp(10, min: 10, max: 100);

// 10

$number = Number::clamp(20, min: 10, max: 100);

// 20

`Number::currency()`

Number::currency 메서드는 주어진 값을 통화 문자열로 반환합니다:

php

use Illuminate\Support\Number;

$currency = Number::currency(1000);

// $1,000.00

$currency = Number::currency(1000, in: 'EUR');

// €1,000.00

$currency = Number::currency(1000, in: 'EUR', locale: 'de');

// 1.000,00 €

$currency = Number::currency(1000, in: 'EUR', locale: 'de', precision: 0);

// 1.000 €

`Number::defaultCurrency()`

Number::defaultCurrency 메서드는 Number 클래스에서 사용 중인 기본 통화를 반환합니다:

php

use Illuminate\Support\Number;

$currency = Number::defaultCurrency();

// USD

`Number::defaultLocale()`

Number::defaultLocale 메서드는 Number 클래스에서 사용 중인 기본 로케일을 반환합니다:

php

use Illuminate\Support\Number;

$locale = Number::defaultLocale();

// en

`Number::fileSize()`

Number::fileSize 메서드는 주어진 바이트 값을 파일 크기 문자열로 반환합니다:

php

use Illuminate\Support\Number;

$size = Number::fileSize(1024);

// 1 KB

$size = Number::fileSize(1024 * 1024);

// 1 MB

$size = Number::fileSize(1024, precision: 2);

// 1.00 KB

`Number::forHumans()`

Number::forHumans 메서드는 사람이 읽기 쉬운 숫자 형식을 반환합니다:

php

use Illuminate\Support\Number;

$number = Number::forHumans(1000);

// 1 thousand

$number = Number::forHumans(489939);

// 490 thousand

$number = Number::forHumans(1230000, precision: 2);

// 1.23 million

`Number::format()`

Number::format 메서드는 주어진 숫자를 로케일에 맞는 문자열로 포맷합니다:

php

use Illuminate\Support\Number;

$number = Number::format(100000);

// 100,000

$number = Number::format(100000, precision: 2);

// 100,000.00

$number = Number::format(100000.123, maxPrecision: 2);

// 100,000.12

$number = Number::format(100000, locale: 'de');

// 100.000

`Number::ordinal()`

Number::ordinal 메서드는 숫자의 서수(순서)를 반환합니다:

php

use Illuminate\Support\Number;

$number = Number::ordinal(1);

// 1st

$number = Number::ordinal(2);

// 2nd

$number = Number::ordinal(21);

// 21st

`Number::pairs()`

Number::pairs 메서드는 지정한 범위와 스텝 값에 따라 숫자 쌍(하위 범위) 배열을 생성합니다. 이 메서드는 큰 범위의 숫자를 더 작은 하위 범위로 나누는 데 유용합니다. 반환값은 각 쌍(하위 범위)을 나타내는 배열의 배열입니다:

php

use Illuminate\Support\Number;

$result = Number::pairs(25, 10);

// [[0, 9], [10, 19], [20, 25]]

$result = Number::pairs(25, 10, offset: 0);

// [[0, 10], [10, 20], [20, 25]]

`Number::percentage()`

Number::percentage 메서드는 주어진 값을 백분율 문자열로 반환합니다:

php

use Illuminate\Support\Number;

$percentage = Number::percentage(10);

// 10%

$percentage = Number::percentage(10, precision: 2);

// 10.00%

$percentage = Number::percentage(10.123, maxPrecision: 2);

// 10.12%

$percentage = Number::percentage(10, precision: 2, locale: 'de');

// 10,00%

`Number::spell()`

Number::spell 메서드는 주어진 숫자를 단어 문자열로 변환합니다:

php

use Illuminate\Support\Number;

$number = Number::spell(102);

// one hundred and two

$number = Number::spell(88, locale: 'fr');

// quatre-vingt-huit

after 인자를 사용하면 지정한 값 이후의 숫자만 단어로 변환할 수 있습니다:

php

$number = Number::spell(10, after: 10);

// 10

$number = Number::spell(11, after: 10);

// eleven

until 인자를 사용하면 지정한 값 이전의 숫자만 단어로 변환할 수 있습니다:

php

$number = Number::spell(5, until: 10);

// five

$number = Number::spell(10, until: 10);

// 10

`Number::spellOrdinal()`

Number::spellOrdinal 메서드는 숫자의 서수를 단어 문자열로 반환합니다:

php

use Illuminate\Support\Number;

$number = Number::spellOrdinal(1);

// first

$number = Number::spellOrdinal(2);

// second

$number = Number::spellOrdinal(21);

// twenty-first

`Number::trim()`

Number::trim 메서드는 소수점 뒤의 0을 제거합니다:

php

use Illuminate\Support\Number;

$number = Number::trim(12.0);

// 12

$number = Number::trim(12.30);

// 12.3

`Number::useLocale()`

Number::useLocale 메서드는 기본 숫자 로케일을 전역적으로 설정합니다. 이후 Number 클래스의 메서드에서 숫자와 통화 포맷에 영향을 줍니다:

php

use Illuminate\Support\Number;

/**
 * Bootstrap any application services.
 */
public function boot(): void
{
    Number::useLocale('de');
}

`Number::withLocale()`

Number::withLocale 메서드는 지정한 로케일로 주어진 클로저를 실행한 후, 원래 로케일로 복원합니다:

php

use Illuminate\Support\Number;

$number = Number::withLocale('de', function () {
    return Number::format(1500);
});

`Number::useCurrency()`

Number::useCurrency 메서드는 기본 숫자 통화를 전역적으로 설정합니다. 이후 Number 클래스의 메서드에서 통화 포맷에 영향을 줍니다:

php

use Illuminate\Support\Number;

/**
 * Bootstrap any application services.
 */
public function boot(): void
{
    Number::useCurrency('GBP');
}

`Number::withCurrency()`

Number::withCurrency 메서드는 지정한 통화로 주어진 클로저를 실행한 후, 원래 통화로 복원합니다:

php

use Illuminate\Support\Number;

$number = Number::withCurrency('GBP', function () {
    // ...
});

경로

`app_path()`

app_path 함수는 애플리케이션의 app 디렉터리에 대한 전체 경로를 반환합니다. 또한, 애플리케이션 디렉터리 기준의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = app_path();

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

`base_path()`

base_path 함수는 애플리케이션의 루트 디렉터리에 대한 전체 경로를 반환합니다. 또한, 프로젝트 루트 기준의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = base_path();

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

`config_path()`

config_path 함수는 애플리케이션의 config 디렉터리에 대한 전체 경로를 반환합니다. 또한, 설정 디렉터리 내의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = config_path();

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

`database_path()`

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

php

$path = database_path();

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

`lang_path()`

lang_path 함수는 애플리케이션의 lang 디렉터리에 대한 전체 경로를 반환합니다. 또한, 해당 디렉터리 내의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = lang_path();

$path = lang_path('en/messages.php');

NOTE

기본적으로 Laravel 애플리케이션 스켈레톤에는 lang 디렉터리가 포함되어 있지 않습니다. Laravel의 언어 파일을 커스터마이즈하려면 lang:publish Artisan 명령어로 퍼블리시할 수 있습니다.

`mix()`

mix 함수는 버전 관리된 Mix 파일의 경로를 반환합니다:

php

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

`public_path()`

public_path 함수는 애플리케이션의 public 디렉터리에 대한 전체 경로를 반환합니다. 또한, public 디렉터리 내의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = public_path();

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

`resource_path()`

resource_path 함수는 애플리케이션의 resources 디렉터리에 대한 전체 경로를 반환합니다. 또한, resources 디렉터리 내의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = resource_path();

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

`storage_path()`

storage_path 함수는 애플리케이션의 storage 디렉터리에 대한 전체 경로를 반환합니다. 또한, storage 디렉터리 내의 파일 경로를 생성할 때도 사용할 수 있습니다:

php

$path = storage_path();

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

URL

`action()`

action 함수는 주어진 컨트롤러 액션에 대한 URL을 생성합니다:

php

use App\Http\Controllers\HomeController;

$url = action([HomeController::class, 'index']);

메서드가 라우트 파라미터를 받는 경우, 두 번째 인자로 전달할 수 있습니다:

php

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

`asset()`

asset 함수는 요청의 현재 스킴(HTTP 또는 HTTPS)을 사용하여 에셋의 URL을 생성합니다:

php

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

.env 파일의 ASSET_URL 변수를 설정하여 에셋 URL 호스트를 구성할 수 있습니다. Amazon S3나 다른 CDN 등 외부 서비스에 에셋을 호스팅할 때 유용합니다:

php

// ASSET_URL=http://example.com/assets

$url = asset('img/photo.jpg'); // http://example.com/assets/img/photo.jpg

`route()`

route 함수는 이름이 지정된 라우트에 대한 URL을 생성합니다:

php

$url = route('route.name');

라우트가 파라미터를 받는 경우, 두 번째 인자로 전달할 수 있습니다:

php

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

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

php

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

`secure_asset()`

secure_asset 함수는 HTTPS를 사용하여 에셋의 URL을 생성합니다:

php

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

`secure_url()`

secure_url 함수는 주어진 경로에 대한 완전한 HTTPS URL을 생성합니다. 추가 URL 세그먼트는 두 번째 인자로 전달할 수 있습니다:

php

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

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

`to_route()`

to_route 함수는 이름이 지정된 라우트에 대한 리디렉션 HTTP 응답을 생성합니다:

php

return to_route('users.show', ['user' => 1]);

필요하다면, 리디렉션에 할당할 HTTP 상태 코드와 추가 응답 헤더를 세 번째, 네 번째 인자로 전달할 수 있습니다:

php

return to_route('users.show', ['user' => 1], 302, ['X-Framework' => 'Laravel']);

`uri()`

uri 함수는 주어진 URI에 대한 플루언트 URI 인스턴스를 생성합니다:

php

$uri = uri('https://example.com')
    ->withPath('/users')
    ->withQuery(['page' => 1])

uri 함수에 콜러블 컨트롤러와 메서드 쌍이 담긴 배열을 전달하면, 해당 컨트롤러 메서드의 라우트 경로에 대한 Uri 인스턴스를 생성합니다:

php

use App\Http\Controllers\UserController;

$uri = uri([UserController::class, 'show'], ['user' => $user])

컨트롤러가 인보커블일 경우, 컨트롤러 클래스명만 전달하면 됩니다:

php

use App\Http\Controllers\UserIndexController;

$uri = uri(UserIndexController::class);

uri 함수에 전달된 값이 이름이 지정된 라우트와 일치하면, 해당 라우트 경로에 대한 Uri 인스턴스가 생성됩니다:

php

$uri = uri('users.show', ['user' => $user]);

`url()`

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

php

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

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

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

php

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

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

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

기타

`abort()`

abort 함수는 HTTP 예외를 발생시키며, 예외 핸들러에 의해 렌더링됩니다:

php

abort(403);

예외의 메시지와 브라우저로 전송할 커스텀 HTTP 응답 헤더도 제공할 수 있습니다:

php

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

`abort_if()`

abort_if 함수는 주어진 불리언 표현식이 true일 때 HTTP 예외를 발생시킵니다:

php

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

abort 메서드와 마찬가지로, 예외의 응답 텍스트를 세 번째 인자로, 커스텀 응답 헤더 배열을 네 번째 인자로 전달할 수 있습니다.

`abort_unless()`

abort_unless 함수는 주어진 불리언 표현식이 false일 때 HTTP 예외를 발생시킵니다:

php

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

abort 메서드와 마찬가지로, 예외의 응답 텍스트를 세 번째 인자로, 커스텀 응답 헤더 배열을 네 번째 인자로 전달할 수 있습니다.

`app()`

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

php

$container = app();

클래스 또는 인터페이스 이름을 전달하여 컨테이너에서 해석할 수도 있습니다:

php

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

`auth()`

auth 함수는 인증기 인스턴스를 반환합니다. Auth 파사드의 대안으로 사용할 수 있습니다:

php

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

필요하다면 접근할 가드 인스턴스를 지정할 수도 있습니다:

php

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

`back()`

back 함수는 사용자의 이전 위치로 리디렉션 HTTP 응답을 생성합니다:

php

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

return back();

`bcrypt()`

bcrypt 함수는 주어진 값을 Bcrypt로 해시합니다. Hash 파사드의 대안으로 사용할 수 있습니다:

php

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

`blank()`

blank 함수는 주어진 값이 "비어있는지" 여부를 판단합니다:

php

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

// true

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

// false

blank의 반대는 filled 메서드를 참고하세요.

`broadcast()`

broadcast 함수는 주어진 이벤트를 브로드캐스트합니다:

php

broadcast(new UserRegistered($user));

broadcast(new UserRegistered($user))->toOthers();

`cache()`

cache 함수는 캐시에서 값을 가져올 때 사용할 수 있습니다. 주어진 키가 캐시에 없으면, 선택적으로 기본값이 반환됩니다:

php

$value = cache('key');

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

키/값 쌍의 배열을 전달하여 캐시에 항목을 추가할 수도 있습니다. 캐시 유효 기간(초 또는 기간)도 함께 전달해야 합니다:

php

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

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

`class_uses_recursive()`

class_uses_recursive 함수는 클래스가 사용하는 모든 트레잇(부모 클래스의 트레잇 포함)을 반환합니다:

php

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

`collect()`

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

php

$collection = collect(['Taylor', 'Abigail']);

`config()`

config 함수는 설정 변수의 값을 가져옵니다. "dot" 문법을 사용하여 파일명과 옵션명을 지정할 수 있습니다. 기본값을 지정할 수 있으며, 설정 옵션이 없을 경우 반환됩니다:

php

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

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

런타임에 설정 변수를 배열로 전달하여 설정할 수도 있습니다. 단, 이 함수는 현재 요청에만 영향을 주며 실제 설정 파일을 변경하지는 않습니다:

php

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

`context()`

context 함수는 현재 컨텍스트에서 값을 가져옵니다. 기본값을 지정할 수 있으며, 컨텍스트 키가 없을 경우 반환됩니다:

php

$value = context('trace_id');

$value = context('trace_id', $default);

키/값 쌍의 배열을 전달하여 컨텍스트 값을 설정할 수도 있습니다:

php

use Illuminate\Support\Str;

context(['trace_id' => Str::uuid()->toString()]);

`cookie()`

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

php

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

`csrf_field()`

csrf_field 함수는 CSRF 토큰 값을 담은 HTML hidden input 필드를 생성합니다. 예를 들어, Blade 문법에서:

blade

{{ csrf_field() }}

`csrf_token()`

csrf_token 함수는 현재 CSRF 토큰 값을 가져옵니다:

php

$token = csrf_token();

`decrypt()`

decrypt 함수는 주어진 값을 복호화합니다. Crypt 파사드의 대안으로 사용할 수 있습니다:

php

$password = decrypt($value);

`dd()`

dd 함수는 주어진 변수를 덤프하고 스크립트 실행을 종료합니다:

php

dd($value);

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

스크립트 실행을 중단하지 않고 변수만 덤프하려면 dump 함수를 사용하세요.

`dispatch()`

dispatch 함수는 주어진 잡을 Laravel 잡 큐에 푸시합니다:

php

dispatch(new App\Jobs\SendEmails);

`dispatch_sync()`

dispatch_sync 함수는 주어진 잡을 동기 큐에 푸시하여 즉시 처리합니다:

php

dispatch_sync(new App\Jobs\SendEmails);

`dump()`

dump 함수는 주어진 변수를 덤프합니다:

php

dump($value);

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

변수를 덤프한 후 스크립트 실행을 중단하려면 dd 함수를 사용하세요.

`encrypt()`

encrypt 함수는 주어진 값을 암호화합니다. Crypt 파사드의 대안으로 사용할 수 있습니다:

php

$secret = encrypt('my-secret-value');

`env()`

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

php

$env = env('APP_ENV');

$env = env('APP_ENV', 'production');

WARNING

배포 과정에서 config:cache 명령어를 실행한다면, 반드시 설정 파일 내에서만 env 함수를 호출해야 합니다. 설정이 캐시되면 .env 파일이 로드되지 않으며, 모든 env 함수 호출은 null을 반환합니다.

`event()`

event 함수는 주어진 이벤트를 리스너에 디스패치합니다:

php

event(new UserRegistered($user));

`fake()`

fake 함수는 Faker 싱글턴을 컨테이너에서 해석합니다. 모델 팩토리, 데이터베이스 시딩, 테스트, 프로토타입 뷰에서 가짜 데이터를 생성할 때 유용합니다:

blade

@for($i = 0; $i < 10; $i++)
    <dl>
        <dt>Name</dt>
        <dd>{{ fake()->name() }}</dd>

        <dt>Email</dt>
        <dd>{{ fake()->unique()->safeEmail() }}</dd>
    </dl>
@endfor

기본적으로 fake 함수는 config/app.php의 app.faker_locale 설정을 사용합니다. 이 설정은 보통 APP_FAKER_LOCALE 환경 변수로 지정합니다. 로케일을 직접 전달할 수도 있으며, 각 로케일마다 개별 싱글턴이 생성됩니다:

php

fake('nl_NL')->name()

`filled()`

filled 함수는 주어진 값이 "비어있지 않은지" 여부를 판단합니다:

php

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

// true

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

// false

filled의 반대는 blank 메서드를 참고하세요.

`info()`

info 함수는 애플리케이션의 로그에 정보를 기록합니다:

php

info('Some helpful information!');

컨텍스트 데이터 배열도 함께 전달할 수 있습니다:

php

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

`literal()`

literal 함수는 주어진 이름 있는 인자를 속성으로 갖는 새로운 stdClass 인스턴스를 생성합니다:

php

$obj = literal(
    name: 'Joe',
    languages: ['PHP', 'Ruby'],
);

$obj->name; // 'Joe'
$obj->languages; // ['PHP', 'Ruby']

`logger()`

logger 함수는 로그에 debug 레벨 메시지를 기록할 때 사용할 수 있습니다:

php

logger('Debug message');

컨텍스트 데이터 배열도 함께 전달할 수 있습니다:

php

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

값을 전달하지 않으면 로거 인스턴스가 반환됩니다:

php

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

`method_field()`

method_field 함수는 폼의 HTTP 메서드 값을 스푸핑한 HTML hidden input 필드를 생성합니다. 예를 들어, Blade 문법에서:

blade

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

`now()`

now 함수는 현재 시간에 대한 새로운 Illuminate\Support\Carbon 인스턴스를 생성합니다:

php

$now = now();

`old()`

old 함수는 세션에 플래시된 이전 입력값을 가져옵니다:

php

$value = old('value');

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

두 번째 인자로 제공된 "기본값"이 보통 Eloquent 모델의 속성일 때, old 함수에 전체 Eloquent 모델을 두 번째 인자로 전달할 수 있습니다. 이 경우, 첫 번째 인자는 "기본값"으로 간주할 Eloquent 속성의 이름이어야 합니다:

blade

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

// 아래와 동일합니다...

{{ old('name', $user) }}

`once()`

once 함수는 주어진 콜백을 실행하고, 요청이 지속되는 동안 결과를 메모리에 캐시합니다. 동일한 콜백으로 once 함수를 다시 호출하면 이전에 캐시된 결과가 반환됩니다:

php

function random(): int
{
    return once(function () {
        return random_int(1, 1000);
    });
}

random(); // 123
random(); // 123 (캐시된 결과)
random(); // 123 (캐시된 결과)

once 함수가 객체 인스턴스 내에서 실행되면, 캐시된 결과는 해당 객체 인스턴스에 고유합니다:

php

<?php

class NumberService
{
    public function all(): array
    {
        return once(fn () => [1, 2, 3]);
    }
}

$service = new NumberService;

$service->all();
$service->all(); // (캐시된 결과)

$secondService = new NumberService;

$secondService->all();
$secondService->all(); // (캐시된 결과)

`optional()`

optional 함수는 어떤 인자든 받아 해당 객체의 속성이나 메서드에 접근할 수 있게 해줍니다. 주어진 객체가 null이면, 속성이나 메서드는 에러 대신 null을 반환합니다:

php

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

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

optional 함수는 두 번째 인자로 클로저도 받을 수 있습니다. 첫 번째 인자로 제공된 값이 null이 아니면 클로저가 실행됩니다:

php

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

`policy()`

policy 메서드는 주어진 클래스에 대한 정책 인스턴스를 가져옵니다:

php

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

`redirect()`

redirect 함수는 리디렉션 HTTP 응답을 반환하거나, 인자가 없으면 리디렉터 인스턴스를 반환합니다:

php

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

return redirect('/home');

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

`report()`

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

php

report($e);

report 함수는 문자열도 인자로 받을 수 있습니다. 문자열이 주어지면, 해당 문자열을 메시지로 하는 예외가 생성되어 보고됩니다:

php

report('Something went wrong.');

`report_if()`

report_if 함수는 주어진 조건이 true일 때 예외 핸들러를 사용하여 예외를 보고합니다:

php

report_if($shouldReport, $e);

report_if($shouldReport, 'Something went wrong.');

`report_unless()`

report_unless 함수는 주어진 조건이 false일 때 예외 핸들러를 사용하여 예외를 보고합니다:

php

report_unless($reportingDisabled, $e);

report_unless($reportingDisabled, 'Something went wrong.');

`request()`

request 함수는 현재 요청 인스턴스를 반환하거나, 현재 요청에서 입력 필드 값을 가져옵니다:

php

$request = request();

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

`rescue()`

rescue 함수는 주어진 클로저를 실행하고, 실행 중 발생하는 예외를 잡아냅니다. 잡힌 모든 예외는 예외 핸들러로 전송되지만, 요청 처리는 계속됩니다:

php

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

rescue 함수에 두 번째 인자를 전달할 수도 있습니다. 이 인자는 클로저 실행 중 예외가 발생하면 반환할 "기본값"입니다:

php

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

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

report 인자를 rescue 함수에 제공하여, 예외를 report 함수로 보고할지 여부를 결정할 수 있습니다:

php

return rescue(function () {
    return $this->method();
}, report: function (Throwable $throwable) {
    return $throwable instanceof InvalidArgumentException;
});

`resolve()`

resolve 함수는 서비스 컨테이너를 사용하여 주어진 클래스 또는 인터페이스 이름을 인스턴스로 해석합니다:

php

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

`response()`

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

php

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

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

`retry()`

retry 함수는 주어진 최대 시도 횟수까지 콜백을 실행하려고 시도합니다. 콜백이 예외를 발생시키지 않으면 반환값이 반환됩니다. 예외가 발생하면 자동으로 재시도합니다. 최대 시도 횟수를 초과하면 예외가 발생합니다:

php

return retry(5, function () {
    // 5번 시도하며, 각 시도 사이에 100ms 대기...
}, 100);

시도 사이에 대기할 밀리초를 직접 계산하려면, 세 번째 인자로 클로저를 전달할 수 있습니다:

php

use Exception;

return retry(5, function () {
    // ...
}, function (int $attempt, Exception $exception) {
    return $attempt * 100;
});

편의를 위해, 첫 번째 인자로 배열을 전달할 수 있습니다. 이 배열은 각 재시도 사이에 대기할 밀리초를 결정하는 데 사용됩니다:

php

return retry([100, 200], function () {
    // 첫 번째 재시도는 100ms, 두 번째는 200ms 대기...
});

특정 조건에서만 재시도하려면, 네 번째 인자로 클로저를 전달할 수 있습니다:

php

use App\Exceptions\TemporaryException;
use Exception;

return retry(5, function () {
    // ...
}, 100, function (Exception $exception) {
    return $exception instanceof TemporaryException;
});

`session()`

session 함수는 세션 값을 가져오거나 설정할 때 사용할 수 있습니다:

php

$value = session('key');

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

php

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

값을 전달하지 않으면 세션 스토어가 반환됩니다:

php

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

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

`tap()`

tap 함수는 두 개의 인자를 받습니다: 임의의 $value와 클로저. $value는 클로저에 전달된 후, tap 함수에서 반환됩니다. 클로저의 반환값은 무시됩니다:

php

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

    $user->save();
});

클로저를 전달하지 않으면, 주어진 $value에 어떤 메서드든 호출할 수 있습니다. 호출한 메서드의 반환값과 상관없이 항상 $value가 반환됩니다. 예를 들어, Eloquent의 update 메서드는 보통 정수를 반환하지만, tap을 사용하면 모델 자체를 반환하게 할 수 있습니다:

php

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

클래스에 tap 메서드를 추가하려면, Illuminate\Support\Traits\Tappable 트레잇을 클래스에 추가하세요. 이 트레잇의 tap 메서드는 클로저를 유일한 인자로 받으며, 객체 인스턴스 자체가 클로저에 전달된 후 반환됩니다:

php

return $user->tap(function (User $user) {
    // ...
});

`throw_if()`

throw_if 함수는 주어진 불리언 표현식이 true일 때, 주어진 예외를 발생시킵니다:

php

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

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

`throw_unless()`

throw_unless 함수는 주어진 불리언 표현식이 false일 때, 주어진 예외를 발생시킵니다:

php

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

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

`today()`

today 함수는 현재 날짜에 대한 새로운 Illuminate\Support\Carbon 인스턴스를 생성합니다:

php

$today = today();

`trait_uses_recursive()`

trait_uses_recursive 함수는 트레잇이 사용하는 모든 트레잇을 반환합니다:

php

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

`transform()`

transform 함수는 주어진 값이 blank가 아니면 클로저를 실행하고, 클로저의 반환값을 반환합니다:

php

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

$result = transform(5, $callback);

// 10

기본값이나 클로저를 세 번째 인자로 전달할 수 있습니다. 주어진 값이 blank일 경우 이 값이 반환됩니다:

php

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

// The value is blank

`validator()`

validator 함수는 주어진 인자로 새로운 밸리데이터 인스턴스를 생성합니다. Validator 파사드의 대안으로 사용할 수 있습니다:

php

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

`value()`

value 함수는 전달된 값을 반환합니다. 단, 클로저를 전달하면 클로저를 실행하고 반환값을 반환합니다:

php

$result = value(true);

// true

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

// false

추가 인자를 전달할 수 있습니다. 첫 번째 인자가 클로저라면, 추가 인자들이 클로저의 인자로 전달됩니다. 그렇지 않으면 무시됩니다:

php

$result = value(function (string $name) {
    return $name;
}, 'Taylor');

// 'Taylor'

`view()`

view 함수는 뷰 인스턴스를 가져옵니다:

php

return view('auth.login');

`with()`

with 함수는 전달된 값을 반환합니다. 두 번째 인자로 클로저를 전달하면, 클로저를 실행하고 반환값을 반환합니다:

php

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

$result = with(5, $callback);

// 10

$result = with(null, $callback);

// 0

$result = with(5, null);

// 5

`when()`

when 함수는 주어진 조건이 true일 때 값을 반환합니다. 그렇지 않으면 null을 반환합니다. 두 번째 인자로 클로저를 전달하면, 클로저를 실행하고 반환값을 반환합니다:

php

$value = when(true, 'Hello World');

$value = when(true, fn () => 'Hello World');

when 함수는 주로 HTML 속성을 조건부로 렌더링할 때 유용합니다:

blade

<div {!! when($condition, 'wire:poll="calculate"') !!}>
    ...
</div>

기타 유틸리티

벤치마킹

애플리케이션의 특정 부분의 성능을 빠르게 테스트하고 싶을 때가 있습니다. 이럴 때, Benchmark 지원 클래스를 사용하여 주어진 콜백이 완료되는 데 걸리는 밀리초(ms) 시간을 측정할 수 있습니다:

php

<?php

use App\Models\User;
use Illuminate\Support\Benchmark;

Benchmark::dd(fn () => User::find(1)); // 0.1 ms

Benchmark::dd([
    'Scenario 1' => fn () => User::count(), // 0.5 ms
    'Scenario 2' => fn () => User::all()->count(), // 20.0 ms
]);

기본적으로, 콜백은 한 번(1회 반복) 실행되며, 실행 시간은 브라우저/콘솔에 표시됩니다.

콜백을 여러 번 실행하려면, 두 번째 인자로 반복 횟수를 지정할 수 있습니다. 여러 번 실행할 경우, Benchmark 클래스는 모든 반복에서 콜백을 실행하는 데 걸린 평균 밀리초(ms) 시간을 반환합니다:

php

Benchmark::dd(fn () => User::count(), iterations: 10); // 0.5 ms

콜백의 실행 시간을 벤치마킹하면서 콜백의 반환값도 얻고 싶을 때는, value 메서드를 사용하면 콜백의 반환값과 실행 시간을 튜플로 반환합니다:

php

[$count, $duration] = Benchmark::value(fn () => User::count());

날짜

Laravel에는 강력한 날짜 및 시간 조작 라이브러리인 Carbon이 포함되어 있습니다. 새로운 Carbon 인스턴스를 생성하려면, now 함수를 호출하면 됩니다. 이 함수는 Laravel 애플리케이션 내에서 전역적으로 사용할 수 있습니다:

php

$now = now();

또는, Illuminate\Support\Carbon 클래스를 사용하여 새로운 Carbon 인스턴스를 생성할 수 있습니다:

php

use Illuminate\Support\Carbon;

$now = Carbon::now();

Carbon과 그 기능에 대한 자세한 내용은 공식 Carbon 문서를 참고하세요.

지연 함수

Laravel의 큐 잡은 작업을 백그라운드에서 처리하도록 큐에 넣을 수 있지만, 때로는 큐 워커를 설정하거나 유지하지 않고 간단한 작업을 지연하고 싶을 때가 있습니다.

지연 함수는 클로저의 실행을 HTTP 응답이 사용자에게 전송된 후로 미룰 수 있게 해주어, 애플리케이션이 빠르고 반응성 있게 느껴지도록 합니다. 클로저를 지연 실행하려면, Illuminate\Support\defer 함수에 클로저를 전달하세요:

php

use App\Services\Metrics;
use Illuminate\Http\Request;
use Illuminate\Support\Facades\Route;
use function Illuminate\Support\defer;

Route::post('/orders', function (Request $request) {
    // 주문 생성...

    defer(fn () => Metrics::reportOrder($order));

    return $order;
});

기본적으로, 지연 함수는 Illuminate\Support\defer가 호출된 HTTP 응답, Artisan 명령, 큐 잡이 성공적으로 완료된 경우에만 실행됩니다. 즉, 요청이 4xx 또는 5xx HTTP 응답을 반환하면 지연 함수는 실행되지 않습니다. 항상 지연 함수를 실행하고 싶다면, always 메서드를 체이닝하세요:

php

defer(fn () => Metrics::reportOrder($order))->always();

지연 함수 취소하기

지연 함수가 실행되기 전에 취소해야 할 경우, forget 메서드를 사용하여 이름으로 취소할 수 있습니다. 지연 함수에 이름을 지정하려면, Illuminate\Support\defer 함수의 두 번째 인자로 이름을 전달하세요:

php

defer(fn () => Metrics::report(), 'reportMetrics');

defer()->forget('reportMetrics');

테스트에서 지연 함수 비활성화하기

테스트를 작성할 때, 지연 함수를 비활성화하는 것이 유용할 수 있습니다. 테스트에서 withoutDefer를 호출하면, Laravel이 모든 지연 함수를 즉시 실행하도록 할 수 있습니다:

PestPHPUnit

php

test('without defer', function () {
    $this->withoutDefer();

    // ...
});

php

use Tests\TestCase;

class ExampleTest extends TestCase
{
    public function test_without_defer(): void
    {
        $this->withoutDefer();

        // ...
    }
}

테스트 케이스 내의 모든 테스트에서 지연 함수를 비활성화하려면, 기본 TestCase 클래스의 setUp 메서드에서 withoutDefer 메서드를 호출하세요:

php

<?php

namespace Tests;

use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

abstract class TestCase extends BaseTestCase
{
    protected function setUp(): void
    {
        parent::setUp();

        $this->withoutDefer();
    }
}

로터리

Laravel의 로터리 클래스는 주어진 확률에 따라 콜백을 실행할 수 있습니다. 이는 전체 요청 중 일부에서만 코드를 실행하고 싶을 때 특히 유용합니다:

php

use Illuminate\Support\Lottery;

Lottery::odds(1, 20)
    ->winner(fn () => $user->won())
    ->loser(fn () => $user->lost())
    ->choose();

Laravel의 로터리 클래스를 다른 Laravel 기능과 결합할 수도 있습니다. 예를 들어, 느린 쿼리의 일부만 예외 핸들러에 보고하고 싶을 수 있습니다. 로터리 클래스는 호출 가능(callable)이므로, 콜러블을 받는 어떤 메서드에도 인스턴스를 전달할 수 있습니다:

php

use Carbon\CarbonInterval;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Lottery;

DB::whenQueryingForLongerThan(
    CarbonInterval::seconds(2),
    Lottery::odds(1, 100)->winner(fn () => report('Querying > 2 seconds.')),
);

로터리 테스트하기

Laravel은 애플리케이션의 로터리 호출을 쉽게 테스트할 수 있도록 몇 가지 간단한 메서드를 제공합니다:

php

// 항상 당첨...
Lottery::alwaysWin();

// 항상 꽝...
Lottery::alwaysLose();

// 한 번 당첨, 한 번 꽝, 그 후 정상 동작...
Lottery::fix([true, false]);

// 정상 동작으로 복귀...
Lottery::determineResultsNormally();

파이프라인

Laravel의 Pipeline 파사드는 주어진 입력을 일련의 인보커블 클래스, 클로저, 콜러블을 통해 "파이프"할 수 있는 편리한 방법을 제공합니다. 각 클래스는 입력을 검사하거나 수정할 기회를 가지며, 파이프라인의 다음 콜러블을 호출할 수 있습니다:

php

use Closure;
use App\Models\User;
use Illuminate\Support\Facades\Pipeline;

$user = Pipeline::send($user)
    ->through([
        function (User $user, Closure $next) {
            // ...

            return $next($user);
        },
        function (User $user, Closure $next) {
            // ...

            return $next($user);
        },
    ])
    ->then(fn (User $user) => $user);

보시다시피, 파이프라인의 각 인보커블 클래스나 클로저는 입력과 $next 클로저를 받습니다. $next를 호출하면 파이프라인의 다음 콜러블이 호출됩니다. 이는 미들웨어와 매우 유사합니다.

파이프라인의 마지막 콜러블이 $next를 호출하면, then 메서드에 제공된 콜러블이 실행됩니다. 보통 이 콜러블은 입력값을 그대로 반환합니다.

물론, 클로저뿐만 아니라 인보커블 클래스도 파이프라인에 제공할 수 있습니다. 클래스 이름이 제공되면, Laravel의 서비스 컨테이너를 통해 인스턴스화되어 의존성 주입이 가능합니다:

php

$user = Pipeline::send($user)
    ->through([
        GenerateProfilePhoto::class,
        ActivateSubscription::class,
        SendWelcomeEmail::class,
    ])
    ->then(fn (User $user) => $user);

슬립

Laravel의 Sleep 클래스는 PHP의 기본 sleep 및 usleep 함수에 대한 경량 래퍼로, 테스트 용이성과 시간 작업을 위한 개발자 친화적 API를 제공합니다:

php

use Illuminate\Support\Sleep;

$waiting = true;

while ($waiting) {
    Sleep::for(1)->second();

    $waiting = /* ... */;
}

Sleep 클래스는 다양한 시간 단위로 작업할 수 있는 여러 메서드를 제공합니다:

php

// 슬립 후 값 반환...
$result = Sleep::for(1)->second()->then(fn () => 1 + 1);

// 주어진 값이 true인 동안 슬립...
Sleep::for(1)->second()->while(fn () => shouldKeepSleeping());

// 90초 동안 일시정지...
Sleep::for(1.5)->minutes();

// 2초 동안 일시정지...
Sleep::for(2)->seconds();

// 500밀리초 동안 일시정지...
Sleep::for(500)->milliseconds();

// 5,000마이크로초 동안 일시정지...
Sleep::for(5000)->microseconds();

// 지정한 시간까지 일시정지...
Sleep::until(now()->addMinute());

// PHP의 기본 "sleep" 함수 별칭...
Sleep::sleep(2);

// PHP의 기본 "usleep" 함수 별칭...
Sleep::usleep(5000);

시간 단위를 쉽게 조합하려면 and 메서드를 사용할 수 있습니다:

php

Sleep::for(1)->second()->and(10)->milliseconds();

슬립 테스트하기

Sleep 클래스나 PHP의 기본 sleep 함수를 사용하는 코드를 테스트할 때, 테스트가 일시정지됩니다. 이는 테스트 속도를 크게 저하시킵니다. 예를 들어, 다음 코드를 테스트한다고 가정해봅시다:

php

$waiting = /* ... */;

$seconds = 1;

while ($waiting) {
    Sleep::for($seconds++)->seconds();

    $waiting = /* ... */;
}

보통 이 코드를 테스트하면 최소 1초가 걸립니다. 다행히도, Sleep 클래스는 "슬립"을 가짜로 만들어 테스트 속도를 빠르게 할 수 있습니다:

PestPHPUnit

php

it('waits until ready', function () {
    Sleep::fake();

    // ...
});

php

public function test_it_waits_until_ready()
{
    Sleep::fake();

    // ...
}

Sleep 클래스를 가짜로 만들면 실제 일시정지가 생략되어 테스트가 훨씬 빨라집니다.

Sleep 클래스를 가짜로 만든 후, 예상되는 "슬립"이 발생했는지 검증할 수도 있습니다. 예를 들어, 1초, 2초, 3초씩 세 번 일시정지하는 코드를 테스트한다고 가정하면, assertSequence 메서드를 사용해 올바른 시간만큼 "슬립"했는지 검증할 수 있습니다:

PestPHPUnit

php

it('checks if ready three times', function () {
    Sleep::fake();

    // ...

    Sleep::assertSequence([
        Sleep::for(1)->second(),
        Sleep::for(2)->seconds(),
        Sleep::for(3)->seconds(),
    ]);
}

php

public function test_it_checks_if_ready_three_times()
{
    Sleep::fake();

    // ...

    Sleep::assertSequence([
        Sleep::for(1)->second(),
        Sleep::for(2)->seconds(),
        Sleep::for(3)->seconds(),
    ]);
}

물론, Sleep 클래스는 테스트 시 사용할 수 있는 다양한 검증 메서드를 제공합니다:

php

use Carbon\CarbonInterval as Duration;
use Illuminate\Support\Sleep;

// 슬립이 3번 호출되었는지 검증...
Sleep::assertSleptTimes(3);

// 슬립 시간 검증...
Sleep::assertSlept(function (Duration $duration): bool {
    return /* ... */;
}, times: 1);

// Sleep 클래스가 한 번도 호출되지 않았는지 검증...
Sleep::assertNeverSlept();

// Sleep이 호출되었더라도 실제 일시정지가 없었는지 검증...
Sleep::assertInsomniac();

가짜 슬립이 발생할 때마다 작업을 수행하고 싶을 때는, whenFakingSleep 메서드에 콜백을 제공할 수 있습니다. 아래 예시에서는 Laravel의 시간 조작 헬퍼를 사용해 각 슬립 시간만큼 즉시 시간을 진행시킵니다:

php

use Carbon\CarbonInterval as Duration;

$this->freezeTime();

Sleep::fake();

Sleep::whenFakingSleep(function (Duration $duration) {
    // 슬립 시 시간 진행...
    $this->travel($duration->totalMilliseconds)->milliseconds();
});

시간 진행이 자주 필요한 경우, fake 메서드의 syncWithCarbon 인자를 사용해 테스트 내에서 슬립 시 Carbon과 동기화할 수 있습니다:

php

Sleep::fake(syncWithCarbon: true);

$start = now();

Sleep::for(1)->second();

$start->diffForHumans(); // 1초 전

Laravel은 실행을 일시정지할 때 내부적으로 Sleep 클래스를 사용합니다. 예를 들어, retry 헬퍼는 슬립 시 Sleep 클래스를 사용하므로, 해당 헬퍼를 사용할 때 테스트 용이성이 향상됩니다.

타임박스

Laravel의 Timebox 클래스는 주어진 콜백이 실제 실행이 더 빨리 끝나더라도 항상 고정된 시간만큼 실행되도록 보장합니다. 이는 암호화 연산이나 사용자 인증 검사 등에서, 공격자가 실행 시간의 변화를 이용해 민감한 정보를 추론하는 것을 방지하는 데 유용합니다.

실행이 고정 시간보다 오래 걸리면, Timebox는 아무런 효과가 없습니다. 최악의 경우를 고려해 충분히 긴 시간을 고정 시간으로 선택하는 것은 개발자의 몫입니다.

call 메서드는 클로저와 마이크로초 단위의 시간 제한을 받아, 클로저를 실행한 후 시간 제한까지 대기합니다:

php

use Illuminate\Support\Timebox;

(new Timebox)->call(function ($timebox) {
    // ...
}, microseconds: 10000);

클로저 내에서 예외가 발생하면, 이 클래스는 정의된 지연을 준수한 후 예외를 다시 발생시킵니다.

URI

Laravel의 Uri 클래스는 URI를 생성하고 조작할 수 있는 편리하고 플루언트한 인터페이스를 제공합니다. 이 클래스는 League URI 패키지의 기능을 감싸며, Laravel의 라우팅 시스템과 원활하게 통합됩니다.

정적 메서드를 사용해 쉽게 Uri 인스턴스를 생성할 수 있습니다:

php

use App\Http\Controllers\UserController;
use App\Http\Controllers\InvokableController;
use Illuminate\Support\Uri;

// 주어진 문자열로 URI 인스턴스 생성...
$uri = Uri::of('https://example.com/path');

// 경로, 이름이 지정된 라우트, 컨트롤러 액션으로 URI 인스턴스 생성...
$uri = Uri::to('/dashboard');
$uri = Uri::route('users.show', ['user' => 1]);
$uri = Uri::signedRoute('users.show', ['user' => 1]);
$uri = Uri::temporarySignedRoute('user.index', now()->addMinutes(5));
$uri = Uri::action([UserController::class, 'index']);
$uri = Uri::action(InvokableController::class);

// 현재 요청 URL로 URI 인스턴스 생성...
$uri = $request->uri();

URI 인스턴스를 얻은 후에는 플루언트하게 수정할 수 있습니다:

php

$uri = Uri::of('https://example.com')
    ->withScheme('http')
    ->withHost('test.com')
    ->withPort(8000)
    ->withPath('/users')
    ->withQuery(['page' => 2])
    ->withFragment('section-1');

URI 검사하기

Uri 클래스는 기본 URI의 다양한 구성 요소를 쉽게 검사할 수 있게 해줍니다:

php

$scheme = $uri->scheme();
$host = $uri->host();
$port = $uri->port();
$path = $uri->path();
$segments = $uri->pathSegments();
$query = $uri->query();
$fragment = $uri->fragment();

쿼리 문자열 조작하기

Uri 클래스는 URI의 쿼리 문자열을 조작할 수 있는 여러 메서드를 제공합니다. withQuery 메서드는 기존 쿼리 문자열에 추가 파라미터를 병합합니다:

php

$uri = $uri->withQuery(['sort' => 'name']);

withQueryIfMissing 메서드는 주어진 키가 쿼리 문자열에 없을 때만 추가 파라미터를 병합합니다:

php

$uri = $uri->withQueryIfMissing(['page' => 1]);

replaceQuery 메서드는 기존 쿼리 문자열을 완전히 새 쿼리로 대체합니다:

php

$uri = $uri->replaceQuery(['page' => 1]);

pushOntoQuery 메서드는 배열 값을 가진 쿼리 문자열 파라미터에 추가 파라미터를 푸시합니다:

php

$uri = $uri->pushOntoQuery('filter', ['active', 'pending']);

withoutQuery 메서드는 쿼리 문자열에서 파라미터를 제거합니다:

php

$uri = $uri->withoutQuery(['page']);

URI로부터 응답 생성하기

redirect 메서드는 주어진 URI로 RedirectResponse 인스턴스를 생성할 수 있습니다:

php

$uri = Uri::of('https://example.com');

return $uri->redirect();

또는, 라우트나 컨트롤러 액션에서 Uri 인스턴스를 반환하면, 해당 URI로 자동으로 리디렉션 응답이 생성됩니다:

php

use Illuminate\Support\Facades\Route;
use Illuminate\Support\Uri;

Route::get('/redirect', function () {
    return Uri::to('/index')
        ->withQuery(['sort' => 'name']);
});

헬퍼 ​

소개 ​

사용 가능한 메서드 ​

배열 & 객체 ​

숫자 ​

경로 ​

URL ​

기타 ​

배열 & 객체 ​

Arr::accessible() ​

Arr::add() ​

Arr::array() ​

Arr::boolean() ​

Arr::collapse() ​

Arr::crossJoin() ​

Arr::divide() ​

Arr::dot() ​

Arr::except() ​

Arr::exists() ​

Arr::first() ​

Arr::flatten() ​

Arr::float() ​

Arr::forget() ​

Arr::from() ​

Arr::get() ​

Arr::has() ​

Arr::hasAll() ​

Arr::hasAny() ​

Arr::integer() ​

Arr::isAssoc() ​

Arr::isList() ​

Arr::join() ​

Arr::keyBy() ​

Arr::last() ​

Arr::map() ​

Arr::mapSpread() ​

Arr::mapWithKeys() ​

Arr::only() ​

Arr::partition() ​

Arr::pluck() ​

Arr::prepend() ​

Arr::prependKeysWith() ​

Arr::pull() ​

Arr::query() ​

Arr::random() ​

Arr::reject() ​

Arr::select() ​

Arr::set() ​

Arr::shuffle() ​

Arr::sole() ​

Arr::sort() ​

Arr::sortDesc() ​

Arr::sortRecursive() ​

Arr::string() ​

Arr::take() ​

Arr::toCssClasses() ​

Arr::toCssStyles() ​

Arr::undot() ​

Arr::where() ​

Arr::whereNotNull() ​

Arr::wrap() ​

data_fill() ​

data_get() ​

data_set() ​

data_forget() ​

head() ​

last() ​

숫자 ​

Number::abbreviate() ​

Number::clamp() ​

Number::currency() ​

Number::defaultCurrency() ​

Number::defaultLocale() ​

Number::fileSize() ​

Number::forHumans() ​

Number::format() ​

Number::ordinal() ​

Number::pairs() ​

Number::percentage() ​

Number::spell() ​

헬퍼

소개

사용 가능한 메서드

배열 & 객체

숫자

경로

URL

기타

배열 & 객체

`Arr::accessible()`

`Arr::add()`

`Arr::array()`

`Arr::boolean()`

`Arr::collapse()`

`Arr::crossJoin()`

`Arr::divide()`

`Arr::dot()`

`Arr::except()`

`Arr::exists()`

`Arr::first()`

`Arr::flatten()`

`Arr::float()`

`Arr::forget()`

`Arr::from()`

`Arr::get()`

`Arr::has()`

`Arr::hasAll()`

`Arr::hasAny()`

`Arr::integer()`

`Arr::isAssoc()`

`Arr::isList()`

`Arr::join()`

`Arr::keyBy()`

`Arr::last()`

`Arr::map()`

`Arr::mapSpread()`

`Arr::mapWithKeys()`

`Arr::only()`

`Arr::partition()`

`Arr::pluck()`

`Arr::prepend()`

`Arr::prependKeysWith()`

`Arr::pull()`

`Arr::query()`

`Arr::random()`

`Arr::reject()`

`Arr::select()`

`Arr::set()`

`Arr::shuffle()`

`Arr::sole()`

`Arr::sort()`

`Arr::sortDesc()`

`Arr::sortRecursive()`

`Arr::string()`

`Arr::take()`

`Arr::toCssClasses()`

`Arr::toCssStyles()`

`Arr::undot()`

`Arr::where()`

`Arr::whereNotNull()`

`Arr::wrap()`

`data_fill()`

`data_get()`

`data_set()`

`data_forget()`

`head()`

`last()`

숫자

`Number::abbreviate()`

`Number::clamp()`

`Number::currency()`

`Number::defaultCurrency()`

`Number::defaultLocale()`

`Number::fileSize()`

`Number::forHumans()`

`Number::format()`

`Number::ordinal()`

`Number::pairs()`

`Number::percentage()`

`Number::spell()`