Manager Provides Some Manager Functionality For Laravel 5

Installs: 94 307

Dependents: 26

Stars: 33

Watchers: 4

Forks: 3

Language: PHP

v2.2.0 2015-06-26 17:39 UTC

README

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

Laravel Manager

Build Status Coverage Status Quality Score Software License Latest Version

Installation

PHP 5.5+ or HHVM 3.6+, and Composer are required.

To get the latest version of Laravel Manager, simply add the following line to the require block of your composer.json file:

"graham-campbell/manager": "~2.2"

You'll then need to run composer install or composer update to download it and have the autoloader updated.

Once Laravel Manager is 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 Laravel Flysystem and Laravel Dropbox.

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().

For a simple example of a manager class implementing these methods, see my DropboxManager class from my Laravel Dropbox package.

Further Information

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

License

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