comphp/config-php

Configuration Driver for CommonPHP which includes/builds PHP include files that return arrays

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 writes and reads PHP files returning configuration arrays.

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-php

Usage

<?php

use CommonPHP\Drivers\Config\PHP\PhpConfigurationDriver;

$driver = new PhpConfigurationDriver();

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

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

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

Format Notes

PHP config files must return an array. This driver includes PHP files when decoding or reading, so configuration files are trusted code and are executed by PHP.

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.