تهريب حقل CSV: الفواصل والأسطر الجديدة وعلامات الاقتباس

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

حوّلوا أي نص إلى حقل CSV آمن

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

اعرفوا متى تلزم الإحاطة ومضاعفة علامات الاقتباس

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

استخدموا القيمة المهرّبة في التصدير ومسارات المعالجة

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