Faragiri
العربية

كل اللغات

تعلم بايثون على الويب بايثون

خمس عشرة سطرا بلا أي تبعية تجيب طلبا حقيقيا لمتجر أدوات في عمّان، والأربعة أشياء التي يضيفها الإطار فوقها.

4الأقسام
3دقائق القراءة
4العمق

جرّدي تطبيق ويب بلغة بايثون حتى النهاية وستجدينه دالة تأخذ قاموسا وتعيد بايتات. هذه الدالة، بلا استيراد واحد خارج المكتبة القياسية، تجيب على طلبين لمتجر أدوات في عمّان يبيع مسامير وأدوات كهربائية بالجملة.

GET /stock?code=AMM-14 يعطي 200 OK، وترويسة {'Content-Type': 'application/json'}، وجسما هو {"code": "AMM-14", "inStock": 7}. وGET /nope يعطي 404 Not Found ونص «لا مسار كهذا».

الدالة تستقبل environ، وهو قاموس فيه PATH_INFO وQUERY_STRING بين نحو ثلاثين مفتاحا آخر، وتستدعي start_response(status, headers) قبل أن تعيد قابلا للتكرار من البايتات. هذا العقد اسمه WSGI، ولم يتغير منذ 2003، وكل إطار بايثون متزامن استخدمته يستدعي في النهاية شيئا بهذا الشكل.

الأربعة أشياء التي يضيفها الإطار فعلا

التوجيه، فيصل /stock/AMM-14 إلى دالة تستقبل AMM-14 وسيطة بدل نص تقطعينه يدويا. والتحليل، فجسم نموذج أو جسم JSON يصل قاموسا ونوع المحتوى مفحوص أصلا. والتنسيق، فالرد يُبنى لا يُلصق، وهناك يعيش تهريب النصوص الذي يمنع ثغرة حقن سكربت. ومسار الخطأ، فاستثناء يتحول إلى 500 مع تتبع في السجل بدل اتصال يُغلق بلا تفسير.

خمس عشرة سطرا، طلب GET واحد

ما يحدث بين مسار الطلب وبايتات الاستجابة

كل محطة هنا سطر في عقد WSGI، والإطار يضيف التوجيه والتحليل والتنسيق ومسار معالجة الأخطاء.

  1. المدخلاتالخادم يبني environPATH_INFO وQUERY_STRING ونحو ثلاثين مفتاحا آخر
  2. المعالجةاستدعاء دالة التطبيقوسيطة واحدة تدخل مع نداء رجوع للإجابة
  3. الإطارمطابقة المسار والتوجيهتوجيه المسار مثل AMM-14 وسيطة إلى الدالة بدل التقطيع اليدوي
  4. الإطارتحليل الاستعلام ونوع المحتوىتحويل جسم JSON أو النموذج إلى قاموس مفحوص
  5. الإطارتنسيق الرد وتوليد الترويساتبناء الرد بأمان لمنع ثغرات الحقن وتحديد رمز الحالة
  6. المخرجاتمعالجة الأخطاء وإعادة البايتاتتحويل الاستثناءات إلى رمز 500 وإعادة البايتات ككائن قابل للتكرار

لا شيء في هذا المسار الأساسي يلمس قاعدة بيانات أو جلسة، واختيار الإطار هو قرار متعلق بالطبقات الإضافية فوق هذا العقد.

كل ما عدا ذلك اختياري ومعظمه الشيء الخامس: طبقة ربط بقاعدة بيانات، ولوحة إدارة، ونظام هجرات، ومستخدمون وجلسات. هذا هو الفارق الحقيقي، لأنه ما يقرر أي إطار، لا مجرد ذوق في صياغة الكود.

الاختيار، على المحور الوحيد المهم

Django يجلب طبقة قاعدة البيانات ولوحة الإدارة ونظام الدخول كقرار واحد، فمشروع يحتاج مستخدمين وجدولا سيتغير وشاشة لموظف متجر عمّان يعدّل المخزون منها يبدأ متقدما بأسابيع. Flask وFastAPI يجلبان الأربعة الأولى ويتركان الخامس لك، وهذا صحيح حين تكون البيانات في مكان آخر أصلا أو حين الخدمة تجيب برامج أخرى لا أشخاصا.

معايير اختيار الإطار

تحديد إطار الويب المناسب للمشروع

الفارق الحقيقي بين الأطر يكمن في المكونات الملحقة كقواعد البيانات ولوحات الإدارة لا في مجرد ذوق الصياغة.

ما طبيعة المشروع ونموذج إدارة البيانات المطلوب؟
  • مشروع متكامل يتطلب قاعدة بيانات مدمجة ولوحة إدارة ونظام مستخدمين
    اختيار إطار Djangoيوفر طبقة قاعدة البيانات ونظام الهجرات وإدارة الجلسات في حزمة متكاملة تبدأ بإنتاجية عالية
  • خدمة تركز على واجهات برمجية أو ترتبط بمصادر بيانات مستقلة
    اختيار FastAPI أو Flaskيوفر FastAPI التحقق التلقائي والتوثيق من توقيع الدوال، بينما يمنح Flask بنية خفيفة وقابلة للتخصيص

الخدمات التي تخاطب برامج أخرى تستفيد من خفة FastAPI وتوثيقه الذاتي، بينما التطبيقات الإدارية المتكاملة تبدأ متقدمة مع Django.

إضافة FastAPI الخاصة أن توقيع الدالة هو المواصفة: أضيفي أنواعا للوسائط فيتحقق من الطلب ويولّد توثيق الواجهة من السطور نفسها. هذا عمل جديد فعلا لا تهجئة مختلفة، ولهذا الاختيار بينه وبين Flask ليس عشوائيا.

ASGI وuvicorn، هذا العام

ASGI هي الواجهة التي يُبنى عليها الآن، مجانية ومعيارية، وحلت محل WSGI في كل ما يبقي اتصالا مفتوحا: عقد WSGI طلب واحد يدخل ورد واحد يخرج ولا مكان فيه لمقبس ويب أو انتظار طويل. الخمس عشرة سطرا أعلاه بصيغة WSGI لأنها الأصغر للقراءة، ونسخة ASGI الشكل نفسه مع async وقناة استقبال.

تطور معايير خوادم الويب

الانتقال من WSGI إلى معيار ASGI الحديث

حل معيار ASGI محل WSGI لتوفير دعم أصيل للاتصالات المستمرة والمقابس غير المتزامنة عبر خوادم uvicorn.

عقد WSGI المتزامن التقليديطلب واحد يدخل ورد واحد يخرج بلا مكان للمقابس المفتوحة
  1. 01قناة الاستقبال والإرسال غير المتزامنةمعالجة المقابس المفتوحة والانتظار الطويل بكفاءة دون حجز خيوط المعالجة
  2. 02فصل خادم التشغيل عن كود الإطارتشغيل uvicorn المتخصص كخادم إنتاج مستقل بدل خادم التطوير الداخلي
  3. 03توحيد بيئة التشغيل للأطر الحديثةتشغيل Django وFastAPI على أرضية قياسية موحدة تدعم التوسع الحديث
معيار ASGI غير المتزامن في 2026دعم async والاتصالات المفتوحة والمقابس عبر خوادم uvicorn

فهم استقلالية خادم uvicorn عن إطار العمل نفسه يوضح مصدر رسائل السجلات ويمنع أخطاء النشر في بيئة الإنتاج.

uvicorn هو ما يشغّلها، مجاني ومفتوح المصدر، وهو الجواب المعتاد لكل من Django وFastAPI وكل ما هو ASGI في 2026. حل محل تشغيل خادم التطوير الخاص بالإطار في الإنتاج، وهو ما ينصح كل إطار بعدم فعله في الصفحة التي تُتجاوز عادة. الشيء المهم فهمه لا حفظه أن الخادم والإطار برنامجان منفصلان، ولهذا التتبع في السجل يخص أحدهما أحيانا والآخر أحيانا.

أين يتعثر اختيار الإطار

التعثر أن يُتعلم الإطار كمجموعة زخارف فيصير سحرا مبهما وكل متطلب غير معتاد بحثا عن تعويذة. لا شيء أعلاه سحر: الطلب قاموس، والرد حالة وترويسات وبايتات، والمسار بحث من طريق إلى دالة. من يحمل هذا النموذج يقرأ مصدر الإطار حين ينتهي التوثيق، وهذا ما يحتاجه المتطلب غير المعتاد دائما.

حقيقة آليات أطر الويب

المظهر السحري للإطار مقابل بساطة الأساس

فهم أن الطلب قاموس والرد بايتات يزيل وهم السحر عن الإطار، ويمكنك من قراءة كوده المصدري بثقة.

  • زخارف الإطار وديكوراتهالتعامل مع الإطار كأنه سحر مبهم وقواعد حفظ غير مفسرة
  • البحث عن حلول سحريةالارتباك والتعثر عند مواجهة أي متطلب غير اعتيادي خارج الشروحات
مستوى الإدراك السطحي للإطار
  • الطلب كقاموس بيانات صريحاستقبال مسار الطلب والمعاملات داخل قاموس بسيط لا تعقيد فيه
  • الرد كحالة وترويسات وبايتاتإرجاع رمز الحالة وقائمة الترويسات وكائن بايتات قابل للتكرار
  • جدول التوجيه المباشرمطابقة صريحة من مسار URL إلى دالة تنفيذية دون خفاء

كتابة دالة الويب الأساسية يدويا في عشرين دقيقة تكشف أن كل زخارف الأطر مجرد طبقات تنظيمية فوق عقد بسيط.

التمرين الذي يستحق مرة واحدة: اكتبي الخمس عشرة سطرا، أضيفي توجيها فوقها، وتوقفي. عشرون دقيقة، وكل زخرفة بعدها معروفة كشيء بنيته أصلا. البيانات التي يخزّنها متجر عمّان خلف هذه الدالة مشروحة في البيانات داخل الكود، وما يحدث قبل أن يصل الطلب إلى دالتك مشروح في كيف يجيب الخادم. وتشغيل هذه الدالة على جدول بدل خادم دائم مشروح في السكربتات والأتمتة.

بجانب هذه العقدة

فوق هذه العقدة