๐
Autowire for Laravel
Autowire and configure using PHP 8 Attributes in Laravel.
Installation
Via Composer
composer require jeroen-g/autowire
You will need the configuration file to change where it should look:
php artisan vendor:publish --tag=autowire.config
Usage
Autowiring
Are you tired of binding abstract interfaces to concrete classes all the time?
$this-app->bind(HelloInterface::class, WorldClass::class);
Use the PHP 8 attribute of this package to autowire any of your interfaces:
namespace App\Contracts;
use JeroenG\Autowire\Attribute\Autowire;
#[Autowire]
interface HelloInterface
{
public function hello(): string;
}
The class that implements that interface does not need any changes:
namespace App;
use App\Contracts\HelloInterface;
class WorldClass implements HelloInterface
{
public function hello(): string
{
return 'world';
}
}
The Autowire package will crawl through the classes and bind the abstract interface to the concrete class. If there already is a binding in the container it will skip the autowiring.
Configure
Personally I like injection of dependencies over resolving them using make() helpers. However, that means writing binding definitions such as:
$this->app->when($x)->needs($y)->give($z);
Not anymore with the Configure attribute! Here is the WorldClass example again:
namespace App;
use App\Contracts\HelloInterface;
#[Configure(['$message' => 'world'])]
class WorldClass
{
private $message;
public function __construct($message)
{
$this->message = $message;
}
}
In this example message is a simple string. However, it can be a reference to a configuration value or other class too! The notations of config and service definitions is the same as used in Symfony.
// Will get the value set in config/app.php
#[Configure(['$message' => '%app.message%'])]
// Will inject an instance of the Message class
#[Configure(['$message' => '@App\Domain\Message'])]
// When you have multiple constructor arguments
#[Configure(['$message' => '%app.message%', '$logger' => '@Psr\Log\LoggerInterface'])]
Caching
The autowiring and configuration can be cached with the command php artisan autowire:cache. In a similar fashion it can be cleared with php artisan autowire:clear. Keep in mind that caching means that it won't crawl all the classes and changes to the annotations will not be loaded.
Configuration
The package's configuration can be found in config/autowire.php. It should contain the list of directories where Autowire should look for both interfaces and implementations.
Changelog
Please see the changelog for more information on what has changed recently.
Credits
License
MIT. Please see the license file for more information.
![Allow to use #[Autowire] on implemntations](https://avatars.githubusercontent.com/u/10086991?v=4)
2 Oct 2, 2022
68 Aug 11, 2022
220 Oct 28, 2022
15 Oct 29, 2022
4 Sep 15, 2022
27 Nov 20, 2022
23 Dec 30, 2022
33 Nov 6, 2022
7 Nov 15, 2022
46 Dec 17, 2022
6.9k Jan 2, 2023
49 Jun 22, 2022
31 Dec 18, 2022
10 Aug 29, 2022
3.6k Dec 27, 2022
2 Aug 18, 2022
757 Dec 26, 2022
24 Nov 17, 2022
251 Dec 29, 2022