ضغط الصور لتطبيقات Laravel
اضغط وحوّل الصور المرفوعة مباشرة في إطار عمل Laravel عبر مراقبي نماذج Eloquent أو وظائف قوائم الانتظار في الخلفية.
تثبيت
حزمة PHP
$ composer require smallpict/smallpict-laravelمثال على التطبيق البرمجي
php
// In your Controller
use SmallPict\Laravel\Facades\SmallPict;
public function upload(Request $request)
{
$image = $request->file('banner');
// Automatically compresses and stores to your S3 or Cloudflare R2
$optimized = SmallPict::optimize($image)
->toFormat('webp')
->resize(1400)
->store('banners', 's3');
return response()->json(['url' => $optimized->url()]);
}
// In your Blade View
<picture>
<source srcset="@smallpict($banner->url, ['format' => 'avif'])" type="image/avif">
<source srcset="@smallpict($banner->url, ['format' => 'webp'])" type="image/webp">
<img src="@smallpict($banner->url, ['width' => 800])" alt="Banner" loading="lazy" />
</picture>خطوات التكامل
التثبيت عبر Composer
نفّذ الأمر composer require smallpict/laravel-smallpict في موجه الأوامر.
نشر ملف الإعدادات
انشر ملف التهيئة وأضف SMALLPICT_API_KEY إلى ملف .env الخاص بك.
تطبيق السمة (Trait)
أضف HasOptimizedImages إلى نماذج Eloquent للتحويل التلقائي عند الحفظ.
المزايا الرئيسية
- تكامل تام ومباشر مع أقراص التخزين في Flysystem وقوائم انتظار Laravel
- يعمل مع Spatie Media Library
- أمر Artisan جاهز لتحسين كافة ملفات مكتبة الوسائط الحالية
- دعم شامل ومتكامل لإصدارات Laravel 9 و10 و11
هل تحتاج إلى إرشادات كاملة ومواصفات API؟
استكشف مراجع المعلمات وآليات المصادقة وإرشادات الاختبار المحلي في دليل مطوري حزمة Laravel الرسمي.
قراءة وثائق حزمة Laravelسرّع مسار معالجة الصور في حزمة Laravel
جرّب تحسين صور AVIF و WebP في تطبيقك. بدون رسوم إعداد، ومع مفاتيح تجريبية فورية.