INI valideerija
Valideerige INI konfiguratsioonifaile, näiteks php.ini, my.cnf, töölauakirjeid või tööriistade seadeid enne, kui teenus keeldub käivitumast. Valideerija loeb läbi kõik read, tunneb ära jaotised, võtme-väärtuse paarid, kommentaarid ja jutumärkides väärtused ning teatab ridadest, millest ta aru ei saa, sulgemata jaotise päistest, tühjadest võtmetest ja sulgemata jutumärkidest. Samuti märgib see korduvad võtmed ja jaotised ning loetleb iga jaotise koos selle võtmetega, et saaksite struktuuri ühe pilguga üle vaadata.
Korduma kippuvad küsimused
Mis teeb INI-faili siin kehtivaks?
Iga mittetühi rida peab olema jaotise päis, näiteks [database], väärtusega võti, näiteks host = localhost, või kommentaar. Viga on rida, mis ei vasta ühelegi neist, sulgemata jaotise päis, tühi võti või sulgemata jutumärkides väärtus. Vigade korral märgitakse fail kehtetuks ja vead kuvatakse koos reanumbritega.
INI-l pole ühtset standardit. Milliseid reegleid valideerija kasutab?
See järgib levinud dialekti, mida kasutavad PHP, MySQL ja paljud tööriistad: võtmed ja väärtused eraldatakse märgiga = või märgiga :, kui = puudub; kommentaarid algavad märgiga ; või # ning jutumärkideta väärtusele järgnevad tühimärgi järel ; või # alustavad reasisest kommentaari. Jaotiste nimedes võivad olla tühikud, punktid ja jutumärgid, nagu Git stiilis jaotistes. Väärtuste tüüpi ei kontrollita, sest INI-l pole andmetüüpe.
Mis juhtub korduvate võtmetega?
Samas jaotises kaks korda määratletud võti kuvatakse hoiatusena koos teise määratluse reanumbriga. Enamik INI-parsereid jätab alles viimase väärtuse, nii et varasem jäetakse vaikselt kõrvale. Fail märgitakse siiski kehtivaks.
Mis juhtub korduvate jaotistega?
Uuesti esinev jaotise päis kuvatakse hoiatusena ning selle võtmed liidetakse esimese esinemise võtmetega. Mõned programmid käsitlevad korduvaid jaotisi erinevalt, seega on tavaliselt kõige parem need ühendada.
Kas massiivivõtmeid, nagu extension[], toetatakse?
Jah. []-ga lõppevate võtmete väärtused kogutakse loendisse, nagu PHP konfiguratsioonifailides, ning nende kordumist ei teatata duplikaadina. Jaotiste loendis kuvatakse võti üks kord.
Mis on globaalsed võtmed?
Enne esimest jaotise päist esinevad võtmed ei kuulu ühtegi jaotisse. Tulemuses loetletakse need globaalsete võtmetena ning paljud tööriistad käsitlevad neid vaikeväärtuste või ülataseme seadetena.
Kuidas käsitletakse jutumärkides väärtusi?
Topeltjutumärkides väärtused võivad sisaldada märke ;, # ja = ning toetavad paojadasid \", \\, \n ja \t, samas kui ühekordsetes jutumärkides väärtusi käsitletakse sõnasõnaliselt. Kui jutumärkides väärtus pole sama rea lõpuks suletud, on tegemist veaga. Jutumärkideta väärtustelt eemaldatakse ümbritsevad tühikud.
Kui suur osa struktuurist loetletakse?
Tulemuses loetletakse iga jaotis koos võtmete arvu ja võtmenimedega, kuni 200 jaotist ning 50 võtit jaotise kohta, samuti kõigi jaotiste ja võtmete koguarv. Kuvatakse kuni 20 viga ja 20 hoiatust ning edasiste teadete arv.
Kas pesastatud jaotistest, nagu [a.b], saadakse aru?
Jaotiste nimed säilitatakse täpselt algsel kujul, seega on [a.b] nimega a.b jaotis, mitte jaotise a alamjaotis. See, kas programm käsitleb punkte pesastuse tähisena, sõltub programmist. Valideerija kontrollib ainult seda, et nimi pole tühi ja päis on suletud.
Kui suur võib fail olla ja kas saan selle teisendada?
Sisend võib olla kuni 5 MiB. Kehtiva INI-faili teisendamiseks vormingusse JSON, YAML, TOML või mõnda muusse vormingusse kasutage Data Format Converterit, mis teisendab jaotised objektideks.