معرفی پکیج Laravel ImageUp در لاراول

Laravel ImageUp یک پکیج مفید در لاراول است که به صورت خودکار انجام عملیات آپلود، تغییر اندازه (resize) و برش (crop) تصاویر را برای مدل‌های Eloquent  پشتیبانی می‌کند. برای استفاده از

Laravel ImageUp یک پکیج مفید در لاراول است که به صورت خودکار انجام عملیات آپلود، تغییر اندازه (resize) و برش (crop) تصاویر را برای مدل‌های Eloquent  پشتیبانی می‌کند.

برای استفاده از این پکیج، خصوصیتی به نام HasImageUploads را به مدل Eloquent خود اضافه کنید و تمام تصاویری را که باید در پایگاه داده ذخیره شوند را برای مدل تعریف کنید.

مثال موجود در فایل readme دو فیلد مربوط به تصویر را در مدل User نشان می‌دهد که با ستون‌های موجود در پایگاه داده مطابقت دارند:

<?php
namespace App;

use QCod\ImageUp\HasImageUploads;
use Illuminate\Database\Eloquent\Model;

class User extends Model {
    use HasImageUploads;

    // assuming `users` table has 'cover', 'avatar' columns
    // mark all the columns as image fields 
    protected static $imageFields = [
        'cover', 'avatar'
    ];
}

سیو کردن مدل به صورت خودکار تصاویر را آپلود و مسیرها را در پایگاه داده ذخیره می‌کند. همچنین، مسیرهای موجود را آپدیت می‌کند، حتی تصاویر قدیمی نیز پاک می‌شوند.

شما همچنین می‌توانید تنظیمات زیادی را در خصوصیت $imageFields برای مدیریت آپلود یا تغییر اندازه تصاویر اعمال کنید، مثال زیر را در نظر بگیرید:

// all the images fields for model
protected static $imageFields = [
    'avatar' => [
        // width to resize image after upload
        'width' => 200,

        // height to resize image after upload
        'height' => 100,

        // set true to crop image with the given width/height and you can also pass arr [x,y] coordinate for crop.
        'crop' => true,

        // what disk you want to upload, default config('imageup.upload_disk')
        'disk' => 'public',

        // a folder path on the above disk, default config('imageup.upload_directory')
        'path' => 'avatars',

        // placeholder image if image field is empty
        'placeholder' => '/images/avatar-placeholder.svg',

        // validation rules when uploading image
        'rules' => 'image|max:2000',

        // override global auto upload setting coming from config('imageup.auto_upload_images')
        'auto_upload' => false,

        // if request file is don't have same name, default will be the field name
        'file_input' => 'photo'
    ],
    'cover' => [
        //...    
    ]
];

همچنین، می‌توانید فیلدهای تصاویر را با متدهای ارائه شده توسط خصوصیت HasImageUploads سفارشی کنید. برای به دست آوردن اطلاعات کامل در مورد متدها و گزینه‌های پیکربندی این پکیج، می توانید فایل readme آن را مطالعه نمایید.

همچنین، می‌توانید با استفاده از متد uploadImage () تصاویر را به صورت دستی آپلود کنید (در این صورت، باید گزینه auto-upload را در مدل خود غیرفعال کنید).

$user = User::findOrFail($id);
$user->uploadImage(request()->file('cover'), 'cover');

این پکیج را می‌توانید با استفاده از composer نصب کنید:

composer require qcod/laravel-imageup

برای کسب اطلاعات بیشتر درباره نحوه نصب و استفاده کامل از این پکیج، می‌توانید آن را در GitHub بررسی کنید.

در مقاله امروز در لیداوب با یکی دیگر از پکیج‌های کاربردی فریم ورک لاراول آشنا شدیم. آیا شما از این پکیج در برنامه‌‌های خود استفاده کرده‌اید؟ می‌توانید نظرات و سوالات خودتان را در بخش کامنت‌ها با ما در میان بگذارید.