اعتبارسنجی سفارشی نام فایل در لاراول

قوانین آمادهٔ لاراول بیشتر ورودی‌ها را پوشش می‌دهند، اما گاهی شرط اختصاصی داریم؛ مثلاً نام تصویر باید با 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 به بزرگی و کوچکی حساس‌اند و حداقل یک رقم لاتین لازم است.

مرجع: مستندات رسمی؛ نسخهٔ مستندات را با نسخهٔ پروژهٔ خود تطبیق دهید.

بروزرسانی‌های خبرنامه

آدرس رایانامه‌ی خود را در زیر وارد کنید و مشترک خبرنامه‌ی ما شوید.

پاسخی بگذارید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *