مدقّق INI
تحقق من صحة ملفات إعداد INI مثل php.ini وmy.cnf وإدخالات سطح المكتب أو إعدادات الأدوات قبل أن ترفض خدمة ما بدء التشغيل. يقرأ المدقّق كل سطر، ويقبل الأقسام وأزواج المفاتيح والقيم والتعليقات والقيم المحاطة بعلامات اقتباس، ويُبلغ عن الأسطر التي لا يستطيع فهمها وترويسات الأقسام غير المغلقة والمفاتيح الفارغة وعلامات الاقتباس غير المغلقة. كما يحدد المفاتيح والأقسام المكررة، ويسرد كل قسم مع مفاتيحه، لتتمكن من مراجعة البنية سريعًا.
الأسئلة الشائعة
ما الذي يجعل ملف INI صالحًا هنا؟
يجب أن يكون كل سطر غير فارغ ترويسة قسم مثل [database]، أو مفتاحًا مع قيمة مثل host = localhost، أو تعليقًا. يُعد خطأً أي سطر لا ينطبق عليه أي من ذلك، أو ترويسة قسم غير مغلقة، أو مفتاح فارغ، أو قيمة محاطة بعلامات اقتباس لم تُغلق. تجعل الأخطاء الملف غير صالح، وتُدرج مع أرقام أسطرها.
لا يوجد معيار موحد لـ INI. ما القواعد التي يستخدمها المدقّق؟
يتبع الصيغة الشائعة التي تستخدمها PHP وMySQL والعديد من الأدوات: تُفصل المفاتيح والقيم بعلامة = أو بعلامة : عند عدم وجود =، وتبدأ التعليقات بعلامة ; أو #، كما تبدأ التعليقات المضمّنة بعلامة ; أو # إذا جاءت بعد مسافة بيضاء في قيمة غير محاطة بعلامات اقتباس. قد تحتوي أسماء الأقسام على مسافات ونقاط وعلامات اقتباس، مثل أقسام نمط Git. لا تُتحقق أنواع القيم، لأن INI لا يحتوي على أنواع بيانات.
ماذا يحدث عند تكرار المفاتيح؟
يُبلغ عن تعريف مفتاح مرتين في القسم نفسه كتحذير، مع ذكر سطر التعريف الثاني. تحتفظ معظم محللات INI بالقيمة الأخيرة، لذا تُهمل القيمة السابقة بصمت. ويظل الملف صالحًا.
ماذا يحدث عند تكرار الأقسام؟
يُبلغ عن تكرار ترويسة قسم كتحذير، وتُدمج مفاتيحها مع مفاتيح الظهور الأول. تتعامل بعض البرامج مع الأقسام المتكررة بطرق مختلفة، لذا يُفضّل عادةً دمجها.
هل مفاتيح المصفوفات مثل extension[] مدعومة؟
نعم. تجمع المفاتيح التي تنتهي بـ [] قيمها في قائمة، كما في ملفات إعداد PHP، ولا يُبلغ عن تكرارها كتكرار للمفاتيح. يعرض سرد الأقسام المفتاح مرة واحدة.
ما المفاتيح العامة؟
المفاتيح التي تظهر قبل أول ترويسة قسم لا تنتمي إلى أي قسم. تُدرج في النتيجة ضمن «المفاتيح العامة»، وتتعامل معها أدوات كثيرة كإعدادات افتراضية أو إعدادات على المستوى الأعلى.
كيف تُعالَج القيم المحاطة بعلامات اقتباس؟
قد تحتوي القيم بين علامتي اقتباس مزدوجتين على ; و# و=، وتدعم تسلسلات الهروب \", \\, \n و\t، بينما تُؤخذ القيم بين علامتي اقتباس مفردتين حرفيًا. وتُعد القيمة المحاطة بعلامات اقتباس وغير المغلقة في السطر نفسه خطأً. أما القيم غير المحاطة بعلامات اقتباس فتُزال المسافات المحيطة بها.
ما مقدار البنية الذي يُدرج؟
تسرد النتيجة كل قسم مع عدد مفاتيحه وأسماء المفاتيح، بحد أقصى 200 قسمًا و50 مفتاحًا لكل قسم، بالإضافة إلى إجمالي عدد الأقسام والمفاتيح. ويُعرض ما يصل إلى 20 خطأً و20 تحذيرًا، مع عدد أي أخطاء أو تحذيرات إضافية.
هل تُفهم الأقسام المتداخلة مثل [a.b]؟
تُحفظ أسماء الأقسام كما كُتبت تمامًا، لذا فإن [a.b] هو قسم اسمه a.b، وليس قسمًا فرعيًا من a. يعتمد اعتبار النقاط علامات تداخل على البرنامج نفسه. يتحقق المدقّق فقط من أن الاسم غير فارغ وأن الترويسة مغلقة.
ما الحد الأقصى لحجم الملف، وهل يمكنني تحويله؟
يمكن أن يصل حجم المدخلات إلى 5 MiB. لتحويل ملف INI صالح إلى JSON أو YAML أو TOML أو تنسيق آخر، استخدم محول تنسيق البيانات، الذي يحوّل الأقسام إلى كائنات.