یاوران

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

معرفی

لاراول شامل انواع مختلفی از توابع جهانی "کمک کننده" 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 ($value, $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 ($value, $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 ($value, $key) {
    return ucfirst($value);
});
 
// ['first' => 'James', 'last' => 'Kirk']

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 ($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 ($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::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'
*/

این روش عملکرد لاراول را تقویت می کند و اجازه می دهد تا کلاس ها را با کیسه ویژگی 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 ($value, $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'];

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

head()

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

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

last()

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

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

راه ها

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

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

رشته های

__()

تابع __ ، رشته ترجمه یا کلید ترجمه داده شده را با استفاده از فایل های محلی سازی شما ترجمه می کند :

echo __('Welcome to our application');
 
echo __('messages.welcome');

اگر رشته یا کلید ترجمه مشخص شده وجود نداشته باشد، __ تابع مقدار داده شده را برمی گرداند. بنابراین، با استفاده از مثال بالا، اگر کلید ترجمه وجود نداشته باشد، __ تابع برمی گردد . messages.welcome

class_basename()

تابع class_basename نام کلاس کلاس داده شده را با حذف فضای نام کلاس برمی گرداند:

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

e()

این e تابع تابع PHP را htmlspecialchars با double_encode گزینه ای که به صورت پیش فرض تنظیم شده است اجرا می کند true :

echo e('<html>foo</html>');
 
// &lt;html&gt;foo&lt;/html&gt;

preg_replace_array()

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

$string = 'The event will take place between :start and :end';
 
$replaced = preg_replace_array('/:[a-z_]+/', ['8:30', '9:00'], $string);
 
// The event will take place between 8:30 and 9:00

Str::after()

متد Str::after همه چیز را بعد از مقدار داده شده در یک رشته برمی گرداند. اگر مقدار درون رشته وجود نداشته باشد، کل رشته برگردانده خواهد شد:

use Illuminate\Support\Str;
 
$slice = Str::after('This is my name', 'This is');
 
// ' my name'

Str::afterLast()

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

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

Str::ascii()

این Str::ascii روش تلاش خواهد کرد تا رشته را به یک مقدار ASCII تبدیل کند:

use Illuminate\Support\Str;
 
$slice = Str::ascii('û');
 
// 'u'

Str::before()

متد Str::before همه چیز را قبل از مقدار داده شده در یک رشته برمی گرداند:

use Illuminate\Support\Str;
 
$slice = Str::before('This is my name', 'my name');
 
// 'This is '

Str::beforeLast()

متد Str::beforeLast همه چیز را قبل از آخرین وقوع مقدار داده شده در یک رشته برمی گرداند:

use Illuminate\Support\Str;
 
$slice = Str::beforeLast('This is my name', 'is');
 
// 'This '

Str::between()

متد Str::between بخشی از یک رشته را بین دو مقدار برمی گرداند:

use Illuminate\Support\Str;
 
$slice = Str::between('This is my name', 'This', 'name');
 
// ' is my '

Str::betweenFirst()

این Str::betweenFirst متد کوچکترین بخش ممکن از یک رشته را بین دو مقدار برمی گرداند:

use Illuminate\Support\Str;
 
$slice = Str::betweenFirst('[a] bc [d]', '[', ']');
 
// 'a'

Str::camel()

متد Str::camel رشته داده شده را به camelCase :

use Illuminate\Support\Str;
 
$converted = Str::camel('foo_bar');
 
// fooBar

Str::contains()

متد Str::contains تعیین می کند که آیا رشته داده شده حاوی مقدار داده شده است یا خیر. این روش به حروف کوچک و بزرگ حساس است:

use Illuminate\Support\Str;
 
$contains = Str::contains('This is my name', 'my');
 
// true

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

use Illuminate\Support\Str;
 
$contains = Str::contains('This is my name', ['my', 'foo']);
 
// true

Str::containsAll()

متد Str::containsAll تعیین می کند که آیا رشته داده شده حاوی تمام مقادیر یک آرایه معین است یا خیر:

use Illuminate\Support\Str;
 
$containsAll = Str::containsAll('This is my name', ['my', 'name']);
 
// true

Str::endsWith()

متد Str::endsWith تعیین می کند که آیا رشته داده شده با مقدار داده شده به پایان می رسد:

use Illuminate\Support\Str;
 
$result = Str::endsWith('This is my name', 'name');
 
// true

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

use Illuminate\Support\Str;
 
$result = Str::endsWith('This is my name', ['name', 'foo']);
 
// true
 
$result = Str::endsWith('This is my name', ['this', 'foo']);
 
// false

Str::excerpt()

این Str::excerpt روش یک گزیده از یک رشته داده شده را استخراج می کند که با اولین نمونه از یک عبارت در آن رشته مطابقت دارد:

use Illuminate\Support\Str;
 
$excerpt = Str::excerpt('This is my name', 'my', [
    'radius' => 3
]);
 
// '...is my na...'

گزینه ای radius که به طور پیش فرض روی است 100 ، به شما امکان می دهد تعداد کاراکترهایی را که باید در هر طرف رشته کوتاه شده ظاهر شوند، تعیین کنید.

علاوه بر این، می‌توانید از این omission گزینه برای تعریف رشته‌ای استفاده کنید که از قبل به رشته کوتاه شده اضافه می‌شود:

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

Str::finish()

این Str::finish متد یک نمونه از مقدار داده شده را به یک رشته اضافه می کند اگر قبلاً به آن مقدار ختم نشده باشد:

use Illuminate\Support\Str;
 
$adjusted = Str::finish('this/string', '/');
 
// this/string/
 
$adjusted = Str::finish('this/string/', '/');
 
// this/string/

Str::headline()

این Str::headline روش رشته‌هایی را که با حروف، خط تیره یا زیرخط مشخص شده‌اند، به رشته‌ای با فاصله با حروف اول هر کلمه تبدیل می‌کند:

use Illuminate\Support\Str;
 
$headline = Str::headline('steve_jobs');
 
// Steve Jobs
 
$headline = Str::headline('EmailNotificationSent');
 
// Email Notification Sent

Str::inlineMarkdown()

این روش Markdown با طعم GitHub را با استفاده از CommonMark Str::inlineMarkdown به HTML درون خطی تبدیل می کند . با این حال، بر خلاف روش، تمام HTML تولید شده را در یک عنصر در سطح بلوک قرار نمی دهد: markdown

use Illuminate\Support\Str;
 
$html = Str::inlineMarkdown('**Laravel**');
 
// <strong>Laravel</strong>

Str::is()

این Str::is روش تعیین می کند که آیا یک رشته داده شده با یک الگوی داده شده مطابقت دارد یا خیر. ستاره ها ممکن است به عنوان مقادیر عام استفاده شوند:

use Illuminate\Support\Str;
 
$matches = Str::is('foo*', 'foobar');
 
// true
 
$matches = Str::is('baz*', 'foobar');
 
// false

Str::isAscii()

این Str::isAscii روش تعیین می کند که آیا یک رشته داده شده ASCII 7 بیتی است یا خیر:

use Illuminate\Support\Str;
 
$isAscii = Str::isAscii('Taylor');
 
// true
 
$isAscii = Str::isAscii('ü');
 
// false

Str::isJson()

متد Str::isJson تعیین می کند که آیا رشته داده شده JSON معتبر است یا خیر:

use Illuminate\Support\Str;
 
$result = Str::isJson('[1,2,3]');
 
// true
 
$result = Str::isJson('{"first": "John", "last": "Doe"}');
 
// true
 
$result = Str::isJson('{first: "John", last: "Doe"}');
 
// false

Str::isUlid()

متد Str::isUlid تعیین می کند که آیا رشته داده شده یک ULID معتبر است یا خیر:

use Illuminate\Support\Str;
 
$isUlid = Str::isUlid('01gd6r360bp37zj17nxb55yv40');
 
// true
 
$isUlid = Str::isUlid('laravel');
 
// false

Str::isUuid()

این Str::isUuid روش تعیین می کند که آیا رشته داده شده یک UUID معتبر است یا خیر:

use Illuminate\Support\Str;
 
$isUuid = Str::isUuid('a0a2a2d2-0b87-4a18-83f2-2529882be2de');
 
// true
 
$isUuid = Str::isUuid('laravel');
 
// false

Str::kebab()

متد Str::kebab رشته داده شده را به kebab-case :

use Illuminate\Support\Str;
 
$converted = Str::kebab('fooBar');
 
// foo-bar

Str::lcfirst()

متد Str::lcfirst رشته داده شده را با اولین کاراکتر کوچک برمی گرداند:

use Illuminate\Support\Str;
 
$string = Str::lcfirst('Foo Bar');
 
// foo Bar

Str::length()

متد Str::length طول رشته داده شده را برمی گرداند:

use Illuminate\Support\Str;
 
$length = Str::length('Laravel');
 
// 7

Str::limit()

متد Str::limit رشته داده شده را به طول مشخص شده کوتاه می کند:

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

برای تغییر رشته ای که به انتهای رشته کوتاه شده اضافه می شود، می توانید آرگومان سومی را به متد ارسال کنید:

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

Str::lower()

متد Str::lower رشته داده شده را به حروف کوچک تبدیل می کند:

use Illuminate\Support\Str;
 
$converted = Str::lower('LARAVEL');
 
// laravel

Str::markdown()

این روش Markdown با طعم GitHub را با استفاده از CommonMark Str::markdown به HTML تبدیل می کند :

use Illuminate\Support\Str;
 
$html = Str::markdown('# Laravel');
 
// <h1>Laravel</h1>
 
$html = Str::markdown('# Taylor <b>Otwell</b>', [
    'html_input' => 'strip',
]);
 
// <h1>Taylor Otwell</h1>

Str::mask()

این Str::mask روش بخشی از یک رشته را با یک کاراکتر تکراری ماسک می کند و ممکن است برای مبهم کردن بخش هایی از رشته ها مانند آدرس ایمیل و شماره تلفن استفاده شود:

use Illuminate\Support\Str;
 
$string = Str::mask('taylor@example.com', '*', 3);
 
// tay***************

در صورت نیاز، یک عدد منفی به عنوان آرگومان سوم به mask متد ارائه می‌دهید، که به متد دستور می‌دهد تا در فاصله مشخص شده از انتهای رشته، ماسک کردن را آغاز کند:

$string = Str::mask('taylor@example.com', '*', -15, 3);
 
// tay***@example.com

Str::orderedUuid()

این Str::orderedUuid روش یک UUID "مهر زمانی" تولید می کند که ممکن است به طور موثر در یک ستون پایگاه داده نمایه شده ذخیره شود. هر UUID که با استفاده از این روش تولید می‌شود، پس از UUID‌هایی که قبلاً با استفاده از روش ایجاد شده‌اند مرتب می‌شوند:

use Illuminate\Support\Str;
 
return (string) Str::orderedUuid();

Str::padBoth()

این Str::padBoth روش تابع PHP را بسته بندی می کند str_pad و هر دو طرف یک رشته را با یک رشته دیگر اضافه می کند تا اینکه رشته نهایی به طول دلخواه برسد:

use Illuminate\Support\Str;
 
$padded = Str::padBoth('James', 10, '_');
 
// '__James___'
 
$padded = Str::padBoth('James', 10);
 
// '  James   '

Str::padLeft()

این Str::padLeft روش تابع PHP را پیچیده می‌کند str_pad و سمت چپ یک رشته را با یک رشته دیگر اضافه می‌کند تا اینکه رشته نهایی به طول دلخواه برسد:

use Illuminate\Support\Str;
 
$padded = Str::padLeft('James', 10, '-=');
 
// '-=-=-James'
 
$padded = Str::padLeft('James', 10);
 
// '     James'

Str::padRight()

این Str::padRight روش تابع PHP را پیچیده می‌کند str_pad و سمت راست یک رشته را با یک رشته دیگر اضافه می‌کند تا اینکه رشته نهایی به طول دلخواه برسد:

use Illuminate\Support\Str;
 
$padded = Str::padRight('James', 10, '-');
 
// 'James-----'
 
$padded = Str::padRight('James', 10);
 
// 'James     '

Str::plural()

این Str::plural روش یک رشته کلمه مفرد را به شکل جمع آن تبدیل می کند. این تابع از هر یک از زبان های پشتیبانی شده توسط پلورالیزر لاراول پشتیبانی می کند :

use Illuminate\Support\Str;
 
$plural = Str::plural('car');
 
// cars
 
$plural = Str::plural('child');
 
// children

می توانید یک عدد صحیح به عنوان آرگومان دوم برای تابع برای بازیابی شکل مفرد یا جمع رشته ارائه دهید:

use Illuminate\Support\Str;
 
$plural = Str::plural('child', 2);
 
// children
 
$singular = Str::plural('child', 1);
 
// child

Str::pluralStudly()

این Str::pluralStudly روش یک رشته کلمه مفرد را که با حروف studly caps قالب بندی شده است به شکل جمع آن تبدیل می کند. این تابع از هر یک از زبان های پشتیبانی شده توسط پلورالیزر لاراول پشتیبانی می کند :

use Illuminate\Support\Str;
 
$plural = Str::pluralStudly('VerifiedHuman');
 
// VerifiedHumans
 
$plural = Str::pluralStudly('UserFeedback');
 
// UserFeedback

می توانید یک عدد صحیح به عنوان آرگومان دوم برای تابع برای بازیابی شکل مفرد یا جمع رشته ارائه دهید:

use Illuminate\Support\Str;
 
$plural = Str::pluralStudly('VerifiedHuman', 2);
 
// VerifiedHumans
 
$singular = Str::pluralStudly('VerifiedHuman', 1);
 
// VerifiedHuman

Str::random()

این Str::random روش یک رشته تصادفی با طول مشخص شده تولید می کند. این تابع از تابع PHP استفاده می کند random_bytes :

use Illuminate\Support\Str;
 
$random = Str::random(40);

Str::remove()

متد Str::remove مقدار داده شده یا آرایه مقادیر را از رشته حذف می کند:

use Illuminate\Support\Str;
 
$string = 'Peter Piper picked a peck of pickled peppers.';
 
$removed = Str::remove('e', $string);
 
// Ptr Pipr pickd a pck of pickld ppprs.

همچنین می‌توانید false به‌عنوان آرگومان سوم به remove متد ارسال کنید تا هنگام حذف رشته‌ها، حروف کوچک و بزرگ نادیده گرفته شود.

Str::replace()

متد Str::replace یک رشته داده شده را در رشته جایگزین می کند:

use Illuminate\Support\Str;
 
$string = 'Laravel 8.x';
 
$replaced = Str::replace('8.x', '9.x', $string);
 
// Laravel 9.x

Str::replaceArray()

این Str::replaceArray روش با استفاده از یک آرایه، مقدار داده شده را در رشته جایگزین می کند:

use Illuminate\Support\Str;
 
$string = 'The event will take place between ? and ?';
 
$replaced = Str::replaceArray('?', ['8:30', '9:00'], $string);
 
// The event will take place between 8:30 and 9:00

Str::replaceFirst()

متد Str::replaceFirst اولین وقوع یک مقدار داده شده را در یک رشته جایگزین می کند:

use Illuminate\Support\Str;
 
$replaced = Str::replaceFirst('the', 'a', 'the quick brown fox jumps over the lazy dog');
 
// a quick brown fox jumps over the lazy dog

Str::replaceLast()

متد Str::replaceLast آخرین وقوع یک مقدار داده شده را در یک رشته جایگزین می کند:

use Illuminate\Support\Str;
 
$replaced = Str::replaceLast('the', 'a', 'the quick brown fox jumps over the lazy dog');
 
// the quick brown fox jumps over a lazy dog

Str::reverse()

متد Str::reverse رشته داده شده را معکوس می کند:

use Illuminate\Support\Str;
 
$reversed = Str::reverse('Hello World');
 
// dlroW olleH

Str::singular()

این Str::singular روش یک رشته را به شکل تکی آن تبدیل می کند. این تابع از هر یک از زبان های پشتیبانی شده توسط پلورالیزر لاراول پشتیبانی می کند :

use Illuminate\Support\Str;
 
$singular = Str::singular('cars');
 
// car
 
$singular = Str::singular('children');
 
// child

Str::slug()

این Str::slug روش یک URL دوستدار "slug" از رشته داده شده ایجاد می کند:

use Illuminate\Support\Str;
 
$slug = Str::slug('Laravel 5 Framework', '-');
 
// laravel-5-framework