comphp/config-ini

Configuration Driver for CommonPHP which encodes/decodes the INI format

0.3 2026-05-20 17:45 UTC

Requires

• php: ^8.5
• comphp/config: ^0.3

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.95
• phpunit/phpunit: ^13.1

MIT

README

Configuration driver for CommonPHP that encodes and decodes INI configuration data.

Requirements

• PHP ^8.5
• comphp/config:^0.3

Installation

Once this package is available through your Composer repositories, install it with:

composer require comphp/config-ini

Usage

<?php

use CommonPHP\Drivers\Config\INI\IniConfigurationDriver;

$driver = new IniConfigurationDriver();

$config = [
    'app' => 'demo',
    'debug' => true,
    'database' => [
        'host' => 'localhost',
    ],
];

$ini = $driver->encode($config);
$decoded = $driver->decode($ini);

$driver->write(__DIR__ . '/config.ini', $config);
$fromFile = $driver->read(__DIR__ . '/config.ini');

Format Notes

This driver uses PHP's INI parser with typed scanning. Scalar values are supported at the top level, and one level of sections is supported for grouped values. Nested arrays beyond one section level are not supported by INI and are rejected during encoding.

Error Handling

Read, write, parse, validation, and unsupported value failures throw CommonPHP config exceptions such as ConfigReadException, ConfigWriteException, ConfigValidationException, or ConfigException.

Documentation

• Usage
• Testing
• Contributing
• Security

License

MIT. See LICENSE.md.