
درس مصغّر · العربية
كيف تتيح للمستخدمين رفع الصور
ارفع صور الاختبار المرفقة وافتحها لاحقًا واحذفها، مع فحص حدود الحجم وملكية الحساب.
لمن هذا الدرس؟
لمن يريدون إتاحة رفع الصور للزوار. يمكنك استخدام المشروع الجاهز ومساعد برمجة دون كتابة سياسات التخزين أو كود الرفع.
قبل أن تبدأ
تحتاج إلى مشروع Supabase تجريبي منفصل وحسابَي اختبار تتحكم بهما. الملفات الصغيرة والكبيرة جدًا وغير المدعومة مرفقة. اطلب من المساعد تجهيز تخزين avatars الخاص والسياسات المرفقة في هذا المشروع القابل للحذف.
الوقت المتوقع: 25–42 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. يغطي المختبر تخزين صور مقيّدًا والملكية. فحوص العميل وإعدادات MIME ليست مسار فحص برمجيات خبيثة ومحتوى كاملًا لملفات عامة اعتباطية.
ما الذي ستتعلمه؟
- ميّز المعاينة المحلية من ملف رُفع إلى التخزين.
- اختبر الملفات المرفقة المقبولة والمرفوضة.
- افحص الحذف المقصور على المالك وحدود حساب آخر.
الخطوة 1
افهم ما تثبته المعاينة
اختيار اسم ملف، وحفظ ملف مرفوع، والقدرة على قراءة صورة ثلاث ملاحظات مختلفة.
افتح التطبيق المرفق مع المساعد واختر fixtures/avatar-small.webp. قبل الضغط على Upload image، يعرض حقل الملف الاسم المختار. لا تنشئ نسخة البداية معاينة محلية للصورة عند الاختيار؛ ولا تظهر الصورة إلا بعد نجاح الرفع والوصول الموقّع.
قد تعاين تطبيقات أخرى صورة محلية دون حفظها. وهنا أيضًا لا يثبت اختيار اسم الملف أي رفع عن بُعد. افصل فحوص الاختيار والتخزين لدى المزود وقراءة الصورة لاحقًا.
مثال عملي
يمكن أن يعرض اختيار avatar-small.webp اسم الملف قبل إعداد حساب التخزين. لإثبات التخزين عن بُعد لاحقًا، ابحث عن الكائن المرفوع لدى المزود وافحص المعاينة ذات الرابط الموقّع التي تقرؤه.
استخدم حزمة رفع الصور الكاملة ومشروع Supabase التجريبي القابل للحذف الخاص بي. ساعدني في ضبط الدخول وحاوية avatars خاصة وحد 2 MB المعلن وصيغ الصور المسموحة باستخدام السياسات المرفقة. أبقِ المفاتيح الخاصة خارج الملفات العامة. شغّل الصفحة ووجّهني لاختبار الملفات الصغيرة والكبيرة جدًا وغير المدعومة، واختبارات الحذف بجلسات حسابات منفصلة. تولَّ تعديلات الكود نيابة عني.ملفات هذه الخطوة

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
خزّن الصورة، لا معاينة محلية فقط
المعاينة المنشأة من ملف مختار ليست دليلًا على تلقي خدمة تخزين له.
يحتفظ المتصفح أولًا بالملف المختار. يرسل الرفع بايتاته إلى خدمة تخزين كائنات، فتمنحه مسارًا وتطبق قواعد وصول.
سنستخدم حاوية Supabase خاصة بمجلد مالك لكل حساب. يرفع التطبيق ملفًا ثم يطلب رابط معاينة موقّعًا قصير العمر. ولا يجعل كل رفع قابلًا للقراءة العامة.
مثال محلول
قد تعمل معاينة blob: محلية دون أي طلب شبكة. سيفحص اختبارنا الكائن الفعلي ويجلبه عبر مسار مصرح به.
Extra implementation exercise
تظهر الصورة المختارة فورًا عبر رابط blob. هل حدث الرفع بالضرورة؟
عرض حل نموذجي مشروح
لا. تحقق من عملية التخزين والكائن المطابق قبل ادعاء الرفع.
- تفصل المعاينة المحلية عن التخزين البعيد.
- تفحص نتيجة الرفع والكائن المخزن.
خطأ شائع
تسمية اختيار ملف رفعًا مكتملًا.
الخطوة 2
جهّز تخزينًا خاصًا للاختبار
استخدم الإعدادات المرفقة واستعن بالمساعد في الضبط.
في مشروعك القابل للحذف، دع المساعد يضبط حاوية avatars الخاصة وحدود الحجم والصيغ وpolicies.sql. شغّل تطبيق الدخول والرفع الكامل عبر HTTP.
تأكد أن الحاوية خاصة وأن الحساب والمشروع هما المقصودان. لا تزل حماية التخزين لإنجاح طلب فاشل.
مثال عملي
يمكن أن تساعد واجهة الزائر في رفض ملف، لكن يجب أن تفرض خدمة التخزين قواعدها أيضًا.
Supabase: التحكم في الوصول إلى التخزين
جرّب بنفسك
ما إعدادات التخزين التي طُبقت؟ وهل يستطيع حساب اختبارك فتح التطبيق الذي يعمل؟
عرض حل نموذجي مشروح
مثال سجل إعداد: «أعدّ المساعد حاوية avatars الخاصة في المشروع المؤقت، وضبط حد 2 MB والصيغ PNG وJPEG وWebP المذكورة، وطبّق سياسات مجلد المالك المرفقة. يفتح التطبيق عبر HTTP ويستطيع A تسجيل الدخول».
إذا فشل الرفع قبل اكتمال هذه الفحوص، فسجل مرحلة الإعداد الناقصة. جعل الحاوية عامة أو إزالة قواعد الملكية ليس اختصارًا مقبولًا.
- يحدد المشروع المؤقت وحاوية avatars الخاصة وحدود الصيغ والحجم المُعدّة.
- يسجل عمل تطبيق الدخول والرفع وأي عائق إعداد، دون إضعاف حماية التخزين.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
أنشئ حاوية خاصة وقواعد مالك
يفرض إعداد الحاوية وسياسات الوصول جزأين مختلفين من المهمة.
أنشئ حاوية avatars خاصة. اضبط حد حجمها 2MB وأنواع MIME المسموحة ثم طبّق policies.sql. ينبغي ألا تتمكن أدوار المتصفح من الإدراج والقراءة إلا في مسارات تحت معرّف مستخدمها المتحقق منه.
سمة accept لدى العميل وسيلة راحة، لا فحص أمان. تظل قواعد الحجم والنوع لدى المزوّد وسياسات الملكية مطبقة على الطلبات المباشرة. تسميات MIME وحدها لا تثبت سلامة محتوى ملف اعتباطي؛ لا تقدم هذا المختبر بوصفه خدمة فحص كاملة.
لكائن اسمه USER_A/avatar-1.webp، تعيد storage.foldername(name) مكونات المجلد؛ وتختار [1] الأول منها في مصفوفة PostgreSQL هذه. يجب أن يساوي معرّف المستخدم المصادَق عليه. يفشل USER_B/avatar-1.webp للحساب A. تختلف هذه القاعدة في التخزين عن منتقي الملفات وفحص MIME المسبق في المتصفح.
يبقى مقطع المسار الأول معرّف المستخدم حتى مع مجلدات متداخلة: يظل USER_A مكون المجلد [1] في USER_A/subfolder/avatar.webp. لن يتطابق مسار يبدأ بـsubfolder/USER_A/.... أبقِ معرّف المالك أولًا؛ ولا ترخِ السياسة لمجرد استيعاب مسار خاطئ.
مثال محلول
تأتي بادئة المجلد من المستخدم المسجّل، بينما تقارنها سياسة قاعدة البيانات بـauth.uid(). يجب ألا يمنح تغيير مسار متصفح إلى مجلد مستخدم آخر إذنًا.
create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
Supabase: التحكم في الوصول إلى التخزين
Extra implementation exercise
لماذا لا يكفي فحص امتداد الملف في JavaScript فقط؟
عرض حل نموذجي مشروح
يستطيع مقدم الطلب إرسال طلب مباشر ببيانات وصفية مختلفة أو مسار مختلف. افرض الحاوية المقصودة وقواعد المالك عند حد الخدمة.
- تدرك أن مقدم الطلب يستطيع تجاوز JavaScript.
- تشترط قيودًا وتفويضًا على جانب التخزين.
خطأ شائع
جعل الحاوية كاملة عامة لإصلاح معاينة فاشلة.
الخطوة 3
ارفع صورة الاختبار الصغيرة
افحص العنصر المخزّن إلى جانب الصورة الظاهرة.
سجّل الدخول بالحساب A وارفع الصورة الصغيرة المرفقة. اعثر على عنصرها لدى المزود، واستخدم المعاينة الناتجة أو مسار الوصول عبر الرابط الموقّع.
إن نجح التخزين وفشلت المعاينة، فافحص القراءة والمعاينة قبل رفع نسخة أخرى. احتفظ بمرجع العنصر المسجّل.
مثال عملي
غياب المعاينة لا يعني بالضرورة فشل الرفع نفسه.
جرّب بنفسك
هل خُزّنت الصورة الصغيرة؟ وهل أمكن قراءتها بعد ذلك؟
عرض حل نموذجي مشروح
مثال سجل رفع: «رفع A ملف avatar-small.webp. أظهر المزود كائنًا داخل مجلد A، فاحتفظت بمرجعه مع إخفاء البيانات الحساسة. ثم ظهرت الصورة عبر المعاينة ذات الرابط الموقّع قصير الصلاحية».
يمكن وصف نتيجة جزئية هكذا: «الكائن موجود، لكن الوصول عبر المعاينة فشل». يستدعي ذلك فحص قراءة الكائن نفسه وصلاحياته، لا رفع نسخ متكررة دون معرفة هل نجح الحفظ.
- يربط رفع A الناجح بمرجع الكائن المحفوظ فعليًا.
- يسجل بصورة مستقلة هل استطاعت المعاينة الموقّعة قراءة هذا الكائن.
ملفات هذه الخطوة
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
ارفع إلى مسار مالك فريد
استخدم اسمًا مولّدًا بدل الثقة بمسار مقدم الطلب أو استبدال ملف قائم.
بعد الدخول، يختار التطبيق مسارًا باستخدام معرّف المستخدم المتحقق منه واسم ملف عشوائي. يفحص حجم الصورة المختارة ونوعها قبل طلب الرفع، لكن تلك الفحوص لا تستبدل فرض المزوّد.
لا يفعّل الرفع upsert. إذا نجح التخزين وفشل إنشاء رابط موقّع، تبلغ الواجهة عنهما كملاحظتين منفصلتين. لا تقول أبدًا «لم يُرفع شيء» حين قد يكون الكائن موجودًا.
مثال محلول
يتجنب اسم ملف مولّد التصادم بالخطأ مع صورة أخرى اسمها photo.jpg. وليس آلية تفويض بمفرده.
Extra implementation exercise
الكائن موجود، لكن إنشاء المعاينة فشل. هل ينبغي رفع نسخة أخرى فورًا؟
عرض حل نموذجي مشروح
افحص مسار الكائن وسياسة القراءة أولًا. قد ينشئ تكرار الرفع نسخًا مكررة دون إصلاح مشكلة المعاينة.
- تفصل نجاح الرفع عن تفويض المعاينة.
- تفحص سياسة القراءة والمسار قبل إنشاء نسخ مكررة.
خطأ شائع
اعتبار أسماء ملفات عشوائية بديلًا عن التحكم في الوصول.
الخطوة 4
جرّب حالات الفشل المرفقة
يتضمن التمرين ملفات ينبغي ألا تُرفع.
استخدم fixtures/avatar-too-large.png وfixtures/not-an-image.txt. سجّل استجابة الصفحة والتخزين. اطلب من المساعد فحص رفض غير مفهوم أو ملف غير صالح مرّ رغم القيود.
يجب ألا تتحول الملفات المرفوضة إلى عناصر مخزنة. قد يسمح رابط موقّع صالح لحامله بعرض الصورة طوال صلاحيته؛ وهذا وحده لا يثبت أن الحاوية أصبحت عامة.
مثال عملي
قيود نافذة اختيار الملف وفرض القيود الفعلي في التخزين اختباران مختلفان.
جرّب بنفسك
ماذا حدث للملفين الكبير جدًا وغير المدعوم؟ وما مسار الوصول الذي اختبرته فعلًا؟
عرض حل نموذجي مشروح
مثال سجل رفض: «رُفض ملف PNG الزائد الحجم ولم يظهر كائن جديد. ورُفض الملف النصي أيضًا؛ وساعدني المساعد في اختباره إن أخفى منتقي الملفات الصيغ غير المدعومة».
«فُتح رابط الصورة المسموحة الموقّع خلال مدة صلاحيته القصيرة. أثبت ذلك الوصول عبر ذلك الرابط، لا أن الحاوية الخاصة أصبحت عامة». ترشيح منتقي الملفات وحده لا يختبر قيود التخزين لدى المزود مباشرةً.
- يسجل الرفض وحالة التخزين بصورة منفصلة لكل من الملفين غير الصالحين المرفقين.
- يميز القراءة عبر رابط موقّع مؤقت عن الوصول غير المقيد إلى حاوية عامة.
ملفات هذه الخطوة

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
تحقق من الرفض والوصول المؤقت
اختبر قواعد الخدمة وافهم ما يمنحه رابط موقّع.
ارفع fixtures/avatar-small.webp بالحساب A. افحص مسار التخزين وافتح المعاينة الموقعة المسموح بها. جرّب بعد ذلك fixtures/avatar-too-large.png الذي يتجاوز 2MiB وfixtures/not-an-image.txt ذي النوع غير المدعوم؛ يجب رفضهما. الملفات الثلاثة مرفقة.
استخدم الحساب B لطلب رابط موقّع لمسار A؛ ينبغي أن ترفض سياسة المالك ذلك. يظل بإمكان أي شخص يحصل على رابط موقّع صدر لـA بصورة مشروعة استخدامه حتى انتهاء صلاحيته. تسجيل خروج العميل لا يلغي كل رابط صدر فورًا.
مثال محلول
يسجل تقرير مفيد مسارًا محجوب البيانات الحساسة ومدة صلاحية، لا رابط الوصول المؤقت كاملًا.
Extra implementation exercise
يفتح شخص يحمل رابطًا موقعًا صالحًا الصورة دون تسجيل دخول. هل يثبت ذلك وحده فشل سياسة الحاوية الخاصة؟
عرض حل نموذجي مشروح
لا. اختبر ما إذا كان حساب غير مصرح له يستطيع إنشاء الرابط أو القراءة دون صلاحية مصرح بها. تعامل مع الروابط الصادرة كبيانات حساسة حتى انتهاء صلاحيتها.
- تدرك أن الروابط الموقعة صلاحيات حامل مؤقتة.
- تميّز الوصول بالرابط عن الإذن بإنشائه.
خطأ شائع
نشر رابط موقّع في تقرير خطأ وتوقع بقائه خاصًا.
الخطوة 5
أضف الحذف المقصور على المالك
تحقق ممن يستطيع إزالة العنصر المرفوع.
اطلب من المساعد إضافة سلوك حذف المالك المرفق. احذف كائن اختبار أولًا X بصفتك A، وتحقق من غيابه في التخزين. ثم ارفع كائنًا جديدًا Y بصفتك A؛ واحتفظ بمرجعه مع إخفاء بياناته الحساسة للفحص التالي.
في جلسة B المنفصلة، اطلب من المساعد استهداف Y بمحاولة حذف مباشر. سجل الفاعل B والهدف Y ونتيجة المزود، ثم تحقق من أن Y المملوك لـA ما زال موجودًا. فحص زر حذف مخفي فقط، أو محاولة حذف X غير الموجود مجددًا، لا يثبت حد الملكية هذا.
مثال عملي
إزالة صورة من الشاشة لا تعادل حذف العنصر المخزّن.
جرّب بنفسك
مواد البداية
ملفات البداية ومحتوى الاختبار مرفقة. التحقق الفعلي يتطلب حسابك أو بريدك أو نطاقك وفق المتطلبات السابقة. الفحص المحلي ممكن؛ سجّل الخطوات الحية التي لم تنفّذها على أنها غير مختبرة.
قدّم نتيجة حذف المالك ومحاولة الحساب الثاني، مع النتائج الفعلية للعناصر المخزنة.
ما المطلوب إنجازه نتيجة الرفع والحذف، والاختبارات الفعلية للملف الصالح والكبير جدًا وغير المدعوم والمحاولة بين الحسابات.
عرض حل نموذجي مشروح
مثال سجل حذف: «حذف A الكائن X وأكد المزود غيابه. ثم رفع A كائنًا جديدًا Y. حاولت جلسة B المنفصلة حذف Y؛ وتحقق A من أن Y ما زال موجودًا».
ينبغي أن يحدد المساعد الفاعل B والهدف Y قبل تشغيل الاختبار المعزول. محاولة حذف X مجددًا تختبر كائنًا مفقودًا أصلًا، لا حماية الملكية.
- يحذف كائن A الأول بصفته المالك ويتحقق من غياب ذلك الكائن نفسه.
- يرفع كائنًا جديدًا مملوكًا لـA، ويستهدفه من B، ويتحقق من بقائه محفوظًا.
ملفات هذه الخطوة

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- policies.sqlتنزيل هذا الملف
- public/app.jsتنزيل هذا الملف
- upload-tests.txtتنزيل هذا الملف
- worksheet.htmlتنزيل هذا الملف
- reference/assignment-walkthrough.txtتنزيل هذا الملف
- reference/START-HERE.txtتنزيل هذا الملف
- reference/public/index.htmlتنزيل هذا الملف
- reference/public/app.jsتنزيل هذا الملف
- reference/delete-policy.sqlتنزيل هذا الملف
- fixtures/avatar-small.webpتنزيل هذا الملف
- fixtures/avatar-too-large.pngتنزيل هذا الملف
- fixtures/not-an-image.txtتنزيل هذا الملف
How it works (optional)
مهمتك: أضف حذفًا خاصًا بالمالك
تحتاج عملية جديدة إلى سياستها واختباراتها السلبية الخاصة.
أضف عنصر حذف للكائن المرفوع وسياسة DELETE مقيدة بمجلد مالكه. لا توسّع الحاوية القائمة إلى مساحة مشتركة عامة.
تحقق من قدرة A على إزالة كائنه وعدم قدرة B على ذلك. أبقِ حالة التخزين متسقة مع الواجهة بعد حذف فاشل.
مثال محلول
تسمح السياسات الأصلية عمدًا بالإدراج والقراءة فقط. لا يفوّض إذن الرفع الحذف تلقائيًا.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
Extra implementation exercise
نفّذ حذفًا خاصًا بالمالك وأظهر المحاولات المسموحة والممنوعة.
عرض حل نموذجي مشروح
استخدم حاوية avatars خاصة بإعدادات حجم ونوع في التخزين وسياسات مجلد المالك. ارفع صورة مسموحة بالحساب A؛ وافحص نتيجة التخزين المعادة ثم افتح المعاينة الموقعة القصيرة العمر. معاينة blob وحدها لا تثبت رفعًا بعيدًا.
جرّب ملفًا غير مدعوم أو أكبر من المسموح وحاول رفعًا أو قراءة تحت مجلد الحساب B. يجب ألا يحصل A على وصول بمجرد تغيير مسار في أدوات المطوّر. تمنح الروابط الموقعة عمدًا وصولًا مؤقتًا حتى انتهاء صلاحيتها.
للحذف، أضف سياسة DELETE بشرط الحاوية ومجلد المالك نفسه، واستدعِ remove بالمسار المخزن الدقيق. تحقق من غياب الكائن بعدها ومن بقاء كائن المالك الآخر سليمًا عند محاولة حذف عبر الحسابات. وحدة الحذف المرجعية منفصلة لتفحص المسار والسياسة قبل دمجها.
- يفحص إذن الحذف الحاوية ومجلد المالك المتحقق منه.
- لا تزيل المحاولات الفاشلة كائن حساب آخر أو تمحو الواجهة كذبًا.
خطأ شائع
منح DELETE لكل مستخدم مصادَق عليه لمجرد تشغيل زر.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.
واصل التعلّم
- كيف تنشئ أول موقع شخصي لك
- كيف تنشر موقعك من GitHub
- كيف تربط نطاقًا مخصصًا بموقعك
- كيف تعدّ البريد على نطاقك الخاص
- كيف تجعل موقعك قابلًا للاستخدام على الهواتف
- كيف تجعل صور موقعك تُحمّل أسرع
- كيف تصلك ملاحظات الموقع إلى صندوق بريدك
- كيف تضيف اشتراكات البريد إلى موقعك
- كيف ترسل رسائل بريد آلية من موقعك
- كيف تحفظ إرساليات النماذج في قاعدة بيانات
- كيف تتيح للناس تسجيل الدخول إلى موقعك
- كيف تُبقي صفحة خاصة
- كيف تتيح للمستخدمين تعديل معلومات ملفاتهم الشخصية
- كيف تُبقي مفاتيح API خارج الواجهة الأمامية
- كيف تعرض بيانات من واجهة API خارجية على موقعك
- كيف تضيف روبوت محادثة بالذكاء الاصطناعي إلى موقعك
- كيف تجعل روبوت محادثة يجيب من محتواك الخاص
- كيف تضيف مدونة إلى موقعك
- كيف تضيف بحثًا إلى موقعك
- كيف تضيف لغة أخرى إلى موقعك
- كيف تساعد Google على العثور على موقعك
- كيف تصلح معاينة موقعك عند مشاركة رابط
- كيف تقيس الزيارات والإجراءات المفيدة على موقعك
- كيف تتيح للزوار حجز موعد
- كيف تقبل دفعة مالية على موقعك
- كيف تعاين تغييرات موقعك قبل النشر
- كيف تتراجع عن نشر موقع معطّل
- كيف تنسخ بيانات موقعك احتياطيًا وتستعيدها
- كيف تجد الأخطاء في موقعك المنشور وتصلحها