ヘルパー関数

use Illuminate\Support\Arr;
use Illuminate\Support\Number;

// 配列のように使えるか調べる
Arr::accessible(['a' => 1, 'b' => 2]); // true
Arr::accessible(new Collection);       // true
Arr::accessible('abc');                // false
Arr::accessible(new stdClass);         // false

// キーがあるか調べる
Arr::exists(['name' => 'John Doe', 'age' => 17], 'name');   // true
Arr::exists(['name' => 'John Doe', 'age' => 17], 'salary'); // false

// ドット記法で値を取り出す
$array = ['products' => ['desk' => ['price' => 100]]];
Arr::get($array, 'products.desk.price');       // 100
Arr::get($array, 'products.desk.discount', 0); // 0（3つ目は、無いときの既定値）

// ドット記法で、キーがあるか調べる
$array = ['product' => ['name' => 'Desk', 'price' => 100]];
Arr::has($array, 'product.name');                         // true
Arr::has($array, ['product.price', 'product.discount']); // false（1つでも無ければ false）
Arr::hasAny($array, ['product.name', 'product.discount']); // true
Arr::hasAny($array, ['category', 'product.discount']);     // false

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

// 連想配列か・リストか
Arr::isAssoc(['product' => ['name' => 'Desk', 'price' => 100]]); // true
Arr::isAssoc([1, 2, 3]);                                         // false
Arr::isList(['foo', 'bar', 'baz']);                              // true
Arr::isList(['product' => ['name' => 'Desk', 'price' => 100]]);  // false

$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby'], 'available' => true, 'balance' => 123.45, 'age' => 42];

Arr::array($array, 'languages');    // ['PHP', 'Ruby']
Arr::array($array, 'name');         // 例外を投げる

Arr::boolean($array, 'available');  // true
Arr::boolean($array, 'name');       // 例外を投げる

Arr::float($array, 'balance');      // 123.45
Arr::float($array, 'name');         // 例外を投げる

Arr::integer($array, 'age');        // 42
Arr::integer($array, 'name');       // 例外を投げる

Arr::string($array, 'name');        // Joe
Arr::string($array, 'languages');   // 例外を投げる

$array = [100, 200, 300];
Arr::first($array, function (int $value, int $key) {
    return $value >= 150;
}); // 200
Arr::first($array, $callback, $default); // 3つ目は、合うものが無いときの既定値

$array = [100, 200, 300, 110];
Arr::last($array, function (int $value, int $key) {
    return $value >= 150;
}); // 300
Arr::last($array, $callback, $default); // 3つ目は、合うものが無いときの既定値

// 合うものがちょうど1つのときだけ取り出す
// 2つ以上なら MultipleItemsFoundException、1つも無ければ ItemNotFoundException を投げる
$array = ['Desk', 'Table', 'Chair'];
Arr::sole($array, fn (string $value) => $value === 'Desk'); // 'Desk'

// すべてが条件に合うか、1つでも合うか
Arr::every([1, 2, 3], fn ($i) => $i > 0); // true
Arr::every([1, 2, 3], fn ($i) => $i > 2); // false
Arr::some([1, 2, 3], fn ($i) => $i > 2);  // true

// 先頭と最後の要素（空の配列なら false）
head([100, 200, 300]); // 100
last([100, 200, 300]); // 300

// キーが無い（または null の）ときだけ足す
Arr::add(['name' => 'Desk'], 'price', 100);                 // ['name' => 'Desk', 'price' => 100]
Arr::add(['name' => 'Desk', 'price' => null], 'price', 100); // ['name' => 'Desk', 'price' => 100]

// 先頭に足す
Arr::prepend(['one', 'two', 'three', 'four'], 'zero'); // ['zero', 'one', 'two', 'three', 'four']
Arr::prepend(['price' => 100], 'Desk', 'name');        // ['name' => 'Desk', 'price' => 100]

// ドット記法で、配列に値を足す（無ければ作る）
$array = [];
Arr::push($array, 'office.furniture', 'Desk');
// $array: ['office' => ['furniture' => ['Desk']]]

// ドット記法で値を入れる
$array = ['products' => ['desk' => ['price' => 100]]];
Arr::set($array, 'products.desk.price', 200);
// ['products' => ['desk' => ['price' => 200]]]

// ドット記法で値を取り除く
$array = ['products' => ['desk' => ['price' => 100]]];
Arr::forget($array, 'products.desk');
// ['products' => []]

// 値を取り出して、配列からは取り除く
$array = ['name' => 'Desk', 'price' => 100];
$name = Arr::pull($array, 'name');
// $name: Desk、$array: ['price' => 100]
Arr::pull($array, $key, $default); // 3つ目は、キーが無いときの既定値

// 指定したキーを取り除く・残す
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
Arr::except($array, ['price']);        // ['name' => 'Desk', 'orders' => 10]
Arr::only($array, ['name', 'price']);  // ['name' => 'Desk', 'price' => 100]

// 指定した値を取り除く・残す（strict: true で、型まで同じものだけを対象にする）
$array = ['foo', 'bar', 'baz', 'qux'];
Arr::exceptValues($array, ['foo', 'baz']); // ['bar', 'qux']
Arr::onlyValues($array, ['foo', 'baz']);   // ['foo', 'baz']

$array = [1, '1', 2, '2'];
Arr::exceptValues($array, [1, 2], strict: true); // ['1', '2']
Arr::onlyValues($array, [1, 2], strict: true);   // [1, 2]

// 条件で取り除く・残す
$array = [100, '200', 300, '400', 500];
Arr::reject($array, function (string|int $value, int $key) {
    return is_string($value);
}); // [0 => 100, 2 => 300, 4 => 500]
Arr::where($array, function (string|int $value, int $key) {
    return is_string($value);
}); // [1 => '200', 3 => '400']

// null を取り除く
Arr::whereNotNull([0, null]); // [0 => 0]

// まだ無い値だけを入れる
$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);
// 2つ目の price だけが 200 で入る

// 値を入れる（既定では、あるものも上書きする）
$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);
// どちらの price も 200 になる

// 上書きしたくないときは overwrite: false
$data = ['products' => ['desk' => ['price' => 100]]];
data_set($data, 'products.desk.price', 200, overwrite: false);
// ['products' => ['desk' => ['price' => 100]]]

// 値を取り除く
$data = ['products' => ['desk' => ['price' => 100]]];
data_forget($data, 'products.desk.price');
// ['products' => ['desk' => []]]

$data = [
    'products' => [
        ['name' => 'Desk 1', 'price' => 100],
        ['name' => 'Desk 2', 'price' => 150],
    ],
];
data_forget($data, 'products.*.price');
// どちらの price も取り除かれる

$data = ['products' => ['desk' => ['price' => 100]]];
data_get($data, 'products.desk.price');        // 100
data_get($data, 'products.desk.discount', 0);  // 0

$data = [
    'product-one' => ['name' => 'Desk 1', 'price' => 100],
    'product-two' => ['name' => 'Desk 2', 'price' => 150],
];
data_get($data, '*.name'); // ['Desk 1', 'Desk 2']

$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

// 配列の配列を、1つにまとめる
Arr::collapse([[1, 2, 3], [4, 5, 6], [7, 8, 9]]); // [1, 2, 3, 4, 5, 6, 7, 8, 9]

// すべての組み合わせ
Arr::crossJoin([1, 2], ['a', 'b']);
// [[1, 'a'], [1, 'b'], [2, 'a'], [2, 'b']]
Arr::crossJoin([1, 2], ['a', 'b'], ['I', 'II']);
// 3つの配列でも使える（2 × 2 × 2 で8通りの組み合わせ）

// キーと値に分ける
[$keys, $values] = Arr::divide(['name' => 'Desk']);
// $keys: ['name']、$values: ['Desk']

// 多次元の配列を、ドット記法の1段にする・戻す
Arr::dot(['products' => ['desk' => ['price' => 100]]]);
// ['products.desk.price' => 100]
Arr::undot([
    'user.name' => 'Kevin Malone',
    'user.occupation' => 'Accountant',
]);
// ['user' => ['name' => 'Kevin Malone', 'occupation' => 'Accountant']]

// 1段の配列にする
Arr::flatten(['name' => 'Joe', 'languages' => ['PHP', 'Ruby']]); // ['Joe', 'PHP', 'Ruby']

// 配列に変える（オブジェクト、Arrayable、Enumerable、Jsonable、JsonSerializable、
// Traversable、WeakMap などに対応）
Arr::from((object) ['foo' => 'bar']); // ['foo' => 'bar']

// つなぐ（3つ目は、最後の要素の前につなぐ文字）
$array = ['Tailwind', 'Alpine', 'Laravel', 'Livewire'];
Arr::join($array, ', ');            // Tailwind, Alpine, Laravel, Livewire
Arr::join($array, ', ', ', and ');  // Tailwind, Alpine, Laravel, and Livewire

// 指定した項目をキーにする（同じキーは、最後の1つだけが残る）
$array = [
    ['product_id' => 'prod-100', 'name' => 'Desk'],
    ['product_id' => 'prod-200', 'name' => 'Chair'],
];
Arr::keyBy($array, 'product_id');
// ['prod-100' => [...], 'prod-200' => [...]]

// 各要素を関数で変える
Arr::map(['first' => 'james', 'last' => 'kirk'], function (string $value, string $key) {
    return ucfirst($value);
}); // ['first' => 'James', 'last' => 'Kirk']

// 入れ子の要素を、引数に展開して変える
Arr::mapSpread([[0, 1], [2, 3], [4, 5], [6, 7], [8, 9]], function (int $even, int $odd) {
    return $even + $odd;
}); // [1, 5, 9, 13, 17]

// 関数が返した「キーと値」で新しい配列を作る
$array = [
    ['name' => 'John', 'department' => 'Sales', 'email' => 'john@example.com'],
    ['name' => 'Jane', 'department' => 'Marketing', 'email' => 'jane@example.com'],
];
Arr::mapWithKeys($array, function (array $item, int $key) {
    return [$item['email'] => $item['name']];
}); // ['john@example.com' => 'John', 'jane@example.com' => 'Jane']

// 2つに分ける（配列の分割代入と組み合わせる）
$numbers = [1, 2, 3, 4, 5, 6];
[$underThree, $equalOrAboveThree] = Arr::partition($numbers, function (int $i) {
    return $i < 3;
});
// $underThree: [1, 2]、$equalOrAboveThree: [3, 4, 5, 6]

// 指定したキーの値だけを集める（3つ目は、結果のキーにする項目）
$array = [
    ['developer' => ['id' => 1, 'name' => 'Taylor']],
    ['developer' => ['id' => 2, 'name' => 'Abigail']],
];
Arr::pluck($array, 'developer.name');               // ['Taylor', 'Abigail']
Arr::pluck($array, 'developer.name', 'developer.id'); // [1 => 'Taylor', 2 => 'Abigail']

// キーの前に文字を付ける
Arr::prependKeysWith(['name' => 'Desk', 'price' => 100], 'product.');
// ['product.name' => 'Desk', 'product.price' => 100]

// クエリ文字列にする
Arr::query([
    'name' => 'Taylor',
    'order' => ['column' => 'created_at', 'direction' => 'desc'],
]);
// name=Taylor&order%5Bcolumn%5D=created_at&order%5Bdirection%5D=desc

// ランダムに取り出す（個数を渡すと、1つでも配列で返る）
Arr::random([1, 2, 3, 4, 5]);     // 4（ランダム）
Arr::random([1, 2, 3, 4, 5], 2);  // [2, 5]（ランダム）

// ランダムに並べかえる
Arr::shuffle([1, 2, 3, 4, 5]); // [3, 2, 5, 1, 4]（ランダム）

// 必要な項目だけを取り出す
$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::take([0, 1, 2, 3, 4, 5], 3);   // [0, 1, 2]
Arr::take([0, 1, 2, 3, 4, 5], -2);  // [4, 5]

// 値で並べかえる（関数の結果で並べかえることもできる）
$array = ['Desk', 'Table', 'Chair'];
Arr::sort($array);      // ['Chair', 'Desk', 'Table']
Arr::sortDesc($array);  // ['Table', 'Desk', 'Chair']

$array = [
    ['name' => 'Desk'],
    ['name' => 'Table'],
    ['name' => 'Chair'],
];
$sorted = array_values(Arr::sort($array, function (array $value) {
    return $value['name'];
})); // Chair、Desk、Table の順

// 入れ子の配列も並べかえる。数字のキーの配列は sort、連想配列は ksort
$array = [
    ['Roman', 'Taylor', 'Li'],
    ['PHP', 'Ruby', 'JavaScript'],
    ['one' => 1, 'two' => 2, 'three' => 3],
];
Arr::sortRecursive($array);
// [['JavaScript', 'PHP', 'Ruby'], ['one' => 1, 'three' => 3, 'two' => 2], ['Li', 'Roman', 'Taylor']]
Arr::sortRecursiveDesc($array); // 大きい順にしたいときはこちら

// 配列で包む
Arr::wrap('Laravel'); // ['Laravel']
Arr::wrap(null);      // []

$isActive = false;
$hasError = true;

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

Arr::toCssClasses($array); // 'p-4 bg-red'

$hasColor = true;

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

Arr::toCssStyles($array); // 'background-color: blue; color: blue;'

// 単位を短くする
Number::abbreviate(1000);                  // 1K
Number::abbreviate(489939);                // 490K
Number::abbreviate(1230000, precision: 2); // 1.23M

// 範囲に収める
Number::clamp(105, min: 10, max: 100); // 100
Number::clamp(5, min: 10, max: 100);   // 10
Number::clamp(10, min: 10, max: 100);  // 10
Number::clamp(20, min: 10, max: 100);  // 20

// 通貨の形にする
Number::currency(1000);                                                  // $1,000.00
Number::currency(1000, in: 'EUR');                                       // €1,000.00
Number::currency(1000, in: 'EUR', locale: 'de');                         // 1.000,00 €
Number::currency(1000, in: 'EUR', locale: 'de', precision: 0);           // 1.000 €

// 既定の通貨・ロケール
Number::defaultCurrency(); // USD
Number::defaultLocale();   // en

// ファイルの大きさの形にする
Number::fileSize(1024);                 // 1 KB
Number::fileSize(1024 * 1024);          // 1 MB
Number::fileSize(1024, precision: 2);   // 1.00 KB

// 言葉を使った形にする
Number::forHumans(1000);                  // 1 thousand
Number::forHumans(489939);                // 490 thousand
Number::forHumans(1230000, precision: 2); // 1.23 million

// ロケールに合わせた形にする
Number::format(100000);                     // 100,000
Number::format(100000, precision: 2);       // 100,000.00
Number::format(100000.123, maxPrecision: 2); // 100,000.12
Number::format(100000, locale: 'de');       // 100.000

// 順番の形にする
Number::ordinal(1);   // 1st
Number::ordinal(2);   // 2nd
Number::ordinal(21);  // 21st

// 範囲を組に分ける。ページ送りや、仕事を小分けにするときに使える
Number::pairs(25, 10);              // [[0, 9], [10, 19], [20, 25]]
Number::pairs(25, 10, offset: 0);   // [[0, 10], [10, 20], [20, 25]]

// 文字列を数として読みとる（PHP の NumberFormatter を使う）
Number::parse('10,123', locale: 'en');   // 10123.0
Number::parse('10,123', locale: 'fr');   // 10.123
Number::parseInt('10.123');              // (int) 10
Number::parseInt('10,123', locale: 'fr'); // (int) 10
Number::parseFloat('10');                // (float) 10.0
Number::parseFloat('10', locale: 'fr');  // (float) 10.0

// パーセントの形にする
Number::percentage(10);                              // 10%
Number::percentage(10, precision: 2);                // 10.00%
Number::percentage(10.123, maxPrecision: 2);         // 10.12%
Number::percentage(10, precision: 2, locale: 'de');  // 10,00%

// 言葉の文字列にする
Number::spell(102);               // one hundred and two
Number::spell(88, locale: 'fr');  // quatre-vingt-huit

// after の値より大きい数だけを、言葉にする
Number::spell(10, after: 10);  // 10
Number::spell(11, after: 10);  // eleven

// until の値より小さい数だけを、言葉にする
Number::spell(5, until: 10);   // five
Number::spell(10, until: 10);  // 10

Number::spellOrdinal(1);   // first
Number::spellOrdinal(2);   // second
Number::spellOrdinal(21);  // twenty-first

// 終わりの 0 を取り除く
Number::trim(12.0);   // 12
Number::trim(12.30);  // 12.3

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

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

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

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

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

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

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

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

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

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

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

use App\Http\Controllers\HomeController;

// コントローラーのメソッドへの URL
$url = action([HomeController::class, 'index']);
// ルートのパラメーターは、2つ目の引数で渡す
$url = action([UserController::class, 'profile'], ['id' => 1]);

// ファイルへの URL
$url = asset('img/photo.jpg');

// ファイルを S3 や CDN のような外のサービスに置くなら、.env の ASSET_URL で、ホストを決められる
// ASSET_URL=http://example.com/assets
$url = asset('img/photo.jpg'); // http://example.com/assets/img/photo.jpg

// 名前を付けたルートへの URL
$url = route('route.name');
$url = route('route.name', ['id' => 1]);
// 既定は、完全な URL。相対の URL にしたいときは、3つ目に false を渡す
$url = route('route.name', ['id' => 1], false);

// HTTPS で作る
$url = secure_asset('img/photo.jpg');
$url = secure_url('user/profile');
$url = secure_url('user/profile', [1]); // 2つ目で、URL の部品を足せる

// 指定したパスへの完全な URL
$url = url('user/profile');
$url = url('user/profile', [1]);

// パスを渡さないと、UrlGenerator が返る
$current = url()->current();
$full = url()->full();
$previous = url()->previous();

use App\Http\Controllers\UserController;

return to_action([UserController::class, 'show'], ['user' => 1]);

return to_action(
    [UserController::class, 'show'],
    ['user' => 1],
    302,
    ['X-Framework' => 'Laravel']
);

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

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

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

// コントローラーとメソッドの組を渡すと、そのルートのパスの Uri ができる
$uri = uri([UserController::class, 'show'], ['user' => $user]);

// 1つの処理だけを持つコントローラーなら、クラス名だけでよい
$uri = uri(UserIndexController::class);

// ルートの名前に合えば、そのルートのパスの Uri ができる
$uri = uri('users.show', ['user' => $user]);

abort(403);

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

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

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

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

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

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

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

report($e);

report('Something went wrong.');

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

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

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

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

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

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

return retry(5, function () {
    // 5回ためす。ためすたびに、100ミリ秒休む...
}, 100);

use function Illuminate\Support\seconds;

return retry(5, function () {
    // 5回ためす。ためすたびに、5秒休む...
}, seconds(5));

use Exception;

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

return retry([100, 200], function () {
    // 1回目のやり直しの前に100ミリ秒、2回目の前に200ミリ秒休む...
});

use App\Exceptions\TemporaryException;
use Exception;

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

// サービスコンテナ
$container = app();
$api = app('HelpSpot\API');   // クラス名を渡すと、取り出せる
$api = resolve('HelpSpot\API'); // resolve でも同じ

// 認証。Auth ファサードの代わりに使える
$user = auth()->user();
$user = auth('admin')->user(); // ガード（ログインを確かめる係）も選べる

// 設定値
$value = config('app.timezone');
$value = config('app.timezone', $default);
// 動いている間だけ変える（本当の設定は変わらない）
config(['app.debug' => true]);

// コンテキスト
$value = context('trace_id');
$value = context('trace_id', $default);
context(['trace_id' => Str::uuid()->toString()]);

// 環境変数
$env = env('APP_ENV');
$env = env('APP_ENV', 'production');

// ポリシー
$policy = policy(App\Models\User::class);

// バリデーション
$validator = validator($data, $rules, $messages);

// リクエスト
$request = request();
$value = request('key', $default);

// セッション
$value = session('key');
session(['chairs' => 7, 'instruments' => 3]);
// 引数が無ければ、セッションを返す
$value = session()->get('key');
session()->put('key', $value);

// キャッシュから取り出す（無ければ、2つ目の既定値）
$value = cache('key');
$value = cache('key', 'default');

// キャッシュに入れる（2つ目に、有効な秒数か長さを渡す）
cache(['key' => 'value'], 300);
cache(['key' => 'value'], now()->plus(seconds: 10));

// Bcrypt でハッシュにする。Hash ファサードの代わりに使える
$password = bcrypt('my-secret-password');

// 暗号化と復号。Crypt ファサードの代わりに使える
$secret = encrypt('my-secret-value');
$password = decrypt($value);

// 前にいた場所へ戻す（ステータス、ヘッダー、戻れないときの行き先）
return back($status = 302, $headers = [], $fallback = '/');
return back();

// リダイレクトのレスポンス。引数が無ければ、リダイレクトを作るものが返る
return redirect($to = null, $status = 302, $headers = [], $secure = null);
return redirect('/home');
return redirect()->route('route.name');

// レスポンス。引数が無ければ、レスポンスを作るものが返る
return response('Hello World', 200, $headers);
return response()->json(['foo' => 'bar'], 200, $headers);

// ビュー
return view('auth.login');

// Cookie を作る
$cookie = cookie('name', 'value', $minutes);

{{-- CSRF トークンを入れた隠し入力欄 --}}
{{ csrf_field() }}

{{-- フォームの HTTP メソッドを装う隠し入力欄 --}}
<form method="POST">
    {{ method_field('DELETE') }}
</form>

// CSRF トークンの値
$token = csrf_token();

// 直前の入力の値（無ければ、2つ目の既定値）
$value = old('value');
$value = old('value', 'default');

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

{{-- 上と同じ --}}
{{ old('name', $user) }}

// ジョブをキューに入れる
dispatch(new App\Jobs\SendEmails);

// ジョブをすぐ動かす
dispatch_sync(new App\Jobs\SendEmails);

// イベントを出して、リスナーに知らせる
event(new UserRegistered($user));

// ブロードキャストする（toOthers() で、自分以外にだけ送る）
broadcast(new UserRegistered($user));
broadcast(new UserRegistered($user))->toOthers();

broadcast_if($user->isActive(), new UserRegistered($user));
broadcast_if($user->isActive(), new UserRegistered($user))->toOthers();

broadcast_unless($user->isBanned(), new UserRegistered($user));
broadcast_unless($user->isBanned(), new UserRegistered($user))->toOthers();

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

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

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

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

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

blank('');
blank('   ');
blank(null);
blank(collect());
// true

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

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

filled('');
filled('   ');
filled(null);
filled(collect());
// false

// コレクションを作る
$collection = collect(['Taylor', 'Abigail']);

// 名前つきの引数をプロパティに持つオブジェクト（stdClass）を作る
$obj = literal(
    name: 'Joe',
    languages: ['PHP', 'Ruby'],
);

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

// いまの時刻・きょうの日付
$now = now();
$today = today();

// クラスやトレイトが使っているトレイトを、すべて返す
$traits = class_uses_recursive(App\Models\User::class);
$traits = trait_uses_recursive(\Illuminate\Notifications\Notifiable::class);

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

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

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

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

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

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

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

$result = transform(5, $callback);
// 10

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

$result = value(true);
// true

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

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

$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

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

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

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

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

random(); // 123
random(); // 123（覚えておいた結果）
random(); // 123（覚えておいた結果）

<?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(); // （覚えておいた結果）

@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('nl_NL')->name();

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

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

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

$now = now();

use Illuminate\Support\Carbon;

$now = Carbon::now();

return now()->plus(minutes: 5);
return now()->plus(hours: 8);
return now()->plus(weeks: 4);
return now()->minus(minutes: 5);
return now()->minus(hours: 8);
return now()->minus(weeks: 4);

use Illuminate\Support\Facades\Cache;

use function Illuminate\Support\{minutes};

Cache::put('metrics', $metrics, minutes(10));

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

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

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

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

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

    // ...
});

use Tests\TestCase;

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

        // ...
    }
}

<?php

namespace Tests;

use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

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

        $this->withoutDefer();
    }
}

use Illuminate\Support\Lottery;

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

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.')),
);

// いつも当たる...
Lottery::alwaysWin();

// いつもはずれる...
Lottery::alwaysLose();

// 当たり、はずれの順になって、最後に、ふつうの動きに戻る...
Lottery::fix([true, false]);

// ふつうの動きに戻る...
Lottery::determineResultsNormally();

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

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

$user = Pipeline::send($user)
    ->withinTransaction()
    ->through([
        ProcessOrder::class,
        TransferFunds::class,
        UpdateInventory::class,
    ])
    ->thenReturn();

use Illuminate\Support\Sleep;

$waiting = true;

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

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

// 休んだあとに、値を返す...
$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()->plus(minutes: 1));

// PHP の「sleep」関数の別名...
Sleep::sleep(2);

// PHP の「usleep」関数の別名...
Sleep::usleep(5000);

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

$waiting = /* ... */;

$seconds = 1;

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

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

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

    // ...
});

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

    // ...
}

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

    // ...

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

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(),
    ]);
}

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

use Carbon\CarbonInterval as Duration;

$this->freezeTime();

Sleep::fake();

Sleep::whenFakingSleep(function (Duration $duration) {
    // 休みをフェイクにしたとき、時間を進める...
    $this->travel($duration->totalMilliseconds)->milliseconds();
});

Sleep::fake(syncWithCarbon: true);

$start = now();

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

$start->diffForHumans(); // 1 second ago

use Illuminate\Support\Timebox;

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

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

// 文字列から作る...
$uri = Uri::of('https://example.com/path');

// パス・名前を付けたルート・コントローラーのメソッドから作る...
$uri = Uri::to('/dashboard');
$uri = Uri::route('users.show', ['user' => 1]);
$uri = Uri::signedRoute('users.show', ['user' => 1]);
$uri = Uri::temporarySignedRoute('user.index', now()->plus(minutes: 5));
$uri = Uri::action([UserController::class, 'index']);
$uri = Uri::action(InvokableController::class);

// いまのリクエストの URL から作る...
$uri = $request->uri();

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

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

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

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

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

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

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

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

return $uri->redirect();

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

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