یاوران

• معرفی
• روش های موجود
• سایر ابزارهای کمکی
  • محک زدن
  • تاریخ
  • بخت آزمایی
  • خط لوله
  • خواب

معرفی

لاراول شامل انواع مختلفی از توابع جهانی "کمک کننده" PHP است. بسیاری از این توابع توسط خود چارچوب استفاده می شود. با این حال، شما آزاد هستید که از آنها در برنامه های کاربردی خود استفاده کنید اگر آنها را راحت می دانید.

روش های موجود

آرایه ها و اشیاء

شماره

راه ها

URL ها

متفرقه

آرایه ها و اشیاء

Arr::accessible()

این Arr::accessible روش تعیین می کند که آیا مقدار داده شده در دسترس آرایه است یا خیر:

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 :

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::collapse()

این Arr::collapse روش یک آرایه از آرایه ها را در یک آرایه منفرد جمع می کند:

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 متقاطع به آرایه های داده شده می پیوندد و یک محصول دکارتی را با همه جایگشت های ممکن برمی گرداند:

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 دو آرایه را برمی گرداند: یکی حاوی کلیدها و دیگری حاوی مقادیر آرایه داده شده:

use Illuminate\Support\Arr;
 
[$keys, $values] = Arr::divide(['name' => 'Desk']);
 
// $keys: ['name']
 
// $values: ['Desk']

Arr::dot()

این Arr::dot روش یک آرایه چند بعدی را به یک آرایه سطح تکی مسطح می کند که از نماد "نقطه" برای نشان دادن عمق استفاده می کند:

use Illuminate\Support\Arr;
 
$array = ['products' => ['desk' => ['price' => 100]]];
 
$flattened = Arr::dot($array);
 
// ['products.desk.price' => 100]

Arr::except()

این Arr::except روش جفت های کلید / مقدار داده شده را از یک آرایه حذف می کند:

use Illuminate\Support\Arr;
 
$array = ['name' => 'Desk', 'price' => 100];
 
$filtered = Arr::except($array, ['price']);
 
// ['name' => 'Desk']

Arr::exists()

متد Arr::exists بررسی می کند که کلید داده شده در آرایه ارائه شده وجود داشته باشد:

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 متد اولین عنصر آرایه ای را که آزمون صدق داده شده را رد می کند، برمی گرداند:

use Illuminate\Support\Arr;
 
$array = [100, 200, 300];
 
$first = Arr::first($array, function (int $value, int $key) {
    return $value >= 150;
});
 
// 200

یک مقدار پیش فرض نیز ممکن است به عنوان پارامتر سوم به متد ارسال شود. در صورتی که هیچ مقداری از آزمون حقیقت عبور نکند، این مقدار برگردانده خواهد شد:

use Illuminate\Support\Arr;
 
$first = Arr::first($array, $callback, $default);

Arr::flatten()

این Arr::flatten روش یک آرایه چند بعدی را به یک آرایه سطح واحد مسطح می کند:

use Illuminate\Support\Arr;
 
$array = ['name' => 'Joe', 'languages' => ['PHP', 'Ruby']];
 
$flattened = Arr::flatten($array);
 
// ['Joe', 'PHP', 'Ruby']

Arr::forget()

این Arr::forget روش یک جفت کلید/مقدار داده شده را از یک آرایه عمیق تو در تو با استفاده از نماد "نقطه" حذف می کند:

use Illuminate\Support\Arr;
 
$array = ['products' => ['desk' => ['price' => 100]]];
 
Arr::forget($array, 'products.desk');
 
// ['products' => []]

Arr::get()

این Arr::get روش مقداری را از یک آرایه عمیق تو در تو با استفاده از نماد "نقطه" بازیابی می کند:

use Illuminate\Support\Arr;
 
$array = ['products' => ['desk' => ['price' => 100]]];
 
$price = Arr::get($array, 'products.desk.price');
 
// 100

این Arr::get متد یک مقدار پیش‌فرض را نیز می‌پذیرد که اگر کلید مشخص شده در آرایه وجود نداشته باشد، برگردانده می‌شود:

use Illuminate\Support\Arr;
 
$discount = Arr::get($array, 'products.desk.discount', 0);
 
// 0

Arr::has()

این Arr::has روش بررسی می کند که آیا یک مورد یا موارد داده شده در یک آرایه با استفاده از نماد "نقطه" وجود دارد یا خیر:

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::hasAny()

این Arr::hasAny روش بررسی می‌کند که آیا هر آیتمی در یک مجموعه داده شده در یک آرایه با استفاده از نماد "نقطه" وجود دارد یا خیر:

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::isAssoc()

اگر آرایه داده شده یک آرایه انجمنی باشد، روش Arr::isAssoc برمی گردد . true اگر یک آرایه دارای کلیدهای عددی متوالی نباشد که با صفر شروع می شوند، "تداعی" در نظر گرفته می شود:

use Illuminate\Support\Arr;
 
$isAssoc = Arr::isAssoc(['product' => ['name' => 'Desk', 'price' => 100]]);
 
// true
 
$isAssoc = Arr::isAssoc([1, 2, 3]);
 
// false

Arr::isList()

اگر کلیدهای آرایه داده شده اعداد صحیح متوالی باشند که از صفر شروع می شوند، روش Arr::isList برمی گردد : true

use Illuminate\Support\Arr;
 
$isList = Arr::isList(['foo', 'bar', 'baz']);
 
// true
 
$isList = Arr::isList(['product' => ['name' => 'Desk', 'price' => 100]]);
 
// false

Arr::join()

متد Arr::join عناصر آرایه را با یک رشته به هم می پیوندد. با استفاده از آرگومان دوم این روش، می‌توانید رشته اتصال را برای عنصر نهایی آرایه نیز مشخص کنید:

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 آرایه را با کلید داده شده کلید می زند. اگر چندین آیتم دارای یک کلید باشند، فقط آخرین مورد در آرایه جدید ظاهر می شود:

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 آخرین عنصر آرایه ای را که آزمون صدق داده شده را رد می کند، برمی گرداند:

use Illuminate\Support\Arr;
 
$array = [100, 200, 300, 110];
 
$last = Arr::last($array, function (int $value, int $key) {
    return $value >= 150;
});
 
// 300

یک مقدار پیش فرض ممکن است به عنوان آرگومان سوم به متد ارسال شود. در صورتی که هیچ مقداری از آزمون حقیقت عبور نکند، این مقدار برگردانده خواهد شد:

use Illuminate\Support\Arr;
 
$last = Arr::last($array, $callback, $default);

Arr::map()

متد Arr::map از طریق آرایه تکرار می شود و هر مقدار و کلید را به فراخوانی داده شده ارسال می کند. مقدار آرایه با مقدار بازگشتی با callback جایگزین می شود:

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 بر روی آرایه تکرار می شود و هر مقدار مورد تو در تو را به بسته داده شده ارسال می کند. بسته شدن برای اصلاح آیتم و بازگرداندن آن آزاد است، بنابراین آرایه جدیدی از موارد اصلاح شده تشکیل می شود:

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 از طریق آرایه تکرار می شود و هر مقدار را به callback داده شده ارسال می کند. تماس برگشتی باید یک آرایه انجمنی حاوی یک جفت کلید / مقدار را برگرداند:

use Illuminate\Support\Arr;
 
$array = [
    [
        'name' => 'John',
        'department' => 'Sales',
        'email' => 'john@example.com',
    ],
    [
        'name' => 'Jane',
        'department' => 'Marketing',
        'email' => 'jane@example.com',
    ]
];
 
$mapped = Arr::mapWithKeys($array, function (array $item, int $key) {
    return [$item['email'] => $item['name']];
});
 
/*
    [
        'john@example.com' => 'John',
        'jane@example.com' => 'Jane',
    ]
*/

Arr::only()

متد Arr::only فقط جفت های کلید/مقدار مشخص شده را از آرایه داده شده برمی گرداند:

use Illuminate\Support\Arr;
 
$array = ['name' => 'Desk', 'price' => 100, 'orders' => 10];
 
$slice = Arr::only($array, ['name', 'price']);
 
// ['name' => 'Desk', 'price' => 100]

Arr::pluck()

این Arr::pluck متد تمام مقادیر یک کلید داده شده را از یک آرایه بازیابی می کند:

use Illuminate\Support\Arr;
 
$array = [
    ['developer' => ['id' => 1, 'name' => 'Taylor']],
    ['developer' => ['id' => 2, 'name' => 'Abigail']],
];
 
$names = Arr::pluck($array, 'developer.name');
 
// ['Taylor', 'Abigail']

همچنین می‌توانید تعیین کنید که چگونه می‌خواهید فهرست به دست آمده کلید شود:

use Illuminate\Support\Arr;
 
$names = Arr::pluck($array, 'developer.name', 'developer.id');
 
// [1 => 'Taylor', 2 => 'Abigail']

Arr::prepend()

این Arr::prepend روش یک آیتم را به ابتدای یک آرایه فشار می دهد:

use Illuminate\Support\Arr;
 
$array = ['one', 'two', 'three', 'four'];
 
$array = Arr::prepend($array, 'zero');
 
// ['zero', 'one', 'two', 'three', 'four']

در صورت نیاز، می توانید کلیدی را که باید برای مقدار استفاده شود مشخص کنید:

use Illuminate\Support\Arr;
 
$array = ['price' => 100];
 
$array = Arr::prepend($array, 'Desk', 'name');
 
// ['name' => 'Desk', 'price' => 100]

Arr::prependKeysWith()

Arr::prependKeysWith تمام نام‌های کلیدی یک آرایه انجمنی را با پیشوند داده شده اضافه می‌کند :

use Illuminate\Support\Arr;
 
$array = [
    'name' => 'Desk',
    'price' => 100,
];
 
$keyed = Arr::prependKeysWith($array, 'product.');
 
/*
    [
        'product.name' => 'Desk',
        'product.price' => 100,
    ]
*/

Arr::pull()

متد Arr::pull یک جفت کلید / مقدار را از یک آرایه برمی گرداند و حذف می کند:

use Illuminate\Support\Arr;
 
$array = ['name' => 'Desk', 'price' => 100];
 
$name = Arr::pull($array, 'name');
 
// $name: Desk
 
// $array: ['price' => 100]

یک مقدار پیش فرض ممکن است به عنوان آرگومان سوم به متد ارسال شود. اگر کلید وجود نداشته باشد، این مقدار برگردانده خواهد شد:

use Illuminate\Support\Arr;
 
$value = Arr::pull($array, $key, $default);

Arr::query()

متد Arr::query آرایه را به یک query string تبدیل می کند:

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 یک مقدار تصادفی را از یک آرایه برمی گرداند:

use Illuminate\Support\Arr;
 
$array = [1, 2, 3, 4, 5];
 
$random = Arr::random($array);
 
// 4 - (retrieved randomly)

همچنین می توانید تعداد آیتم هایی را که باید به عنوان آرگومان دوم اختیاری برگردانده شوند، مشخص کنید. توجه داشته باشید که ارائه این آرگومان یک آرایه را برمی گرداند حتی اگر فقط یک آیتم مورد نظر باشد:

use Illuminate\Support\Arr;
 
$items = Arr::random($array, 2);
 
// [2, 5] - (retrieved randomly)

Arr::set()

این Arr::set روش مقداری را در یک آرایه عمیق تو در تو با استفاده از نماد "نقطه" تنظیم می کند:

use Illuminate\Support\Arr;
 
$array = ['products' => ['desk' => ['price' => 100]]];
 
Arr::set($array, 'products.desk.price', 200);
 
// ['products' => ['desk' => ['price' => 200]]]

Arr::shuffle()

این Arr::shuffle روش به طور تصادفی موارد موجود در آرایه را با هم مخلوط می کند:

use Illuminate\Support\Arr;
 
$array = Arr::shuffle([1, 2, 3, 4, 5]);
 
// [3, 2, 5, 1, 4] - (generated randomly)

Arr::sort()

متد Arr::sort یک آرایه را بر اساس مقادیر آن مرتب می کند:

use Illuminate\Support\Arr;
 
$array = ['Desk', 'Table', 'Chair'];
 
$sorted = Arr::sort($array);
 
// ['Chair', 'Desk', 'Table']

همچنین می توانید آرایه را بر اساس نتایج یک بسته شدن مشخص مرتب کنید:

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 روش یک آرایه را به ترتیب نزولی بر اساس مقادیر آن مرتب می کند:

use Illuminate\Support\Arr;
 
$array = ['Desk', 'Table', 'Chair'];
 
$sorted = Arr::sortDesc($array);
 
// ['Table', 'Desk', 'Chair']

همچنین می توانید آرایه را بر اساس نتایج یک بسته شدن مشخص مرتب کنید:

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 تابع برای زیر آرایه های انجمنی مرتب می کند:

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 روش استفاده کنید.

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

Arr::take()

این Arr::take متد یک آرایه جدید با تعداد آیتم های مشخص شده برمی گرداند:

use Illuminate\Support\Arr;
 
$array = [0, 1, 2, 3, 4, 5];
 
$chunk = Arr::take($array, 3);
 
// [0, 1, 2]

همچنین می توانید یک عدد صحیح منفی ارسال کنید تا تعداد مشخص شده آیتم ها را از انتهای آرایه بردارید:

$array = [0, 1, 2, 3, 4, 5];
 
$chunk = Arr::take($array, -2);
 
// [4, 5]

Arr::toCssClasses()

این Arr::toCssClasses روش به صورت مشروط یک رشته کلاس CSS را کامپایل می کند. متد آرایه ای از کلاس ها را می پذیرد که در آن کلید آرایه شامل کلاس یا کلاس هایی است که می خواهید اضافه کنید، در حالی که مقدار یک عبارت بولی است. اگر عنصر آرایه دارای یک کلید عددی باشد، همیشه در لیست کلاس رندر شده قرار می گیرد:

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 را کامپایل می کند. متد آرایه ای از کلاس ها را می پذیرد که در آن کلید آرایه شامل کلاس یا کلاس هایی است که می خواهید اضافه کنید، در حالی که مقدار یک عبارت بولی است. اگر عنصر آرایه دارای یک کلید عددی باشد، همیشه در لیست کلاس رندر شده قرار می گیرد:

use Illuminate\Support\Arr;
 
$hasColor = true;
 
$array = ['background-color: blue', 'color: blue' => $hasColor];
 
$classes = Arr::toCssStyles($array);
 
/*
    'background-color: blue; color: blue;'
*/

این روش عملکرد لاراول را تقویت می کند و اجازه می دهد تا کلاس ها را با کیسه ویژگی Blade جزء و همچنین @class دستورالعمل Blade ادغام کنند .

Arr::undot()

این Arr::undot روش یک آرایه تک بعدی را که از نماد "نقطه" استفاده می کند به یک آرایه چند بعدی گسترش می دهد:

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 روش یک آرایه را با استفاده از بسته شدن داده شده فیلتر می کند:

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 مقادیر را از آرایه داده شده حذف می کند:

use Illuminate\Support\Arr;
 
$array = [0, null];
 
$filtered = Arr::whereNotNull($array);
 
// [0 => 0]

Arr::wrap()

این Arr::wrap روش مقدار داده شده را در یک آرایه پیچیده می کند. اگر مقدار داده شده از قبل یک آرایه باشد، بدون تغییر برگردانده می شود:

use Illuminate\Support\Arr;
 
$string = 'Laravel';
 
$array = Arr::wrap($string);
 
// ['Laravel']

اگر مقدار داده شده باشد null ، یک آرایه خالی برگردانده می شود:

use Illuminate\Support\Arr;
 
$array = Arr::wrap(null);
 
// []

data_fill()

این 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()

این 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 = [
    'product-one' => ['name' => 'Desk 1', 'price' => 100],
    'product-two' => ['name' => 'Desk 2', 'price' => 150],
];
 
data_get($data, '*.name');
 
// ['Desk 1', 'Desk 2'];

و ممکن {first} است {last} برای بازیابی اولین یا آخرین موارد در یک آرایه استفاده شود:

$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 تابع مقداری را در یک آرایه یا شی تودرتو با استفاده از نماد "نقطه" تنظیم می کند:

$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, overwrite: false);
 
// ['products' => ['desk' => ['price' => 100]]]

data_forget()

این data_forget تابع مقداری را در یک آرایه یا شی تودرتو با استفاده از نماد "نقطه" حذف می کند:

$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');
 
/*
    [
        'products' => [
            ['name' => 'Desk 1'],
            ['name' => 'Desk 2'],
        ],
    ]
*/

head()

تابع head اولین عنصر در آرایه داده شده را برمی گرداند:

$array = [100, 200, 300];
 
$first = head($array);
 
// 100

last()

تابع last آخرین عنصر در آرایه داده شده را برمی گرداند:

$array = [100, 200, 300];
 
$last = last($array);
 
// 300

شماره

Number::abbreviate()

این Number::abbreviate روش فرمت قابل خواندن توسط انسان مقدار عددی ارائه شده را با یک مخفف برای واحدها برمی گرداند:

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 روش تضمین می کند که یک عدد معین در یک محدوده مشخص باقی می ماند. اگر عدد کمتر از حداقل باشد، مقدار حداقل برگردانده می شود. اگر عدد بالاتر از حداکثر باشد، حداکثر مقدار برگردانده می شود:

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 نمایش ارز مقدار داده شده را به عنوان یک رشته برمی گرداند:

use Illuminate\Support\Number;
 
$currency = Number::currency(1000);
 
// $1,000
 
$currency = Number::currency(1000, in: 'EUR');
 
// €1,000
 
$currency = Number::currency(1000, in: 'EUR', locale: 'de');
 
// 1.000 €

Number::fileSize()

متد Number::fileSize نمایش اندازه فایل مقدار بایت داده شده را به صورت رشته ای برمی گرداند:

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 روش فرمت قابل خواندن توسط انسان مقدار عددی ارائه شده را برمی گرداند:

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 عدد داده شده را در یک رشته خاص محلی قالب بندی می کند:

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 روش نمایش ترتیبی یک عدد را برمی گرداند:

use Illuminate\Support\Number;
 
$number = Number::ordinal(1);
 
// 1st
 
$number = Number::ordinal(2);
 
// 2nd
 
$number = Number::ordinal(21);
 
// 21st

Number::percentage()

متد Number::percentage درصد نمایش مقدار داده شده را به عنوان یک رشته برمی گرداند:

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 روش عدد داده شده را به یک رشته از کلمات تبدیل می کند:

use Illuminate\Support\Number;
 
$number = Number::spell(102);
 
// one hundred and two
 
$number = Number::spell(88, locale: 'fr');
 
// quatre-vingt-huit

آرگومان after به شما امکان می دهد مقداری را مشخص کنید که پس از آن همه اعداد باید املا شوند:

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

آرگومان until به شما امکان می دهد مقداری را مشخص کنید که قبل از آن همه اعداد باید املا شوند:

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

Number::useLocale()

این Number::useLocale روش، محلی شماره پیش‌فرض را در سطح جهانی تنظیم می‌کند، که بر نحوه قالب‌بندی اعداد و واحد پول با فراخوانی‌های بعدی متدهای Number کلاس تأثیر می‌گذارد:

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

Number::withLocale()

این Number::withLocale متد بسته شدن داده شده را با استفاده از محلی مشخص شده اجرا می کند و سپس پس از اجرای callback، محلی اصلی را بازیابی می کند:

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

راه ها

app_path()

این app_path تابع مسیر کاملا واجد شرایط را به app فهرست برنامه شما برمی گرداند. همچنین می توانید از این app_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل نسبت به فهرست برنامه استفاده کنید:

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

base_path()

تابع base_path مسیر کاملا واجد شرایط را به دایرکتوری ریشه برنامه شما برمی گرداند. همچنین می توانید از base_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل داده شده نسبت به دایرکتوری ریشه پروژه استفاده کنید:

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

config_path()

این config_path تابع مسیر کاملا واجد شرایط را به config فهرست برنامه شما برمی گرداند. همچنین می‌توانید از این config_path تابع برای ایجاد یک مسیر کاملاً واجد شرایط به یک فایل معین در دایرکتوری پیکربندی برنامه استفاده کنید:

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

database_path()

این database_path تابع مسیر کاملا واجد شرایط را به database فهرست برنامه شما برمی گرداند. همچنین می توانید از database_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل معین در فهرست پایگاه داده استفاده کنید:

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

lang_path()

این lang_path تابع مسیر کاملا واجد شرایط را به lang فهرست برنامه شما برمی گرداند. همچنین می توانید از lang_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل معین در دایرکتوری استفاده کنید:

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

به طور پیش فرض، اسکلت برنامه لاراول شامل lang دایرکتوری نمی شود. اگر می خواهید فایل های زبان لاراول را شخصی سازی کنید، می توانید آنها را از طریق lang:publish دستور Artisan منتشر کنید.

mix()

تابع mix مسیر را به فایل Mix نسخه شده برمی گرداند :

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

public_path()

این public_path تابع مسیر کاملا واجد شرایط را به public فهرست برنامه شما برمی گرداند. همچنین می‌توانید از public_path تابع برای ایجاد یک مسیر کاملاً واجد شرایط به یک فایل معین در فهرست عمومی استفاده کنید:

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

resource_path()

این resource_path تابع مسیر کاملا واجد شرایط را به resources فهرست برنامه شما برمی گرداند. همچنین می توانید از resource_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل معین در فهرست منابع استفاده کنید:

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

storage_path()

این storage_path تابع مسیر کاملا واجد شرایط را به storage فهرست برنامه شما برمی گرداند. همچنین می توانید از این storage_path تابع برای ایجاد یک مسیر کاملا واجد شرایط به یک فایل معین در فهرست ذخیره سازی استفاده کنید:

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

URL ها

action()

تابع action یک URL برای عملکرد کنترلر داده شده ایجاد می کند:

use App\Http\Controllers\HomeController;
 
$url = action([HomeController::class, 'index']);

اگر متد پارامترهای مسیر را بپذیرد، می توانید آنها را به عنوان آرگومان دوم به متد ارسال کنید:

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

asset()

این asset تابع با استفاده از طرح فعلی درخواست (HTTP یا HTTPS)، یک URL برای یک دارایی ایجاد می کند:

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

می‌توانید میزبان URL دارایی را با تنظیم ASSET_URL متغیر در .env فایل خود پیکربندی کنید. اگر دارایی های خود را روی یک سرویس خارجی مانند آمازون S3 یا CDN دیگری میزبانی کنید، می تواند مفید باشد:

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

route()

تابع route یک URL برای یک مسیر با نام مشخص تولید می کند :

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

اگر مسیر پارامترها را می پذیرد، می توانید آنها را به عنوان آرگومان دوم به تابع ارسال کنید:

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

به طور پیش فرض، route تابع یک URL مطلق تولید می کند. اگر می خواهید یک URL نسبی ایجاد کنید، می توانید false به عنوان آرگومان سوم به تابع ارسال کنید:

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

secure_asset()

تابع secure_asset با استفاده از HTTPS یک URL برای یک دارایی ایجاد می کند:

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

secure_url()

تابع secure_url یک URL HTTPS کاملا واجد شرایط به مسیر داده شده تولید می کند. بخش‌های URL اضافی ممکن است در آرگومان دوم تابع ارسال شوند:

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

to_route()

تابع to_route یک پاسخ HTTP تغییر مسیر را برای یک مسیر با نام مشخص تولید می کند :

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

در صورت لزوم، می توانید کد وضعیت HTTP را که باید به ریدایرکت اختصاص داده شود و هر سرصفحه پاسخ اضافی به عنوان آرگومان سوم و چهارم به متد ارسال کنید to_route :

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

url()

تابع url یک URL کاملا واجد شرایط برای مسیر داده شده ایجاد می کند:

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

اگر مسیری ارائه نشده باشد، یک Illuminate\Routing\UrlGenerator نمونه برگردانده می شود:

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

متفرقه

abort()

این abort تابع یک استثنای HTTP ایجاد می کند که توسط کنترل کننده استثنا ارائه می شود :

abort(403);

همچنین می‌توانید پیام استثنا و سرصفحه‌های پاسخ HTTP سفارشی را که باید به مرورگر ارسال شود ارائه دهید:

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

abort_if()

abort_if اگر یک عبارت بولی داده شده به صورت زیر ارزیابی شود، تابع یک استثنا HTTP ایجاد می کند true :

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

مانند abort روش، می‌توانید متن پاسخ استثنا را به عنوان آرگومان سوم و آرایه‌ای از سرصفحه‌های پاسخ سفارشی را به عنوان آرگومان چهارم برای تابع ارائه دهید.

abort_unless()

abort_unless اگر یک عبارت بولی داده شده به صورت زیر ارزیابی شود، تابع یک استثنا HTTP ایجاد می کند false :

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

مانند abort روش، می‌توانید متن پاسخ استثنا را به عنوان آرگومان سوم و آرایه‌ای از سرصفحه‌های پاسخ سفارشی را به عنوان آرگومان چهارم برای تابع ارائه دهید.

app()

تابع نمونه کانتینر سرویس app را برمی گرداند :

$container = app();

می توانید یک کلاس یا نام رابط را برای حل آن از کانتینر ارسال کنید:

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

auth()

تابع auth یک نمونه احراز هویت کننده را برمی گرداند . می توانید از آن به عنوان جایگزینی برای Auth نما استفاده کنید:

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

در صورت نیاز، می توانید مشخص کنید که به کدام نمونه نگهبان می خواهید دسترسی داشته باشید:

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

back()

این back تابع یک پاسخ HTTP تغییر مسیر به مکان قبلی کاربر ایجاد می کند:

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

bcrypt()

تابع با استفاده از Bcrypt مقدار داده شده را هش می کند bcrypt . می توانید از این عملکرد به عنوان جایگزینی برای نما استفاده کنید: Hash

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

blank()

تابع blank تعیین می کند که آیا مقدار داده شده "خالی" است:

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

برای معکوس blank ، filled روش را ببینید.

broadcast()

تابع رویداد داده شده را برای broadcast شنوندگان خود پخش می کند :

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

cache()

این cache تابع ممکن است برای دریافت مقادیر از حافظه پنهان استفاده شود . اگر کلید داده شده در حافظه پنهان وجود نداشته باشد، یک مقدار پیش فرض اختیاری برگردانده می شود:

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

می‌توانید با ارسال آرایه‌ای از جفت‌های کلید/مقدار به تابع، موارد را به حافظه پنهان اضافه کنید. همچنین باید تعداد ثانیه ها یا مدت زمانی را که مقدار کش شده باید معتبر در نظر گرفته شود، بگذرانید:

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

class_uses_recursive()

این class_uses_recursive تابع تمام صفات استفاده شده توسط یک کلاس، از جمله صفات استفاده شده توسط تمام کلاس های والد آن را برمی گرداند:

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

collect()

تابع collect یک نمونه مجموعه از مقدار داده شده ایجاد می کند:

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

config()

تابع config مقدار یک متغیر پیکربندی را دریافت می کند . مقادیر پیکربندی ممکن است با استفاده از نحو "نقطه"، که شامل نام فایل و گزینه ای است که می خواهید به آن دسترسی داشته باشید، قابل دسترسی است. یک مقدار پیش‌فرض ممکن است مشخص شود و اگر گزینه پیکربندی وجود نداشته باشد، برگردانده می‌شود:

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

می‌توانید با ارسال آرایه‌ای از جفت‌های کلید/مقدار، متغیرهای پیکربندی را در زمان اجرا تنظیم کنید. با این حال، توجه داشته باشید که این تابع فقط بر روی مقدار پیکربندی درخواست فعلی تأثیر می گذارد و مقادیر پیکربندی واقعی شما را به روز نمی کند:

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

cookie()

تابع یک نمونه کوکی cookie جدید ایجاد می کند :

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

csrf_field()

تابع csrf_field یک فیلد ورودی HTML hidden حاوی مقدار توکن CSRF تولید می کند. به عنوان مثال، با استفاده از دستور Blade :

{{ csrf_field() }}

csrf_token()

تابع csrf_token مقدار توکن CSRF فعلی را بازیابی می کند:

$token = csrf_token();

decrypt()

تابع مقدار داده شده را رمزگشایی می کند decrypt . می توانید از این عملکرد به عنوان جایگزینی برای نما استفاده کنید: Crypt

$password = decrypt($value);

dd()

تابع dd متغیرهای داده شده را تخلیه می کند و اجرای اسکریپت را پایان می دهد:

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

اگر نمی خواهید اجرای اسکریپت خود را متوقف کنید، dump به جای آن از تابع استفاده کنید.

dispatch()

تابع کار dispatch داده شده را به صف کار لاراول فشار می دهد :

dispatch(new App\Jobs\SendEmails);