Baike.dev
All toolsOnline toolsAI codingTrendingOpen sourceNewsSubmit
Log in
< Back to tools
C

config

> 编程语言
Open source

Simple yet expressive schema-based configuration library for PHP apps

567 stars0 likes2 views
WebsiteGitHub

About

Simple yet expressive schema-based configuration library for PHP apps

league/config

league/config helps you define nested configuration arrays with strict schemas and access configuration values with dot notation. It was created by Colin O'Dell.

Installation

This project requires PHP 7.4 or higher. To install it via Composer simply run:

bash
composer require league/config

️ Basic Usage

The Configuration class provides everything you need to define the configuration structure and fetch values:

…

Documentation

Full documentation can be found at config.thephpleague.com.

Philosophy

This library aims to provide a simple yet opinionated approach to configuration with the following goals:

  • The configuration should operate on arrays with nested values which are easily accessible
  • The configuration structure should be defined with strict schemas defining the overall structure, allowed types, and allowed values
  • Schemas should be defined using a simple, fluent interface
  • You should be able to add and combine schemas but never modify existing ones
  • Both the configuration values and the schema should be defined and managed with PHP code
  • Schemas should be immutable; they should never change once they are set
  • Configuration values should never define or influence the schemas

As a result, this library will likely never support features like:

  • Loading and/or exporting configuration values or schemas using YAML, XML, or other files
  • Parsing configuration values from a command line or other user interface
  • Dynamically changing the schema, allowed values, or default values based on other configuration values

If you need that functionality you should check out other libraries like:

  • symfony/config
  • symfony/options-resolver
  • hassankhan/config
  • consolidation/config
  • laminas/laminas-config

️ Versioning

SemVer is followed closely. Minor and patch releases should not introduce breaking changes to the codebase.

Any classes or methods marked @internal are not intended for use outside this library and are subject to breaking changes at any time, so please avoid using them.

️ Maintenance & Support

When a new minor version (e.g. 1.0 -> 1.1) is released, the previous one (1.0) will continue to receive security and critical bug fixes for at least 3 months.

When a new major version is released (e.g. 1.1 -> 2.0), the previous one (1.1) will receive critical bug fixes for at least 3 months and security updates for 6 months after that new release comes out.

(This policy may change in the future and exceptions may be made on a case-by-case basis.)

‍️ Contributing

Contributions to this library are welcome! We only ask that you adhere to our contributor guidelines and avoid making changes that conflict with our Philosophy above.

Testing

bash
composer test

License

league/config is licensed under the BSD-3 license. See the LICENSE.md file for more details.

️ Who Uses It?

This project is used by league/commonmark.

Issues· 0 open

View all issuesOpen on GitHub

No open issues yet, or sync has not completed.

> Tags

PHPconfigconfigurationhacktoberfestphp

No comments yet. Be the first to share.

> Details

PublishedAug 1, 2026
UpdatedSep 17, 2026
Category编程语言
PricingOpen source

> Related tools

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言