محلل INI

يدعم هذا المحلل الأقسام وأزواج مفتاح=قيمة والتعليقات (باستخدام ; أو #) وقيم السلاسل النصية بين علامات اقتباس والقيم متعددة الأسطر. كما يتعامل مع كشف الأنواع المنطقية والرقمية.

يتعامل هذا المحلل مع تنسيق INI القياسي. بعض امتدادات PHP الخاصة مثل استبدال الثوابت والعوامل الخاصة قد لا تكون مدعومة.

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

مواضع الاستخدام الكلاسيكية: php.ini (تكوين محرك PHP بالكامل)، و.gitconfig، وإرث win.ini على Windows، ومدخلات .desktop على Linux، فضلاً عن العديد من الألعاب وتطبيقات سطح المكتب. تعود جذور هذا التنسيق إلى الستينيات والسبعينيات، ولهذا تختلف صياغته قليلاً من مكان لآخر - الأقسام وkey=value والتعليقات بالفاصلة المنقوطة هي النواة المستقرة.

لا - كل شيء عبارة عن سلسلة نصية؛ الأنواع مجرد اصطلاح من جانب المستهلك. تُحوِّل دالة parse_ini_file() في PHP القيم true/on/yes/1 وfalse/off/no/0 إلى قيم منطقية (سلوك موثق)، وتحوِّل القيم الشبيهة بالأرقام إلى أعداد صحيحة وأعداد عائمة، وتُبقي الباقي كسلاسل نصية. وضع قيمة بين علامتي اقتباس ('1') يحفظها كسلسلة نصية في PHP. يعرض هذا المحلل القيم الخام كما كُتبت.

[section] يبدأ قسماً يشمل جميع المفاتيح التالية حتى الترويسة التالية - كتل [PHP] و[mail function] في php.ini تعمل بهذه الطريقة. ويُحاكى التداخل باستخدام مفاتيح منقوطة بالنقاط (database.host = localhost) أو أسماء أقسام مثل [database.pool]، لأن التنسيق ذاته لا يملك سوى مستوى واحد. البيانات المتداخلة بعمق هي علامة على أنك تجاوزت ما يوفره INI وتحتاج إلى TOML أو YAML.

التنسيق الأساسي لا يعرّف تقريباً أي تسلسلات تهريب - تُؤخذ القيم حرفياً حتى نهاية السطر. عملياً: علامات الاقتباس المزدوجة تجمع القيم التي تحتوي مسافات، وهي الطريقة الوحيدة القابلة للنقل للحفاظ على المسافات في البداية أو النهاية؛ ويوجد استيفاء ${VAR} في بعض التطبيقات (systemd منها) وغائب عن أخرى؛ وأما ما إذا كان ; و# يبدآن تعليقاً في منتصف السطر فيتوقف على المحلل الذي يستهلك الملف.

ملف .env هو المجموعة الفرعية المسطحة من INI: أسطر بصيغة KEY=value، بلا أقسام، وتستهلكها مكتبات dotenv في عشرات اللغات وفق منهجية التكوين في 12-Factor App. تعتمد ملفات INI على الأقسام وتقرأها تطبيقات محددة بدلاً من أن تكون اصطلاحاً عاماً. قيم .env هي في الغالب سلاسل نصية تُحقن في متغيرات البيئة، بينما يطبق مستهلكو INI غالباً قواعد أنواع خاصة بهم.