معالجة الصور لـ Ruby on Rails وActiveStorage
سرّع رفع الصور في Rails باستخدام الـ gem الرسمي. يعمل جنبًا إلى جنب مع متغيرات ActiveStorage ومهام Sidekiq في الخلفية.
تثبيت
حزمة RUBY
$ gem install smallpict-rubyمثال على التطبيق البرمجي
ruby
# Gemfile
gem 'smallpict-ruby'
# config/initializers/smallpict.rb
SmallPict.configure do |config|
config.api_key = ENV['SMALLPICT_API_KEY']
config.auto_format = :auto # Selects AVIF or WebP based on client
config.quality = 82
end
# In your Controller / Service:
optimized_url = SmallPict.optimize(
user.avatar.url,
width: 400,
format: :avif
)خطوات التكامل
إضافة إلى Gemfile
أضف السطر gem 'smallpict' إلى ملف Gemfile ثم شغّل bundle install.
إعداد خدمة التخزين
عرّف خدمة SmallPict في config/storage.yml باستخدام مفتاح API الخاص بك.
تحديد النسخ المشتقة
أعلن عن النسخ المحسنة في نماذجك وفق البنية المألوفة لـ ActiveStorage.
المزايا الرئيسية
- يعمل مع ActiveStorage
- جاهز للاستخدام مع معالجات المهام الخلفية مثل Sidekiq وGoodJob
- يلغي الحاجة لتثبيت وصيانة حزم ImageMagick المعقدة على الخوادم
- متوافق مع إصدارات Rails 6.x و7.x و8.x
هل تحتاج إلى إرشادات كاملة ومواصفات API؟
استكشف مراجع المعلمات وآليات المصادقة وإرشادات الاختبار المحلي في دليل مطوري جوهرة Ruby & Rails (Gem) الرسمي.
قراءة وثائق جوهرة Ruby & Rails (Gem)سرّع مسار معالجة الصور في جوهرة Ruby & Rails (Gem)
جرّب تحسين صور AVIF و WebP في تطبيقك. بدون رسوم إعداد، ومع مفاتيح تجريبية فورية.