linkorb/connector

Database connection config resolver

connector

Connector helps you to manage your app's database connection configurations in dynamic environments., _(*1)

Your app simply requests a configuration from connector by a name., _(*2)

Connector will resolve the name into a full database configuration object with properties like username, password, address, port, protocol etc., _(*3)

Connector then helps you to turn this Config object into a PDO connection., _(*4)

Next to the common Config properties, Connector also allows you to define custom properties on a a database config instance. These custom properties can then be used by your app to configure the application behaviour., _(*5)

Cascading configuration

A configuration may define connection properties directly, or refer to a server and/or cluster by name., _(*6)

This enables cascading configuration at 3 levels:, _(*7)

• db
• server
• cluster

Using this feature you can define the server or cluster at the db level, and configure address, username, password, port and custom properties at a higher level. This way you can quickly mass-reconfigure all dbs on a given server or cluster., _(*8)

Usage

Please refer to examples/ for usage examples, _(*9)

Contributing

We welcome contributions to make this repository even better. Whether it's fixing a bug, adding a feature, or improving documentation, your help is highly appreciated. To get started, fork this repository then clone your fork., _(*10)

Be sure to familiarize yourself with LinkORB's Contribution Guidelines for our standards around commits, branches, and pull requests, as well as our code of conduct before submitting any changes., _(*11)

If you are unable to implement changes you like yourself, don't hesitate to open a new issue report so that we or others may take care of it., _(*12)

Brought to you by the LinkORB Engineering team

Check out our other projects at linkorb.com/engineering. By the way, we're hiring!, _(*13)