gordensong/laravel-autowire

laraval autowire 微擎

v0.9 2024-03-08 01:31 UTC

Requires

• php: ^8.0
• illuminate/container: ^7.0|^8.0|^9.0

Requires (Dev)

• orchestra/testbench: ^6.20.0
• phpunit/phpunit: ^9.5.8

MIT

README

https://gitee.com/gordensong/laravel-autowire

自动绑定类属性

1. 对于声明了 Autowire 注解的类，调用 autowire($class) 可以自动初始化声明 Autowire 注解的属性.

2. 属性自动绑定不限于单元测试使用，Repository， Service， Action 同样可以使用。

3. 注意：不要循环引用注解属性。

直接上栗子

Human

<?php

use GordenSong\Laravel\Support\Autowire;

#[Autowire]
class Human
{
	#[Autowire]
	public ?Head $head = null;
}

Head

#[Autowire]
class Head
{
	#[Autowire]
	public ?Mouth $mouth = null;
}

Mouth

class Mouth
{
	public ?Teeth $teeth = null;
}

Teeth

class Teeth
{
}

helper demo

<?php

namespace Tests;

class HelperTest extends TestCase
{
	public function test_autowire()
	{
		/** @var Human $cat */
		$cat = autowire(Human::class);

		self::assertNotNull($cat);
		self::assertNotNull($cat->head);
		self::assertNull($cat->head->mouth);
	}

	public function test_autowire_recursive()
	{
		/** @var Human $cat */
		$cat = autowire(Human::class, true);

		self::assertNotNull($cat);
		self::assertNotNull($cat->head);
		self::assertNotNull($cat->head->mouth);
		self::assertNull($cat->head->mouth->teeth);
	}
}

TestCase 自动注入

<?php

namespace Tests;

use GordenSong\Laravel\Support\Autowire;
use GordenSong\Laravel\Support\AutowireTrait;

class NotRecursiveAutowireTest extends TestCase
{
	// 第一步：引用 Trait use AutowireTrait
	use AutowireTrait;

	protected function setUp(): void
	{
		parent::setUp();

		// 第二步： $this->autowireProperties(); 绑定值为空的属性
		$this->autowireProperties(); // 不递归绑定
	}

	// 第三步：使用注解
	#[Autowire]
	private ?Human $human = null;

	public function test_auto_wire_head_is_null()
	{
		self::assertNotNull($this->human);
		self::assertNull($this->human->head);
	}
}

TestCase 递归注入

<?php

namespace Tests;

use GordenSong\Laravel\Support\Autowire;
use GordenSong\Laravel\Support\AutowireTrait;

class RecursiveAutowireTest extends TestCase
{
	use AutowireTrait; // 1.

	protected function setUp(): void
	{
		parent::setUp();

		$this->autowireProperties(true); // 2. 递归绑定
	}

	// 3. 使用注解
	#[Autowire]
	private ?Human $cat = null;

	public function test_auto_wire_head_is_null()
	{
		self::assertNotNull($this->cat);
		self::assertNotNull($this->cat->head);
		self::assertNotNull($this->cat->head->mouth);
		self::assertNull($this->cat->head->mouth->teeth); // teeth 未加注解
	}
}

安装

composer require --dev gordensong/laravel-autowire

说明

Function

1. autowire($class) 等价于 app($class)

function autowire(string $class, bool $recursive = false) : mixed

2. 自动绑定属性值, 对象内部使用。

function autowireProperties(object $object, bool $recursive = false)