قوانین آمادهٔ لاراول بیشتر ورودیها را پوشش میدهند، اما گاهی شرط اختصاصی داریم؛ مثلاً نام تصویر باید با File شروع شود و با عدد ادامه پیدا کند: File1.png یا File342.jpg. اینجا اعتبارسنجی نام فایل را جدا از نوع و حجم آن پیادهسازی میکنیم.
📩 با عضویت در خبرنامه، جدیدترین مطالب و آموزشها را مستقیم در ایمیل خود دریافت کنید.
ساخت قانون سفارشی
php artisan make:rule FileName
نمونهٔ زیر از قرارداد ValidationRule در لاراول ۱۲ استفاده میکند. در پروژههای قدیمیتر ساختار Rule ممکن است متدهای passes و message داشته باشد؛ قراردادها را با هم ترکیب نکنید.
<?php
namespace App\Rules;
use Closure;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Http\UploadedFile;
class FileName implements ValidationRule
{
public function validate(string $attribute, mixed $value, Closure $fail): void
{
if (! $value instanceof UploadedFile) {
$fail('validation.file_name')->translate();
return;
}
$name = pathinfo($value->getClientOriginalName(), PATHINFO_FILENAME);
if (preg_match('/\AFile[0-9]+\z/', $name) !== 1) {
$fail('validation.file_name')->translate();
}
}
}
متن خطای فارسی و انگلیسی
در فایلهای ترجمهٔ validation کلید اختصاصی اضافه کنید. اگر فایلهای زبان در پروژه موجود نیستند، ابتدا از دستور php artisan lang:publish استفاده کنید:
// lang/en/validation.php
'file_name' => 'The file name is incorrect.',
// lang/fa/validation.php
'file_name' => 'نام فایل صحیح نیست.',
این خطوط عضو آرایهٔ ترجمهاند و بهتنهایی فایل کامل PHP نیستند. زبان فعال برنامه تعیین میکند کدام پیام نمایش داده شود.
استفاده در کنترلر
$request->validate([
'img' => [
'bail',
'required',
'image',
'mimes:jpg,jpeg,png',
'max:2048',
new \App\Rules\FileName,
],
]);
قانون image و mimes محتوای تصویر را بررسی میکنند؛ FileName فقط الگوی نام ارسالی را میسنجد. نام اصلی از سمت کاربر میآید و نباید برای ذخیرهسازی مستقیم یا تصمیم امنیتی به آن اعتماد کنید. برای ذخیرهٔ فایل از نام تولیدشدهٔ سمت سرور استفاده کنید. در این مثال حروف File به بزرگی و کوچکی حساساند و حداقل یک رقم لاتین لازم است.
مرجع: مستندات رسمی؛ نسخهٔ مستندات را با نسخهٔ پروژهٔ خود تطبیق دهید.

