Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/imanghafoori1/laravel-smart-facades
Strategy design pattern in laravel, the easiest way.
https://github.com/imanghafoori1/laravel-smart-facades
laravel-facade laravel-framework laravel-package strategy-design-pattern strategy-pattern
Last synced: 6 days ago
JSON representation
Strategy design pattern in laravel, the easiest way.
- Host: GitHub
- URL: https://github.com/imanghafoori1/laravel-smart-facades
- Owner: imanghafoori1
- License: mit
- Created: 2019-01-20T06:42:49.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-01-03T01:40:14.000Z (9 months ago)
- Last Synced: 2024-09-19T16:11:48.453Z (14 days ago)
- Topics: laravel-facade, laravel-framework, laravel-package, strategy-design-pattern, strategy-pattern
- Language: PHP
- Homepage:
- Size: 101 KB
- Stars: 121
- Watchers: 5
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🍄 Laravel Smart Facades 🍄
The "Strategy pattern" in Laravel, made easy
by adding some features on top of Laravel facades.
Built with :heart: for every smart Laravel developer
[](https://scrutinizer-ci.com/g/imanghafoori1/laravel-smart-facades/?branch=master)
[](LICENSE.md)
[](https://github.com/imanghafoori1/laravel-smart-facades/actions/workflows/check_imports.yml)
[](https://github.styleci.io/repos/166631643)
## :flashlight: Installation:
```
composer require imanghafoori/laravel-smart-facades
```
### ⚡️ No need to have getFacadeAccessor()
#### Before:
```php
use Illuminate\Support\Facades\Facade;
class MyFacade extends Facade
{
protected static function getFacadeAccessor() // <--- normal facade
{
return 'some_key';
}
}
```
#### After:
```php
use Imanghafoori\SmartFacades\Facade;
class MyFacade extends Facade
{
// <--- smart facade
}
```
### ⚡️ Setting the default driver by `shouldProxyTo($class)`:
Instead of binding a string to a concrete class with an IOC container, you can choose the low-level implementation class like this:
```php
public function register() // <-- in a service provider
{
if ($someCondition) {
MyFacade::shouldProxyTo( SomeDriver::class );
} else {
MyFacade::shouldProxyTo( SomeOtherDriver::class );
}
}
```
You can proxy to any abstract string (or closure) bound on the IoC container.
Note: If you invoke it twice, it will override:
```php
MyFacade::shouldProxyTo( DriverClass1::class );
MyFacade::shouldProxyTo( DriverClass2::class ); // <--- This wins!
```
### ⚡️ Using Non-default Driver:
If you want to change the driver at call site:
```php
MyFacade::withDriver(nonDefaultDriver::class)::myMethod();
```
### ⚡️ Method Hooks:
You can introduce some code "Before" and "after" a method call, remotely: (like event listeners on eloquent models)
Here we have told the system evenever the `MyFacade::findUser($id)` method was called in the system, to perform a log.
### ⚡️ Choosing the driver, based on parameters value:
For example, let's say you want your facade to use an SMS-based driver by default, but if the text is very long (more than 200 chars) it should use an email driver.
You can do it like this:
#### :wrench: Automatic method injection when calling a method through a facade.
This the adds ability to enjoy automatic method injection when calling methods on POPOs (Plain Old Php Objects) WITHOUT any performance hit when you do not need it.
#### 🐙 Example:
```php
class Foo { ... }
class Bar
{
// This has dependencies: "Foo", "LoggerInterface"
public function m1 (Foo $foo, LoggerInterface $logger, string $msg)
{
}
}
```
Calling `Bar` through a Facade:
Before:
```php
MyFacade::m1(resolve(Foo::class), resolve(LoggerInterface::class), 'hey there !');
```
After:
```php
// This will work and $foo, $logger would be auto-injected for us.
MyFacade::m1('hey there !'); // normal facade
// or you may want to provide some dependencies yourself:
\Facades\Bar::m1(new Foo('hey man!'), 'hey there !'); //Now only the Logger is injected
```
--------------------
### :raising_hand: Contributing:
If you find an issue or have a better way to do something, feel free to open an issue or a pull request.
### :star: Your Stars Make Us Do More :star:
As always if you found this package useful and you want to encourage us to maintain and work on it. Just press the star button to declare your willingness.
## More from the author:
### Laravel Microscope
:gem: Automatically find bugs before they bite.
- https://github.com/imanghafoori1/laravel-microscope
-----------------
### Laravel Widgetize
:gem: A minimal yet powerful package to give a better structure and caching opportunity for your Laravel apps.
- https://github.com/imanghafoori1/laravel-widgetize
----------------
It's not I am smarter or something, I just stay with the problems longer.
"Albert Einstein"