Manager Provides Some Manager Functionality For Laravel 5

Installs: 314 801

Dependents: 44

Stars: 52

Watchers: 4

Forks: 5

Open Issues: 0

v2.4.0 2016-04-26 14:27 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

StyleCI Status Build Status Coverage Status Quality Score Software License Latest Version

Installation

Either PHP 5.5+ or HHVM 3.6+ are required.

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

$ composer require graham-campbell/manager

Instead, you may of course manually update your require block and run composer update if you so choose:

{
    "require": {
        "graham-campbell/manager": "^2.0"
    }
}

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.

Security

If you discover a security vulnerability within this package, please send an e-mail to Graham Campbell at graham@alt-three.com. All security vulnerabilities will be promptly addressed.

License

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