العودة إلى كل المقالات
برمجة وتطوير آخر تحديث: 2 نوفمبر 2026

سلّم مشروع الصور كأرشيف ZIP: أسماء عربية ومحتوى يمكن فحصه

صندوق أرشيف مفتوح بثلاثة أظرف تحمل صورة زجاجة وصورة صينية خشبية وورقة مشروع فارغة
صندوق أرشيف مفتوح بثلاثة أظرف تحمل صورة زجاجة وصورة صينية خشبية وورقة مشروع فارغة.

يحتوي الأرشيف الفعلي في هذا المشروع على عضوين: مشروع/prompt.txt وفيه العبارة العربية كوب خزفي، وproject/manifest.json وفيه بيانات الإصدار الأول. هذان ملفا نص وJSON، وليس بينهما صورة أو مخرج من مزود توليد. نستعملهما لفحص مشكلة تسليم صغيرة ومحددة: كيف نحافظ على اسم عربي ومحتواه داخل حزمة واحدة، وكيف نميز تكرار المسار عن تكرار الاسم الأخير؟ بعد تنفيذ الاختبارات، فُحص ملف ZIP المحفوظ نفسه، فكان حجمه 286 بايتاً. هذه قيمة لهذا الملف الصغير وحده؛ لا تقيس كفاءة ضغط الصور ولا سرعة توزيع مشروع كبير. يربط الشرح التالي بين المدخلين والكود والتأكيدات التي شُغلت فعلاً، ثم يوضح أين تبدأ قرارات التكامل التي تحتاج عملاً إضافياً.

افتح الحزمة المنطقية قبل اختيار الضغط

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

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

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

يتم تمرير عناصر الأرشيف إلى عملية التجميع في هيئة قائمة من الأزواج الثنائية التي يربط كل منها اسماً منطقياً بمصفوفة بايتات صريحة تمثل المحتوى الفعلي. في إعدادات الاختبار المعتمدة لدينا، يتضمن الزوج الأول الاسم مشروع/prompt.txt مقترناً بسلسلة البايتات الناتجة عن ترميز العبارة العربية كوب خزفي بصيغة utf8، بينما يتضمن الزوج الثاني الاسم project/manifest.json مقترناً بالبايتات الخام للنص الممثل للنسخة الأولى بصيغة جيسون. يضمن هذا التجهيز المسبق أن كل عنصر يدخل دالة البناء يمتلك هوية مسار واضحة ومحتوى بايتي مكتمل التشفير وجاهز للإدراج المباشر في الأرشيف.

شغّل بناء الأعضاء وقراءة بايتاتهم

تتيح zipfile كتابة أعضاء الأرشيف وقراءة معلوماتهم وفحص CRC عبر testzip. لا يساوي فحص سلامة CRC إثبات هوية مصدر الحزمة أو توقيعها. Python3.12 zipfile

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

توضح هوية مسار الأصل في الفهرس لماذا لا يغني الاسم الأخير وحده عن المسار. داخل ZIP أيضاً يمكن أن يوجد a/x.txt وb/x.txt كعضوين مختلفين؛ لا تجعل التجميع في أرشيف سبباً لاختزال هويتهما.

بعد اكتمال بناء القاموس وتجاوز مرحلة التحقق من صحة جميع المدخلات، تقوم الدالة بإنشاء مجرى ذاكرة مؤقت باستخدام الفئة BytesIO من مكتبة الإدخال والإخراج القياسية io. تفتح الدالة بعد ذلك كائن ZipFile في وضع الكتابة مع تمرير وسيط الضغط المعياري ZIP_STORED الذي يضمن تخزين البيانات دون إخضاعها لأي خوارزمية ضغط تستهلك المعالج أو تعدل من هيئة البايتات. يتيح استخدام مجرى الذاكرة بناء الأرشيف بالكامل واختباره وتمريره بين الدوال البرمجية دون الحاجة إلى كتابة ملف مؤقت على وسائط التخزين الدائمة للنظام المضيف.

تستدعي الدالة التابع sorted على مفاتيح قاموس المدخلات لترتيب مسارات الأعضاء ترتيباً تصاعدياً صارماً قبل إدراجها داخل ترويسات الأرشيف. لكل اسم عضو في هذا الترتيب المقيد، تنشئ الدالة كائن ZipInfo مخصصاً وتمرر له تاريخاً ووقتاً ثابتين تماماً هما الأول من يناير لعام 1980 عند منتصف الليل عبر الصياغة الرقمية (1980, 1, 1, 0, 0, 0). يؤدي هذا التثبيت الصارم للزمن إلى إقصاء أي تأثير لساعة النظام المحلي على محتويات الترويسات، مما يجعل البيانات الوصفية المرتبطة بوقت الملف ثابتة عبر عمليات البناء المتتالية.

تضبط الدالة compress_type على ZIP_STORED وتعين external_attr إلى 0o600 << 16، فتسجل قيمة ثابتة للسمات الخارجية بدلاً من تركها لخط جمع الملفات. في فحص الأرشيف المحفوظ ظهرت القيمة 25165824 لكلا العضوين. يحمل هذا الحقل تمثيلاً لأذونات من نمط بوزيكس، لكنه ليس أمراً يجبر نظام التشغيل المستلم على تطبيق هذه الأذونات. لا يثبت ضبط حقلين إزالة كل اختلاف محتمل بين الأدوات أو الإصدارات؛ النتيجة المرصودة هنا هي تساوي البناءين في البيئة المسجلة، مع الإعدادات الصريحة التي يمكن قراءتها في الشيفرة.

تختتم الدالة معالجة كل عضو باستدعاء التابع writestr على كائن الأرشيف المفتوح مع تمرير كائن ZipInfo المعدل ومصفوفة البايتات المخزنة في القاموس، ثم تستخرج التدفق النهائي عبر استدعاء getvalue على مجرى الذاكرة. يتحقق اختبار الاسترجاع الدائري test_roundtrip_bytes من نجاح هذه السلسلة عبر إعادة قراءة مصفوفة البايتات الناتجة بواسطة ZipFile ومقارنة ما يتم قراءته من المسار مشروع/prompt.txt بالمصفوفة الأصلية لكلمة كوب خزفي المرمزة بترميز utf8، حيث تثبت نتيجة الاختبار تطابق البايتات المسترجعة تطابقاً تاماً مع المدخلات دون أي تغيير.

project_zip.py

from io import BytesIO
from zipfile import ZipFile, ZipInfo, ZIP_STORED

def logical_member(name):
    if not isinstance(name, str) or not name or any(c in name for c in ('\\', ':', '\x00')):
        raise ValueError('Invalid logical archive member')
    if any(part in ('', '.', '..') for part in name.split('/')):
        raise ValueError('Empty and dot segments are not allowed')
    return name

def build_project_zip(items):
    entries = {}
    for name, data in items:
        name = logical_member(name)
        if name in entries or not isinstance(data, bytes):
            raise ValueError('Duplicate path or nonbytes payload')
        entries[name] = data
    output = BytesIO()
    with ZipFile(output, 'w', compression=ZIP_STORED) as archive:
        for name in sorted(entries):
            info = ZipInfo(name, date_time=(1980,1,1,0,0,0))
            info.compress_type = ZIP_STORED
            info.external_attr = 0o600 << 16
            archive.writestr(info, entries[name])
    return output.getvalue()

نطاق التحقق المحلي: تسعة اختبارات تبني أرشيف ZIP وتقرأه من بايتات نص وJSON أصليين باستخدام ZIP_STORED، مع حفظ ملف فعلي. فُحص الاسم العربي وعلم UTF-8 وCRC وتساوي بنائين في البيئة نفسها ورفض تكرار مسار وNUL ومقطع أب، وحفظ اسم أساس واحد في مجلدين، والأرشيف الفارغ. لم يُختبر استخراج أرشيف غير موثوق أو توافق أسماء أنظمة التشغيل أو تشفير أو توقيع أو أداء أو تساو عبر الإصدارات. قيود الأسماء عقد التطبيق وليست فاحص أمان عام. البيئة: Python 3.12.3 على Windows.

احتفظ بالاسم العربي داخل مساحة الأرشيف

يتطلب حفظ الأسماء العربية داخل أرشيفات زيب فهماً دقيقاً لمواصفات الهيكل الثنائي المعتمد من قبل مكتبة zipfile القياسية في بايثون. عند تمرير اسم عضو منطقي يحتوي على حروف غير لاتينية مثل مشروع/prompt.txt، تتعامل المكتبة مع السلسلة النصية عبر تشفيرها وفق ترميز utf8 المعياري. لا تلجأ الدالة إلى استبدال الحروف أو تشويهها بترميزات محلية موروثة، بل تعتمد على الآلية الأصلية التي توفرها المكتبة لتضمين النصوص متعددة البايتات بشكل صريح داخل ترويسات الملفات المحلية وفهرس الدليل المركزي للأرشيف الناتج.

يفحص test_arabic_utf8_flag كائن معلومات العضو العربي عبر getinfo، ثم يمرر نتيجة flag_bits & 0x800 إلى assertTrue تحديداً. لا يستعمل هذا الاختبار assertIsNone؛ ذلك التأكيد يخص اختبار CRC المنفصل. وفي الفحص الإضافي للملف المحفوظ كانت قيمة flag_bits للعضو العربي 2048، وهي القيمة العشرية الموافقة للقناع 0x800. أما عضو project/manifest.json ذو الاسم اللاتيني فكانت قيمته صفرًا. اختلاف الراية لا يعني أن محتوى الملف العربي أكبر جودة أو أن له ترميز محتوى مفروضاً؛ الراية هنا تساعد القارئ على تفسير اسم العضو وفق معلومات ZIP.

تمثل الراية 0x800 الركيزة التقنية المنصوص عليها في معيار أرشفة زيب العام للإشارة إلى أن اسم الملف والتعليقات المصاحبة له مشفرة بترميز utf8 بدلاً من الترميزات الموروثة مثل كود بيج 437. ترفع مكتبة بايثون هذه الراية تلقائياً عند تمرير سلاسل نصية تحتوي على محارف تخرج عن نطاق آسكي القياسي، مما يضمن احتفاظ الاسم العربي بحروفه الأصلية دون تشوه. مع ذلك، فإن وجود هذه الراية يمثل التزاماً بمعيار التنسيق الداخلي فقط، ولا يضمن أن كل برنامج فك ضغط خارجي أو نظام تشغيل قديم سيفسر هذه الراية ويعرض الاسم بشكل سليم على واجهته.

افصل تكرار المسار عن تكرار المحتوى

يرفض عقد التطبيق تكرار المسار الكامل، بينما يسمح بوجود البايتات نفسها تحت اسمين مختلفين. ليست هذه قاعدة تقول إن تنسيق ZIP يستحيل أن يحتوي على أسماء مكررة؛ القرار هنا تتخذه دالتنا قبل الكتابة حتى لا يضطر المستلم إلى حسم أي عضو يقصده بالاسم نفسه. ولا توجد خطوة لإزالة تكرار المحتوى أو لحساب بصمة من أجل دمج عضوين. إذا أردت الحفاظ على ملفين متطابقين لأن لكل منهما دوراً مختلفاً، فالمفتاح الذي تستخدمه الدالة هو المسار لا البايتات. أما سياسة دمج المحتوى المتطابق فتحتاج تصميماً آخر لم ينفذ في هذا المثال.

يتحقق الاختبار المسمى test_duplicate_path من فرض قاعدة منع تكرار المسارات عبر تمرير قائمة تحتوي على نسختين متطابقتين من العنصر الأول self.items[0] الذي يحمل المسار مشروع/prompt.txt. عند محاولة إضافة العنصر الثاني إلى القاموس entries، ترصد الدالة وجود الاسم مسبقاً بين المفاتيح وترفع على الفور استثناء ValueError كما هو متوقع، وهو ما يؤكده الاختبار عبر سياق with self.assertRaises(ValueError). يثبت هذا السلوك أن النظام يمنع تكرار المعرفات المنطقية بصرف النظر عما إذا كان المحتوى المقترن بها متطابقاً أو مختلفاً.

يوضح الاختبار test_same_basename_preserved أن النظام يحتفظ بالعناصر التي تشترك في الاسم الأساسي نفسه طالما أن مساراتها المنطقية الكاملة متباينة، وذلك عبر بناء أرشيف يحتوي على المسارين a/x.txt وb/x.txt بحمولات مختلفة. عند فحص الأرشيف الناتج واستدعاء التابع namelist، يؤكد الاختبار أن عدد الأعضاء يطابق الرقم 2 بدقة، مما يبرهن على أن العقد البرمجي لا يخلط بين هوية المسار المكتمل والاسم الأخير للملف، ويسمح بوجود ملفات تحمل نفس الاسم المجرد داخل مجلدات افتراضية متباينة.

ثبّت ما تريد مقارنته بين بنائين

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

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

يبرهن الاختبار test_same_run_reproducibility على هذه النتيجة العملية من خلال استدعاء دالة البناء مرتين: الأولى باستخدام قائمة العناصر الأصلية self.items، والثانية بتمرير نفس العناصر بعد عكس ترتيب القائمة بالكامل عبر استدعاء list(reversed(self.items)). يؤكد الاختبار عبر دالة المضاهاة assertEqual أن مصفوفة البايتات المسترجعة من البناء الأول تتطابق بايتياً بنسبة مئة بالمئة مع مصفوفة البايتات الناتجة عن البناء المعكوس، مما يثبت أن خوارزمية الترتيب الداخلي تعزل الناتج النهائي تماماً عن ترتيب الإدخال.

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

اقرأ فحص CRC دون تحويله إلى مصادقة

يوفر الاختبار test_crc_check آلية واضحة للتحقق من سلامة الأرشيف المتولد في الذاكرة عبر استدعاء التابع testzip المدمج في كائن ZipFile والتأكد من إرجاعه القيمة None. يقرأ هذا التابع ترويسات جميع الأعضاء ويحسب قيمة فحص التكرار الدوري CRC32 للبيانات المخزنة ويقارنها بالقيمة المسجلة في الترويسة لكل ملف. عندما تتطابق القيم لجميع الأعضاء، يرجع التابع القيمة الفارغة دلالة على سلامة القراءة وتوافق السجلات المحسوبة مع البيانات المدخلة دون رصد أي عطب داخلي.

من الضروري توضيح حقيقة تقنية جوهرية حول هذا الفحص: إن اختبار test_crc_check يكتفي بمراقبة أن testzip يُرجع None لأرشيف تم توليده حديثاً ولم تمسه أي يد، دون إجراء أي حقن للأعطال أو تعديل في البايتات لاختبار آلية الكشف. وبالتالي، لا تدعي الاختبارات المنفذة أنها أثبتت عملياً قدرة النظام على اكتشاف أخطاء التخزين الفيزيائي أو تشوهات النقل عبر الشبكات، بل تثبت فقط أن الأرشيف السليم الذي بنته الشيفرة يحتوي على قيم CRC صحيحة ومتطابقة مع بياناته الأصلية.

لا يعادل فحص سلامة التكرار الدوري CRC32 بأي حال من الأحوال إثبات هوية مصدر الحزمة أو توقيعها الرقمي أو التحقق من موثوقيتها الأمنية. إن خوارزمية CRC مصممة للكشف عن الأخطاء العشوائية البسيطة في تدفق البايتات وليست آلية تشفير ضد التلاعب المتعمد، حيث يمكن لأي جهة تقوم بتعديل البيانات أن تعيد حساب قيمة CRC وتحدث الترويسة بسهولة تامة. يجب التعامل مع نتيجة testzip كأداة فحص داخلي لاتساق البنية التخزينية فقط، مع تجنب الخلط بينها وبين بروتوكولات المصادقة والتوقيع الرقمي.

جهز عقد التسليم للقارئ التالي

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

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

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

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

اختبر استخراجاً أو توافقاً إضافياً فقط عند الحاجة

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

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

تتولى الاختبارات الفردية فحص استجابة دالة الفحص المنطقي للمدخلات الشاذة والتأكد من إطلاق الاستثناءات المناسبة في اللحظة المحددة. في الاختبار test_nul_rejected، يتم تمرير مسار يحتوي على محرف البايت الصفري a\x00b.txt للتأكد من رفع استثناء ValueError فورياً ومنع تسلل هذا المحرف إلى الترويسات. وبالمثل، يختبر test_parent_segment تمرير مسار يبدأ بمقطع الصعود للأب ../a.txt ليرصد الاختبار اعتراض الدالة عليه وإطلاقها لنفس الاستثناء، مما يثبت نجاح الكود في تطبيق قواعد عقده الصارم.

يتحقق الاختبار المسمى test_empty_archive من سلوك الشيفرة عند تمرير قائمة مدخلات فارغة تماماً إلى دالة build_project_zip دون أي عناصر نصية. يُظهر الفحص أن الدالة تنجح في توليد أرشيف زيب صالح من الناحية الهيكلية يحتوي على ترويسة نهاية الدليل المركزي القياسية فقط، حيث يُرجع التابع z.namelist() قائمة فارغة تماماً مطابقة للمدخلات. يثبت هذا الاختبار قدرة دالة البناء على معالجة الحالات الطرفية البسيطة دون انهيار أو إطلاق استثناءات غير متوقعة عند غياب البيانات.

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

افحص الأرشيف المحفوظ قبل دمجه في مسار التسليم

يضيف فحص الملف المحفوظ نقطة عملية إلى قراءة اختبارات الوحدات: يمكن مطابقة الأرشيف الذي ستسلمه مع ما بُني في الذاكرة. في هذه القراءة كان ترتيب العضوين project/manifest.json ثم مشروع/prompt.txt، رغم أن قائمة الاختبار الأصلية تبدأ بالنص العربي. السبب الظاهر في الشيفرة هو sorted(entries)، وليس ترتيب عرض المجلدات في واجهة استخراج. يفيد حفظ هذا الترتيب عند التحقيق في اختلاف بصمتين: ابدأ بالسؤال عما إذا تغيرت قائمة الأسماء أو ترتيب السجلات قبل اتهام المحتوى نفسه. لا يعني ترتيب الفهرس هنا أن المستلم ملزم بعرض العناصر بالطريقة البصرية نفسها.

أظهرت القراءة أن حجم بيانات manifest.json هو 13 بايتاً وحجم بيانات prompt.txt هو 15 بايتاً، وأن compress_size يساوي file_size لكل عضو لأن طريقة التخزين المسجلة هي صفر، أي ZIP_STORED. لا يساوي مجموع 28 بايتاً حجم الأرشيف الكامل البالغ 286 بايتاً؛ فالملف يحمل أيضاً أسماء وترويسات وفهرساً. تساعد هذه المقارنة على تفسير لماذا قد تكون حزمة نصية صغيرة أكبر من مجموع محتوياتها، من دون تعميم نسبة حجم على ملفات أخرى. وهي ليست نتيجة ضغط منافسة: لم نجرب خوارزمية بديلة، ولم نقس وقت القراءة أو استهلاك المعالج.

عند فتح عضو manifest في القراءة الإضافية كان النص المسترجع هو {"version":1} بالضبط، من دون سطر جديد مضاف، بينما استرجع العضو العربي العبارة كوب خزفي. دالة البناء لا تعرف معنى حقل version ولا تتحقق من مخطط JSON، بل تحفظ البايتات المعطاة لها. إذا أضاف مولد سابق سطراً جديداً أو فراغاً داخل مستند JSON، فقد تبقى دلالة المستند مناسبة لتطبيقه لكن البايتات وبصمة الأرشيف ستختلف. لذلك افصل فحص المعنى الذي يحتاجه المستهلك عن مطلب تساوي البايتات في هذا المثال؛ لا تستخدم أحدهما بديلاً عن الآخر.

سجلت القراءة أيضاً تاريخ العضوين بالقيم (1980, 1, 1, 0, 0, 0)، وقيمة CRC32 مقدارها 71309a33 لعضو JSON وebcb99b0 للنص العربي. هذه القيم تصف الملف المحفوظ الذي قرأناه، وليست معرفات دائمة لأي ملف يحمل الاسم نفسه. كانت نتيجة testzip هي None لهذا الأرشيف. عند تغيير المحفز عمداً ينبغي أن تتغير البيانات وقد تتغير CRC والبصمة، مع بقاء اسم المسار صالحاً؛ عندئذ يكون اختلاف الناتج متوقعاً. لا يشكل التطابق مع قيمنا شرطاً لقبول مشروع آخر له نص مختلف، كما لا يثبت التطابق وحده هوية مصدره.

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

أُعد المقال بمساعدة أدوات ذكاء اصطناعي ومراجعات آلية. شُغلت الشيفرة الأصلية محلياً ضمن نطاق الاختبارات المسجل، دون ادعاء تجربة بشرية ميدانية أو اتصال بمزود صور أو تجربة توليد فيديو.

التعليقات

كن أول من يعلّق على هذا المقال.

أضف تعليقاً

بريدك لن يُنشر. الحقول المطلوبة معلَّمة بنجمة.