PHP高階特性-反射以及工廠設計模式的結合使用[結合Laravel-Admin 程式碼實例講解]
利用反射來實現工廠模式的生產而無需創建特定的工廠類別
反射[Relfection]
什麼是Reflection
Reflection,即反射。反射提供給物件導向程式設計可以自省的能力
這麼理解有點太過於概念化,通俗地講,就是能根據事件的結果反查出原因。在程式設計中,可以根據一個被實例化的對象,反查出這個物件屬於的類別以及該類別擁有所有屬性以及方法,甚至可以讀取文件註解。這個反查的過程叫做反射【推薦學習:PHP影片教學】
PHP 提供了完整的反射API ,提供了內省類別、介面、函數、方法和擴充的能力。此外,反射 API 提供了方法來取出函數、類別和方法中的文件註解。詳細見PHP官網PHP反射簡介
Reflection能幹什麼
在上面講到的,可以使用反射來獲取一個類別的所有屬性以及方法還有註釋文檔,甚至可以取得類別屬性和方法的存取權限[protected/private],這些特性使得PHP的使用彈性得到非常大的提升。例如:
– Laravel 框架的所謂優雅所在,即容器、依賴注入、IOC 控制反轉就是依靠這些特性實現的
– Hyperf 框架的註解路由也是根據反射獲得註解來實現的
– 產生文件因為反射可以獲得類別屬性和方法的存取權限,可以掃描整個專案的所有文件再使用反射來產生文件
– 測試驅動開發利用反射取得該類別的所有方法的特性,進行測試驅動開發
– 開發插件利用反射獲取類別的內部結構的特性,實現Hook 功能,例如框架插件的實現
Reflection的優缺點
優點反射提供了對類別的反解析,從而相比原本物件導向的程式設計方式獲得了極高的靈活性,以及合理的使用能夠讓程式碼看起來更加優雅以及簡潔。原本在物件導向的程式設計方式中,使用一個類別的實例需要先 new 出一個物件再使用方法,但是使用了反射機制,只需要提供一個該類別的方法然後使用反射機制即可使用該物件或方法。 Laravel 框架正是使用了大量的反射才獲得了優雅的美譽,Swoole 的Hyperf 框架的註解路由的實現也是使用了反射
缺點同時,由於反射是類實例化的反過程,破壞了物件導向的封裝性,直接將類別的整個內部結構暴露,這就導致了反射一旦濫用,程式碼將難於管理,整個專案將非常混亂,甚至導致業務執行錯亂。尤其在大專案幾十人的團隊中,試想一下,原本的面向對象,只告訴什麼可以用,什麼不可以用,CTO寫好了底層程式碼,其他人繼承後然後使用就行,內部結構啥的其他人都不知道。一旦用上了反射,如果有一個程式設計師不小心將原本是protected 或者是private 的屬性或者方法設置成了可以訪問,其他程式設計師在不知情的情況調用了本該隱藏的數據或者方法,那將導致不可預測的災難【見下面範例程式碼】
其次,由於反射的靈活性極高,這導致了無法在IDE 中透過直接直接點擊程式碼溯源,對於新手真的是很蛋疼, Laravel 和Hyperf 都是如此
在下面的程式碼中,反射的機制直接將private 方法設定成外部可存取
#Example: <?php class Foo { private function myPrivateMethod() { return 7; } } $method = new ReflectionMethod('Foo', 'myPrivateMethod'); //该反射功能直接将原本是private权限的方法设置成可访问 $method->setAccessible(true); echo $method->invoke(new Foo); // echos "7" ?>
工廠設計模式
######################################## #####三種工廠設計模式[簡單工廠模式] [工廠模式] [抽象工廠模式]##########簡單工廠模式又稱為靜態工廠方法模式。簡單的說,就是創建物件的方式是透過一個靜態方法來實現的。在簡單工廠模式中,根據傳遞的參數來傳回不同的類別的實例######在PHP中在簡單工廠模式中,有一個抽象的產品類別【即abstract class Calculate】,這個抽象類別可以是介面/抽象類別/普通類別。這個抽象的產品類別可以衍生出多個具體的產品類別【即class CalculateAdd以及class CalculateSub】。最後再由一個具體的工廠類別【即class CalculateFactory】來取得所需的產品類別的實例################程式碼實作#######1) 抽象產品生產類別:運算抽象類別###
//生产抽象类 abstract class Calculate{ //数字A protected $number_a = null; //数字B protected $number_b = null; //设置数字A public function setNumberA( $number ){ $this->number_a = $number; } //设置数字B public function setNumberB( $number ){ $this->number_b = $number; } //获取数字A public function getNumberA(){ return $this->number_a; } //获取数字B public function getNumberB(){ return $this->number_b; } //获取计算结果【获取生产出的产品】 public function getResult(){ return null; } }
//加法运算 class CalculateAdd extends Calculate{ //获取运算结果【获取具体的产品】 public function getResult(){ return $this->number_a + $this->number_b; } } //减法运算 class CalculateSub extends Calculate{ //获取运算结果【获取具体的产品】 public function getResult(){ return $this->number_a - $this->number_b; } } //乘法 / 除法 等等其他运算【其他产品】
3) 工厂:工厂类。即用一个单独的类来创造实例化的过程,这个类就是工厂。也就是 简单工厂模式
在 php 中,实现的方式其实就一个 switch 函数或者是 php8 新出的 match 函数来实例化所需要的产品生产类
//根据运算不同实例化不同的对象 //【也就是根据所需产品,实例化对应的产品类进行生产】 //对应的实现其实就是一个switch或者php8函数新出的match函数 //下面用最新的match函数做演示 class CalculateFactory{ public static function setCalculate( $type = null ){ return match( $type ){ 'add' => (function(){ return new CalculateAdd(); })(), 'sub' => (function(){ return new CalculateSub(); })(), default => null; }; } } //具体使用 $calculate = CalculateFactory::setCalculate('add'); $calculate->setNumberA = 1; $calculate->setNumberB = 2; //计算 echo $calculate->getResult;//echo 3
总结:
简单工厂模式其实就是创建一个基类【abstract】,该类存放所有具体生产产品类的共用的代码,但是没有执行过程,然后具体生产产品的类全部继承基类再实现各自的生产过程。最后创建一个工厂类,该类用来根据传入的参数来获取所需的生产类
工厂方法模式 又称为工厂模式,属于创造型模式。在工厂模式中,工厂类的父类只负责定义公共接口,并不执行实际的生产动作。实际的生产动作则交给工厂的子类来完成。这样做将类的的实例化延迟到了工厂的子类,通过工厂的子类来完成实例化具体的产品,也就是生产
在工厂模式中,跟简单工厂模式不一样的是,有一个抽象的工厂类【即interface CalculateFactory】,可以是接口/抽象类,这个抽象的工厂类可以派生出多个具体的工厂类【即FactoryAdd以及FactorySub】
代码实现【以下代码需要用到上面的生产抽象类】
以下代码需要用到上面的生产抽象类:abstract class Calculate
以及具体的生产类,即:CalculateAdd 以及 CalculateSub。下面不再重复实现
interface CalculateFactory{ public function CreateCalculate(); } class FactoryAdd implements CalculateFactory{ public function CreateCalculate(){ return new CalculateAdd(); } } class FactorySub implements CalculateFactory{ public function CreateCalculate(){ return new CalculateSub(); } } //具体使用 //创建工厂实例 $calculateFactory = new FactoryAdd(); $add = $calculateFactory->CreateCalculate(); $add->setNumberA( 1 ); $add->setNumberB( 2 ); //计算 echo $add->getResult();//echo 3
总结:
工厂模式相比于简单工厂模式的区别在于,在简单工厂模式中,只有一个工厂来生产对应的生产对象【即CalculateFactory】。而在工厂模式中,每一个生产产对象都由自己的工厂来生产,并且这些工厂都继承自同一个接口【即 interface CalculateFactory】
抽象工厂模式 抽象工厂模式提供创建一系列相关或相互依赖对象的接口,而且无需指定它们具体的类。这么理解很抽象。通俗一点的解释就是,相比于上面的工厂模式来讲,抽象工厂模式在每个不同的工厂之上又有一个超级工厂,这个超级工厂是抽象的接口【interface】,用来生产具体的工厂
在抽象工厂模式中,有多个抽象的产品类【即abstract class Phone以及abstract class Android】,可以是接口/抽象类/普通类,每个抽象产品类可以派生出多个具体产品类【即class IPhone / class MiPhone 以及 class IOS / class Android】。一个抽象的工厂类【即interface AbstractFactory】可以派生出多个具体的工厂类【即class iPhoneFactory以及class MiFactory】,且每个具体的工厂类可以创建多个产品类的实例【即都有createPhone和createSystem】
代码实现
//抽象的产品类 abstract class Phone{} abstract class System{} //具体的产品类 class IPhone extends Phone{} class MiPhone extends Phone{} //具体的产品类 class IOS extends System{} class Android extends System{} //超级工厂 interface AbstractFactory{ public function createPhone(); public function createSystem(); } //具体的苹果工厂 class iPhoneFactory implements AbstractFactory{ //生产苹果手机 public function createPhone(){ return new IPhone(); } //生产苹果系统 public function createSystem(){ return new IOS(); } } //具体的小米工厂 class MiFactory implements AbstractFactory{ //生产小米手机 public function createPhone(){ return new MiPhone(); } //生产安卓系统 public function createSystem(){ return new Android(); } }
总结:
抽象工厂模式相比于工厂模式,抽象工厂模式提供了一个接口用来规定所需要生产的产品。每个继承于该接口的工厂都能按照指定的模式进行生产【代码中的AbstarctFactory】
以上三种工厂模式,最终都是为了将重复的代码提取出来,并且按照特定的需求场景归纳好,进行解耦和复用,以便在需要的场景中直接使用
三种模式的概括为:
简单工厂:
一个抽象产品类(可以是:接口,抽象类,普通类),可以派生出多个具体产品类
单独一个具体的工厂类
每个具体工厂类只能创建一个具体产品类的实例
工厂模式:
一个抽象产品类(可以是:接口,抽象类,普通类),可以派生出多个具体产品类
一个抽象工厂类(可以是:接口,抽象类),可以派生出多个具体工厂类
每个具体工厂类只能创建一个具体产品类的实例
抽象工厂:
多个抽象产品类(可以是:接口,抽象类,普通类),每个抽象产品类可以派生出多个具体产品类
一个抽象工厂类(可以是:接口,抽象类),可以派生出多个具体工厂类
每个具体工厂类可以创建多个具体产品类的实例
三个模式之间的区别:
简单工厂模式只有一个抽象产品类,只有一个具体的工厂类
工厂方法模式只有一个抽象产品类,而抽象工厂模式有多个抽象产品类
工厂方法模式的具体工厂类只能创建一个具体产品类的实例,而抽象工厂模式可以创建多个具体产品类的实例
工厂模式与反射的结合使用
可以利用反射的特性来实现工厂模式的生产过程,结合Laravel-admin进行举例
先看下以下的代码,需求背景:需要根据角色不同显示不同的权限按钮
<?php class TaskController extends BaseController { use HasResourceActions; /** * Make a grid builder. * * @return Grid */ protected function grid() { //Grid Columns... if (Admin::user()->inRoles([AdminUserModel::getAssignmentRole()])) { $grid->disableBatchActions(); $grid->disableEditButton(); $grid->disableCreateButton(); $grid->disableDeleteButton(); } elseif (Admin::user()->inRoles([AdminUserModel::getEvaluatorRole()])) { $grid->disableBatchActions(); $grid->disableEditButton(); $grid->disableCreateButton(); $grid->disableDeleteButton(); $grid->actions(function (Grid\Displayers\Actions $actions) { $actions->append(new ConfirmCloseTaskAction()); }); } else { $grid->disableCreateButton(); $grid->disableDeleteButton(); $grid->disableEditButton(); $grid->disableBatchActions(); $grid->disableViewButton(); $grid->disableActions(); } } }
以上的代码很明显一看就显得很臃肿。且随着业务的增加【即Controller的增加】以及角色的增加,需要写更多重复的判断以及重复的代码
解决思路:
不同的角色需要拥有的不同的权限,每个角色都可以用一个固定的方法来设置权限,这个固定的方法可以为不同的角色设置权限。这些条件刚好满足工厂模式的使用场景:即:
抽象出一个产品类来派生出多个角色的权限产品类
抽象出一个工厂类来派生出多个具体的工厂类,这些工厂类表现为对应要使用权限按钮的场景
每个具体工厂【使用权限按钮的场景】可以创建多个具体产品类【即实例化多个角色的权限产品】
代码如下【在下面的代码中,将使用反射来代替工厂的生产】
1) 抽象出一个产品类来派生出多个角色的权限产品类
<?php namespace App\GridActionFactory; use Dcat\Admin\Grid; /** * 工厂接口 */ interface GridActionInterface { //业务员角色的权限 function salesmanAction(Grid $grid); //分配员角色的权限 function assignmentAction(Grid $grid); //财务角色的权限 function financeAction(Grid $grid); //....其他角色的权限 }
2,3) 2,3两个步骤包含在一起。抽象出一个工厂类来派生出多个具体的工厂类,这些工厂类表现为对应要使用权限按钮的场景。其中,setRoleAction方法使用反射来直接生产,也就是替代了每个具体工厂类创建实例的过程
<?php namespace App\GridActionFactory; use Dcat\Admin\Admin; use Dcat\Admin\Grid; /** * 设置Action权限抽象类 */ abstract class GridActionAbstract { // abstract public static function setAction(Grid $grid, string $role); /** * 过滤角色 * * @param string $role * @return bool */ protected static function isInRoles(string $role): bool { return Admin::user()->inRoles([$role]); } /** * 调用对应的方法 * [该方法其实就是工厂模式中的工厂,专门来生产的] * [多个工厂对应的就是各个需要用到Action权限的Controller控制器] * [每个Controller控制器来生产自己的Action权限] * [这个生产是通过反射来实现] * * @param Grid $grid * @param string $role * @param string $class * @throws \ReflectionException */ protected static function setRoleAction(Grid $grid, string $role, string $class) { $r = new \ReflectionClass($class); $methodName = $role . 'Action'; if (!$r->hasMethod($methodName)) throw new \Exception('Method Not Found [ method : ' . $methodName . ' ] '); $method = $r->getMethod($methodName); $method->invoke($r->newInstance(), $grid); } }
根据以上的反射来实现实例化的过程,上面的TaskController的权限可以简化成下面的代码:
<?php namespace App\GridActionFactory; use Dcat\Admin\Grid; class TaskAction extends GridActionAbstract implements GridActionInterface { /** * @param Grid $grid * @param string $role * @throws \ReflectionException */ public static function setAction(Grid $grid, string $role) { if (!parent::isInRoles($role)) return; //通过调用父类的setRoleAction直接实现生产的过程 parent::setRoleAction($grid, $role, self::class); } //在TaskController下有需要使用权限按钮的角色 //分配员角色 public function assignmentAction(Grid $grid) { //权限按钮 $grid->showActions(); $grid->showViewButton(); } //在TaskController下有需要使用权限按钮的角色 //财务角色 public function financeAction(Grid $grid) { $grid->showActions(); $grid->showViewButton(); } //在TaskController下有需要使用权限按钮的角色 //业务员角色 public function salesmanAction(Grid $grid) { } //....其他角色 }
经过使用设计模式封装后,上面TaskController中控制权限的代码直接优化成如下:【优雅了不少~】
<?php class TaskController extends BaseController { use HasResourceActions; /** * Make a grid builder. * * @return Grid */ protected function grid() { //Grid Columns... //财务角色按钮 TaskAction::setAction($grid, AdminUserModel::getFinanceRole()); //分配员角色按钮 TaskAction::setAction($grid, AdminUserModel::getAssignmentRole()); //...其他角色按钮 /* if (Admin::user()->inRoles([AdminUserModel::getAssignmentRole()])) { $grid->disableBatchActions(); $grid->disableEditButton(); $grid->disableCreateButton(); $grid->disableDeleteButton(); } elseif (Admin::user()->inRoles([AdminUserModel::getEvaluatorRole()])) { $grid->disableBatchActions(); $grid->disableEditButton(); $grid->disableCreateButton(); $grid->disableDeleteButton(); $grid->actions(function (Grid\Displayers\Actions $actions) { $actions->append(new ConfirmCloseTaskAction()); }); } else { $grid->disableCreateButton(); $grid->disableDeleteButton(); $grid->disableEditButton(); $grid->disableBatchActions(); $grid->disableViewButton(); $grid->disableActions(); } */ } }
总结:
设计模式以及反射通常在写框架的时候用的比较多。但是在项目中,适当的使用设计模式以及反射,能够让代码更加健壮以及可扩展,也很优雅~
原文地址:http://janrs.com/?p=833
以上是PHP高階特性:反射與工廠設計模式如何結合使用的詳細內容。更多資訊請關注PHP中文網其他相關文章!