در این آموزش سرویس عکس را روی یک قانون مسیر روشن می‌کنیم و با پارامتر x-img اولین تصویر را تغییر اندازه و فرمت می‌دهیم.

اگر دامنه هنوز پشت CDN نیست، ابتدا یکی از آموزش‌های اولین دامنه را پشت CDN ببرید یا اولین دامنه را بدون انتقال DNS پشت CDN ببرید را دنبال می‌کنیم.


پیش‌نیازها

  • دامنه یا زیردامنه پشت CDN ستون — آموزش‌ها
  • دست‌کم یک تصویر با عرض بیش از ۱۰۰ پیکسل که از لبه باز می‌شود (مثلا https://example.com/images/bird.jpg)

مراحل

  1. URL تصویر را بدون x-img در مرورگر باز می‌کنیم و همان فایل اصلی را می‌بینیم.

  2. در قوانین مسیر، قانونی که مسیر تصویر مورد نظر با آن مطابقت دارد را باز می‌کنیم.

  3. در تنظیمات، ویرایش تصویر را فعال می‌کنیم. گزینه فیلتر با QueryString را انتخاب می‌کنیم تا تنظیمات براساس پارامترهای URL اعمال شود. ویرایش تصویر

  4. اگر کش روی همین قانون روشن است، در تنظیمات کش گزینه در نظر گرفتن Query String را فعال می‌کنیم و قانون را ذخیره می‌کنیم.

  5. همان URL را با فیلتر تغییر اندازه و تبدیل به WebP باز می‌کنیم:

    https://example.com/images/bird.jpg?x-img=v1/resize,w_100/format,type_webp
    

مرجع تنظیمات

توضیحات کامل فیلترها را در مرجع سرویس عکس (Pixel) مطالعه می‌کنیم.

کش

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


بررسی صحت

  • همان URL بدون x-img هنوز تصویر اصلی را نشان می‌دهد.
  • URL با x-img=v1/resize,w_100/format,type_webp تصویر باریک‌تری می‌دهد (عرض حدود ۱۰۰ پیکسل) و فرمت WebP است.

با curl هدر پاسخ را هم می‌بینیم:

  • پاسخ تصویر:

    curl -sI "https://example.com/images/bird.jpg?x-img=v1/resize,w_100/format,type_webp"

    در خروجی باید content-type برابر image/webp باشد و وضعیت 200.

اگر هنوز تصویر اصلی برمی‌گردد، مطابقت URL با قانون مسیر، فعال بودن سرویس عکس و معتبر بودن فایل ورودی را بررسی می‌کنیم. پس از ذخیره تنظیمات، انتشار آن‌ها روی لبه‌ها را نیز در نظر می‌گیریم و دوباره همان URL را باز می‌کنیم.


ادامه مسیر