PHP parse_ini_file() Function












❮ مرجع فایل سیستم PHP

مثال


محتوای "test.ini":



[name]

من = رابرت

تو = پیتر



[urls]

first = "http://www.example.com"

دوم = "https://www.w4schools.com"

کد PHP:




print_r(parse_ini_file("test.ini"));

?>

خروجی کد بالا این خواهد بود:



آرایه
(


[من] => رابرت


[شما] => پیتر


[اول] => http://www.example.com


[دوم] => https://www.w4schools.com

)







تعریف و استفاده


تابع parse_ini_file() یک فایل پیکربندی (ini) را تجزیه می کند و برمی گرداند
تنظیمات.


نکته: از این تابع می‌توان برای خواندن خود استفاده کرد
فایل های پیکربندی، و ربطی به فایل php.ini ندارد.


توجه: کلمات رزرو شده زیر نباید به عنوان کلید برای ini استفاده شوند
فایل ها: پوچ، بله، خیر، درست، نادرست، روشن، خاموش، هیچکدام. علاوه بر این موارد زیر محفوظ است
کاراکترها نباید در کلید استفاده شوند: {}|&~!()^".



نحو



parse_ini_file(پرونده، بخش_فرآیند، حالت_اسکنر)

مقادیر پارامتر









مشخص می کند



است





پارامتر توضیح
پرونده لازم است. فایل ini را برای تجزیه
بخش‌های_فرایند اختیاری. اگر روی TRUE تنظیم شود، یک آرایه چند بعدی با نام بخش ها و تنظیمات برمی گردد. پیش فرض FALSE
حالت_اسکنر

اختیاری. می تواند یکی از مقادیر زیر باشد:



  • INI_SCANNER_NORMAL (پیش‌فرض)

  • INI_SCANNER_RAW (یعنی مقادیر گزینه تجزیه نخواهد شد)

  • INI_SCANNER_TYPED (به این معنی که انواع بولی، تهی و صحیح هستند
    در صورت امکان حفظ می شود. "true"، "on"، "yes" به TRUE تبدیل می شوند.
    "false"، "off"، "no"، "none" به FALSE تبدیل می شوند. "null" تبدیل می شود
    به NULL. رشته های عددی در صورت امکان به نوع عدد صحیح تبدیل می شوند)














جزئیات فنی















مقدار بازگشتی: آرایه در مورد موفقیت، FALSE در مورد شکست
نسخه PHP: 4.0+
تغییر PHP: PHP 7.0: علامت های هش (C#) دیگر به عنوان نظر شناخته نمی شود
PHP 5.6.1:
اضافه شدن حالت INI_SCANNER_TYPED
PHP 5.3: اضافه شدن پارامتر اختیاری scanner_mode



نمونه های بیشتر




مثال


محتوای "test.ini":



[name]

من = رابرت

تو = پیتر



[urls]

first = "http://www.example.com"

دوم = "https://www.w4schools.com"

کد PHP (با process_sections روی true):




print_r(parse_ini_file("test.ini",true));

?>

خروجی کد بالا این خواهد بود:



آرایه

(

[نام] => آرایه

(

[من] => رابرت

[شما] => پیتر

)

[urls] => آرایه

(

[اول] => http://www.example.com

[دوم] => https://www.w4schools.com

)

)






❮ مرجع فایل سیستم PHP