PHP具有完整的反射 API穿铆,提供了對類您单、接口、函數(shù)荞雏、方法和擴(kuò)展進(jìn)行逆向工程的能力虐秦。通過類的反射提供的能力我們能夠知道類是如何被定義的,它有什么屬性凤优、什么方法悦陋、方法都有哪些參數(shù),類文件的路徑是什么等很重要的信息筑辨。也正式因?yàn)轭惖姆瓷浜芏郟HP框架才能實(shí)現(xiàn)依賴注入自動解決類與類之間的依賴關(guān)系俺驶,這給我們平時的開發(fā)帶來了很大的方便。 本文主要是講解如何利用類的反射來實(shí)現(xiàn)依賴注入(Dependency Injection)棍辕,并不會去逐條講述PHP Reflection里的每一個API暮现,詳細(xì)的API參考信息請查閱官方文檔
再次聲明這里實(shí)現(xiàn)的依賴注入非常簡單,并不能應(yīng)用到實(shí)際開發(fā)中去楚昭,后續(xù)我計劃再開一篇來詳細(xì)介紹laravel框架的服務(wù)容器(IocContainer), 在那里再來看Laravel的服務(wù)容器是如何實(shí)現(xiàn)依賴注入的栖袋。
為了更好地理解,我們通過一個例子來看類的反射抚太,以及如何實(shí)現(xiàn)依賴注入塘幅。
下面這個類代表了坐標(biāo)系里的一個點(diǎn)昔案,有兩個屬性橫坐標(biāo)x和縱坐標(biāo)y。
/**
* Class Point
*/
class Point
{
public $x;
public $y;
/**
* Point constructor.
* @param int $x horizontal value of point's coordinate
* @param int $y vertical value of point's coordinate
*/
public function __construct($x = 0, $y = 0)
{
$this->x = $x;
$this->y = $y;
}
}
接下來這個類代表圓形晌块,可以看到在它的構(gòu)造函數(shù)里有一個參數(shù)是Point
類的爱沟,即Circle
類是依賴與Point
類的。
class Circle
{
/**
* @var int
*/
public $radius;//半徑
/**
* @var Point
*/
public $center;//圓心點(diǎn)
const PI = 3.14;
public function __construct(Point $point, $radius = 1)
{
$this->center = $point;
$this->radius = $radius;
}
//打印圓點(diǎn)的坐標(biāo)
public function printCenter()
{
printf('center coordinate is (%d, %d)', $this->center->x, $this->center->y);
}
//計算圓形的面積
public function area()
{
return 3.14 * pow($this->radius, 2);
}
}
ReflectionClass
下面我們通過反射來對Circle
這個類進(jìn)行反向工程匆背。
把Circle
類的名字傳遞給reflectionClass
來實(shí)例化一個ReflectionClass
類的對象呼伸。
$reflectionClass = new reflectionClass(Circle::class);
//返回值如下
object(ReflectionClass)#1 (1) {
["name"]=>
string(6) "Circle"
}
反射出類的常量
$reflectionClass->getConstants();
返回一個由常量名稱和值構(gòu)成的關(guān)聯(lián)數(shù)組
array(1) {
["PI"]=>
float(3.14)
}
通過反射獲取屬性
$reflectionClass->getProperties();
返回一個由ReflectionProperty對象構(gòu)成的數(shù)組
array(2) {
[0]=>
object(ReflectionProperty)#2 (2) {
["name"]=>
string(6) "radius"
["class"]=>
string(6) "Circle"
}
[1]=>
object(ReflectionProperty)#3 (2) {
["name"]=>
string(6) "center"
["class"]=>
string(6) "Circle"
}
}
反射出類中定義的方法
$reflectionClass->getMethods();
返回ReflectionMethod對象構(gòu)成的數(shù)組
array(3) {
[0]=>
object(ReflectionMethod)#2 (2) {
["name"]=>
string(11) "__construct"
["class"]=>
string(6) "Circle"
}
[1]=>
object(ReflectionMethod)#3 (2) {
["name"]=>
string(11) "printCenter"
["class"]=>
string(6) "Circle"
}
[2]=>
object(ReflectionMethod)#4 (2) {
["name"]=>
string(4) "area"
["class"]=>
string(6) "Circle"
}
}
我們還可以通過getConstructor()
來單獨(dú)獲取類的構(gòu)造方法,其返回值為一個ReflectionMethod
對象钝尸。
$constructor = $reflectionClass->getConstructor();
反射出方法的參數(shù)
$parameters = $constructor->getParameters();
其返回值為ReflectionParameter對象構(gòu)成的數(shù)組括享。
array(2) {
[0]=>
object(ReflectionParameter)#3 (1) {
["name"]=>
string(5) "point"
}
[1]=>
object(ReflectionParameter)#4 (1) {
["name"]=>
string(6) "radius"
}
}
依賴注入
好了接下來我們編寫一個名為make
的函數(shù),傳遞類名稱給make
函數(shù)返回類的對象珍促,在make
里它會幫我們注入類的依賴铃辖,即在本例中幫我們注入Point
對象給Circle
類的構(gòu)造方法。
//構(gòu)建類的對象
function make($className)
{
$reflectionClass = new ReflectionClass($className);
$constructor = $reflectionClass->getConstructor();
$parameters = $constructor->getParameters();
$dependencies = getDependencies($parameters);
return $reflectionClass->newInstanceArgs($dependencies);
}
//依賴解析
function getDependencies($parameters)
{
$dependencies = [];
foreach($parameters as $parameter) {
$dependency = $parameter->getClass();
if (is_null($dependency)) {
if($parameter->isDefaultValueAvailable()) {
$dependencies[] = $parameter->getDefaultValue();
} else {
//不是可選參數(shù)的為了簡單直接賦值為字符串0
//針對構(gòu)造方法的必須參數(shù)這個情況
//laravel是通過service provider注冊closure到IocContainer,
//在closure里可以通過return new Class($param1, $param2)來返回類的實(shí)例
//然后在make時回調(diào)這個closure即可解析出對象
//具體細(xì)節(jié)我會在另一篇文章里面描述
$dependencies[] = '0';
}
} else {
//遞歸解析出依賴類的對象
$dependencies[] = make($parameter->getClass()->name);
}
}
return $dependencies;
}
定義好make
方法后我們通過它來幫我們實(shí)例化Circle類的對象:
$circle = make('Circle');
$area = $circle->area();
/*var_dump($circle, $area);
object(Circle)#6 (2) {
["radius"]=>
int(1)
["center"]=>
object(Point)#11 (2) {
["x"]=>
int(0)
["y"]=>
int(0)
}
}
float(3.14)*/
通過上面這個實(shí)例我簡單描述了一下如何利用PHP類的反射來實(shí)現(xiàn)依賴注入猪叙,Laravel的依賴注入也是通過這個思路來實(shí)現(xiàn)的娇斩,只不過設(shè)計的更精密大量地利用了閉包回調(diào)來應(yīng)對各種復(fù)雜的依賴注入,由于還有一些東西需要梳理具體的細(xì)節(jié)我最近會在另一篇文章里來詳細(xì)描述穴翩。
本文的示例代碼的下載鏈接