README

Laravel Manager was created by, and is maintained by Graham Campbell, and provides some manager functionality for Laravel. Feel free to check out the change log, releases, security policy, license, code of conduct, and contribution guidelines.

Installation

This version requires PHP 7.4-8.3 and supports Laravel 8-11.

To get the latest version, simply require the project using Composer:

$ composer require "graham-campbell/manager:^5.1"

Once installed, you can extend or implement the classes in this package to speed up writing Laravel packages further. There are no service providers to register.

Configuration

Laravel Manager requires no configuration. Just follow the simple install instructions and go!

Usage

ConnectorInterface

This interface defines one public method.

The 'connect' method accepts one parameter which is an array of config.

This interface is not used by this package, but is used by the likes of Laravel Flysystem.

ManagerInterface

This interface defines the public methods a manager class must implement.

The 'connection' method accepts one optional parameter (the connection name), and will return a connection instance and will reuse a previous connection from the pool if possible.

The 'reconnect' method accepts one optional parameter (the connection name), and will return a connection instance after forcing a re-connect.

The 'disconnect' method accepts one optional parameter (the connection name), and will return nothing after removing the connection from the pool.

The 'getConnectionConfig' method has one required parameter (the connection name), and will return the config for the specified connection.

The 'getDefaultConnection' method will return the default connection as specified in the config.

The 'setDefaultConnection' method has one required parameter (the connection name), and will return nothing after setting the default connection.

The 'extend' method has two required parameter. The first is the name of a connection, or the name of a connection driver. The second parameter must be callable. The purpose of this method is to add custom connection creation methods on the fly. The second parameter must return a connection.

The 'getConnections' method will return an array of all the connections currently in the pool.

AbstractManager

This abstract class implements the ManagerInterface. It has two abstract protected methods that must be implemented by extending classes.

The 'createConnection' method will be called with the specific connection config as the first parameter. It must return a connection instance.

The 'getConfigName' method must return the name of the connection config. This may be 'yourname\yourpackage' for example.

You can also dynamically call methods on the default connection due to the use of __call so instead of writing ->connection()->methodName(), you can just jump straight in with ->methodName().

Further Information

You may see an example of implementation in Laravel Flysystem, Laravel DigitalOcean, and Laravel GitHub.

Security

If you discover a security vulnerability within this package, please send an email to security@tidelift.com. All security vulnerabilities will be promptly addressed. You may view our full security policy here.

License

Laravel Manager is licensed under The MIT License (MIT).

For Enterprise

Available as part of the Tidelift Subscription

The maintainers of graham-campbell/manager and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.