GrahamCampbell / Laravel-Manager by graham-campbell

Manager Provides Some Manager Functionality For Laravel
13,750,467
383
6
Package Data
Maintainer Username: graham-campbell
Maintainer Contact: hello@gjcampbell.co.uk (Graham Campbell)
Package Create Date: 2014-05-15
Package Last Update: 2024-03-17
Home Page: https://gjcampbell.co.uk
Language: PHP
License: MIT
Last Refreshed: 2024-04-14 15:03:03
Package Statistics
Total Downloads: 13,750,467
Monthly Downloads: 229,845
Daily Downloads: 2,139
Total Stars: 383
Total Watchers: 6
Total Forks: 38
Total Open Issues: 0

Laravel Manager

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

Installation

Laravel Manager requires PHP 7.1 - 7.3. This particular version supports Laravel 5.5 - 5.8 only.

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

$ composer require graham-campbell/manager

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