كيفية تقديم ملف HTML محدد في مسار جذر FastAPI أثناء استخدام الملفات الثابتة

عند استخدام FastAPI مع StaticFiles لخدمة الملفات الثابتة، فإنك قد تواجه سيناريوهات حيث تريد تحميل ملف HTML مختلف (على سبيل المثال، custom.html) في المسار الجذر بدلاً من ملف Index.html الافتراضي. يمكن تحقيق ذلك من خلال فهم جوانب معينة من توجيه FastAPI ووظيفة StaticFiles.

فهم StaticFiles

وفقًا لوثائق Starlette، StaticFiles عبارة عن برنامج وسيط يتعامل مع خدمة الملفات الثابتة من دليل محدد. عندما يتم تعيين html=True، فإنه يبحث تلقائيًا عن ملفات Index.html في الدلائل ويقدمها وفقًا لذلك.

ترتيب التركيب

ترتيب تركيب الملفات الثابتة وتحديد ملفك تلعب نقاط النهاية دورًا حاسمًا. إذا تم تثبيت StaticFiles على المسار الجذر (أي /) وتم تعريفها قبل أي نقاط نهاية، فستكون لها الأسبقية وتتعامل مع جميع الطلبات، حتى إذا تم تعريف نقاط النهاية المخصصة لاحقًا.

تخصيص مسار الجذر

لخدمة ملف HTML محدد في المسار الجذر، يجب عليك اتباع الخطوات التالية:

1. تحميل الملفات الثابتة إلى مسار منفصل (على سبيل المثال، /static) :

   app.mount('/static', StaticFiles(directory='static'))

2. إنشاء نقطة نهاية مخصصة تُرجع ملف HTML المطلوب:

   @app.get('/')
   async def index():
       return FileResponse('custom.html')

3. قم بتثبيت StaticFiles بعد تحديد نقطة النهاية المخصصة لضمان أسبقية نقطة النهاية.

اعتبارات إضافية

• تأكد من وجود custom.html في الدليل الصحيح المحدد في مسار تحميل StaticFiles.
• فهم أنه إذا تعامل StaticFiles مع طلب ولم يعثر على ملف بالمسار المطلوب، فسوف قم بإرجاع استجابة 404 لم يتم العثور عليها.
• يوفر استخدام القوالب بدلاً من FileResponse المزيد من المرونة لتحديث ملفات HTML ديناميكيًا.