matomo / ini
Installs: 781 753
Dependents: 13
Suggesters: 0
Security: 0
Stars: 50
Watchers: 19
Forks: 25
Open Issues: 3
Requires
- php: >=7.2
Requires (Dev)
- phpbench/phpbench: ^1.0
- phpunit/phpunit: ^8.5
README
Read and write INI configurations.
Installation
composer require matomo/ini
Why?
PHP provides a parse_ini_file()
function to read INI files.
This component provides the following benefits over the built-in function:
- allows one to write INI files
- classes can be used with dependency injection and mocked in unit tests
- throws exceptions instead of PHP errors
- better type supports:
- parses boolean values (
true
/false
,on
/off
,yes
/no
) to real PHP booleans (instead of strings"1"
and""
) - parses null to PHP
null
(instead of an empty string)
- parses boolean values (
- works even if
parse_ini_file()
orparse_ini_string()
is disabled inphp.ini
by falling back on an alternate implementation (can happen on some shared hosts)
Usage
Read
$reader = new IniReader(); // Read a string $array = $reader->readString($string); // Read a file $array = $reader->readFile('config.ini');
Troubleshooting
unexpected BOOL_TRUE in Unknown on line X
The PHP default implementation of read_ini_file does not allow bool-ish values as keys in when reading ini files.
Data like yes = "Yes"
results in the following error:
Syntax error in INI configuration: syntax error, unexpected BOOL_TRUE in Unknown on line 6
To prevent from that error, please switch to the custom ini reader implementation by using:
$reader = new IniReader(); $reader->setUseNativeFunction(false);
Write
$writer = new IniWriter(); // Write to a string $string = $writer->writeToString($array); // Write to a file $writer->writeToFile('config.ini', $array);
License
The Ini component is released under the LGPL v3.0.
Contributing
To run the unit tests:
vendor/bin/phpunit
To run the performance tests:
php vendor/bin/phpbench run tests/PerformanceTest --report=default