cline/ferret

Ferret out configuration files in various formats from your filesystem.

1.2.1 2025-12-02 16:35 UTC

Requires

• php: ^8.5.0
• illuminate/contracts: ^12.0
• illuminate/filesystem: ^12.0
• illuminate/support: ^12.0
• nette/neon: ^3.4.6
• saloonphp/xml-wrangler: ^1.4.1
• spatie/laravel-package-tools: ^1.92.7
• symfony/yaml: ^7.4
• yosymfony/toml: ^1.0.4

Requires (Dev)

• cline/php-cs-fixer: ^1.2.1
• driftingly/rector-laravel: ^2.1.5
• ergebnis/composer-normalize: ^2.48.2
• larastan/larastan: ^3.8
• orchestra/testbench: ^10.8
• pestphp/pest: ^4.1.6
• pestphp/pest-plugin-drift: ^4.0
• pestphp/pest-plugin-laravel: ^4.0
• pestphp/pest-plugin-type-coverage: ^4.0.3
• phpstan/phpstan: ^2.1.32
• rector/rector: ^2.2.11
• symfony/var-dumper: ^7.4.0
• symplify/easy-coding-standard: ^13.0

MIT

• Brian Faust

• yaml
• php
• json
• configuration
• config
• laravel
• ferret
• rc

README

Ferret is a Laravel package for searching and loading configuration files in various formats. It provides a flexible way to find and load configuration from multiple locations and formats.

Requirements

Requires PHP 8.4+ and Laravel 12+

Installation

composer require cline/ferret

Documentation

• Directory Loading - Load entire directories of config files with dot-notation access
• Combining Configs - Merge multiple config files with deep/shallow merging
• Format Conversion - Convert between JSON, YAML, NEON, XML, INI, and PHP
• Encryption - Encrypt and decrypt sensitive configuration files

Supported Formats

Format	Extension	Read	Write
JSON	.json	✓	✓
YAML	.yaml	✓	✓
NEON	.neon	✓	✓
XML	.xml	✓	✓
INI	.ini	✓	✓
PHP	.php	✓	✓

Change log

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Brian Faust
• All Contributors

License

The MIT License. Please see License File for more information.