INI پارسر

یہ پارسر سیکشنز، key=value جوڑے، تبصرے (; یا # کے ساتھ)، قوطی بند اسٹرنگ اقدار، اور ملٹی لائن اقدار سپورٹ کرتا ہے۔ یہ boolean اور عددی قسم کی شناخت بھی سنبھالتا ہے۔

یہ پارسر معیاری INI فارمیٹ سنبھالتا ہے۔ constant substitution جیسی جیسی کچھ PHP مخصوص توسیعات معاون نہیں ہو سکتیں۔

جب اسی سیکشن میں ڈپلیکیٹ کیز ملیں تو آخری قدر کو فوقیت ملتی ہے۔ یہ معیاری INI پارزنگ رویے کے مطابق ہے۔

کلاسک ٹھکانے: php.ini (PHP انجن کی مکمل کنفیگریشن)، .gitconfig، Windows کی win.ini وراثت، Linux کی .desktop اندراجات، اور بہت سے گیمز اور ڈیسک ٹاپ ایپس۔ فارمیٹ کی جڑیں 1960-70 کی دہائی میں ہیں، اسی لیے نحو ہر جگہ تھوڑا مختلف ہے - سیکشنز، key=value اور سیمیکولن تبصرے مستحکم بنیاد ہیں۔

نہیں - سب کچھ string ہے؛ اقسام صارف طرف کی روایت ہیں۔ PHP کا parse_ini_file() درست/آن/ہاں/1 اور غلط/آف/نہیں/0 کو boolean میں بدلتا ہے (دستاویزی رویہ)، عدد جیسی دیکھنے والی اقدار کو integer اور float میں بدلتا ہے، اور باقی کو string رکھتا ہے۔ قدر کو quotes میں رکھنا ('1') اسے PHP میں string برقرار رکھتا ہے۔ یہ پارسر خام اقدار کو جیسے لکھے گئے ہیں دکھاتا ہے۔

[section] ایک سیکشن شروع کرتا ہے جو اگلے ہیڈر تک آنے والی تمام کیز کو احاطہ کرتا ہے - php.ini کے [PHP] اور [mail function] بلاکس اسی طرح کام کرتے ہیں۔ Nesting ڈاٹ والی کیز (database.host = localhost) یا [database.pool] جیسے سیکشن ناموں سے جعلی بنائی جاتی ہے، کیونکہ فارمیٹ میں خود صرف ایک سطح ہے۔ گہرا nested ڈیٹا اس بات کی نشاندہی ہے کہ آپ INI سے بڑے ہو چکے ہیں اور TOML یا YAML چاہیے۔

بنیادی فارمیٹ تقریباً کوئی escape تعین نہیں کرتا - اقدار لائن کے آخر تک حرفاً لی جاتی ہیں۔ عمل میں: ڈبل quotes اسپیس والی اقدار کو گروپ کرتے ہیں اور شروع یا آخر کی whitespace رکھنے کا واحد portable طریقہ ہیں؛ ${VAR} interpolation کچھ implementations میں ہے (systemd مثلاً) مگر سب میں نہیں؛ اور ; اور # لائن کے بیچ میں تبصرہ شروع کرتے ہیں یا نہیں، یہ استعمال کرنے والے پارسر پر منحصر ہے۔

.env، INI کا flat ذیلی سیٹ ہے: KEY=value سطریں، کوئی سیکشن نہیں، 12-Factor App کنفیگریشن میتھڈالوجی کی پیروی کرنے والی درجن بھر زبانوں کی dotenv لائبریریوں سے استعمال ہوتا ہے۔ INI فائلیں سیکشنز پر انحصار کرتی ہیں اور عام روایت کے بجائے مخصوص ایپلیکیشنز انہیں پڑھتی ہیں۔ .env کی اقدار تقریباً ہمیشہ environment variables میں انجیکٹ ہونے والی strings ہوتی ہیں، جبکہ INI صارفین اکثر اپنے typing قواعد لاگو کرتے ہیں۔