piwik/ini

Matomo/Ini

Read and write INI configurations., _(*1)

, _(*2)

Installation

composer require matomo/ini

Why?

PHP provides a parse_ini_file() function to read INI files., _(*3)

This component provides the following benefits over the built-in function:, _(*4)

• 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)
• works even if parse_ini_file() or parse_ini_string() is disabled in php.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, _(*5)

The PHP default implementation of read_ini_file does not allow bool-ish values as keys in when reading ini files., _(*6)

Data like yes = "Yes" results in the following error:, _(*7)

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:, _(*8)

$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., _(*9)

Contributing

To run the unit tests:, _(*10)

vendor/bin/phpunit

To run the performance tests:, _(*11)

php vendor/bin/phpbench run tests/PerformanceTest --report=default