在我的php开发生涯中,曾几何时,我也深陷“意大利面条式代码”的泥潭。项目初期,一切似乎都井井有条,但随着功能的不断迭代和模块的增多,代码库开始变得难以驾驭。我遇到的最大痛点是:
-
高耦合度: 一个类的实例化往往需要层层深入地
new出其依赖的各种对象。这意味着,如果底层的一个依赖发生变化,我可能需要修改大量上层代码,牵一发而动全身。 - 测试困难: 由于类之间存在硬编码的依赖关系,编写单元测试几乎成了不可能完成的任务。为了测试一个简单的业务逻辑,我不得不实例化整个依赖链,这不仅耗时,而且无法隔离测试,导致测试结果不可靠。
- 代码复用性差: 相同的对象在不同地方被重复实例化,或者难以共享同一个实例,造成资源浪费和逻辑不一致。
我渴望找到一种方法,能让我的PHP代码变得更加模块化、可测试,并且易于维护和扩展。我尝试过手动管理依赖,但很快发现这只会让问题变得更糟。就在我一筹莫展之际,我遇到了 Everon Factory。
救星登场:Everon Factory 与 Composer
正是 Composer 强大的包管理能力,让我轻松引入了 Everon Factory 这个组件。Everon Factory 的定位非常明确:它是一个专注于依赖注入(DI)和对象实例化的库,旨在帮助开发者构建易于测试的代码。
安装 Everon Factory 简直轻而易举,只需一个简单的 Composer 命令:
composer require everon/factory
这条命令将 Everon Factory 及其所有依赖项添加到我的项目中,让我可以立即开始使用它。
立即学习“PHP免费学习笔记(深入)”;
Everon Factory 的核心魔法
Everon Factory 解决我的痛点的核心在于其优雅的“工厂模式”和“依赖注入”实现。它通过以下几个关键概念,彻底改变了我的代码组织方式:
- Dependency Container(依赖容器): 这是所有依赖的注册中心。你可以在这里定义一个接口(或抽象类)对应的具体实现,以及如何创建这个实例。Everon Factory 允许你控制依赖是每次都创建新实例(如一个值对象),还是复用同一个实例(如一个日志器)。
-
Factory & FactoryWorker(工厂与工厂工作器): 这是对象创建的核心。
Factory负责管理多个FactoryWorker,而每个FactoryWorker则专注于构建特定类型或特定模块的对象。所有复杂的对象实例化逻辑都被封装在FactoryWorker内部,外部代码无需关心对象的创建细节。这就像一个大型工厂,有总负责人(Factory)和各个车间主管(FactoryWorker),每个主管负责生产特定的产品。 - Trait-based Dependency Injection(基于 Trait 的依赖注入): Everon Factory 提供了一种非常简洁的依赖注入方式。通过在你的类中使用一个简单的 Trait,你就可以自动将预先注册好的依赖注入到你的类中,无论是通过构造函数还是 Setter 方法。
让我们以一个常见的场景——日志记录器(Logger)为例:
假设我有一个 UserProcessor 类,它需要一个日志器来记录操作。在没有 Everon Factory 之前,我可能会这样写:
// 传统方式
class UserProcessor
{
private $logger;
public function __construct()
{
// 硬编码实例化,难以测试
$this->logger = new FileLogger('/var/log/app.log');
}
public function processUser($user)
{
$this->logger->info("Processing user: " . $user->getName());
// ...
}
}使用 Everon Factory 后,代码变得优雅而可测试:
首先,定义一个 Logger 接口和实现(假设我们有 LoggerInterface 和 FileLogger)。
然后,定义一个用于注入 Logger 的 Trait:
// Application\Modules\Logger\Dependency\Logger.php
namespace Application\Modules\Logger\Dependency;
use Psr\Log\LoggerInterface; // 假设使用 PSR-3 LoggerInterface
trait Logger
{
/**
* @var LoggerInterface
*/
protected $Logger;
public function getLogger(): LoggerInterface
{
return $this->Logger;
}
public function setLogger(LoggerInterface $Logger): void
{
$this->Logger = $Logger;
}
}接着,定义一个用于 Setter 注入的 Trait,它会使用上面定义的 Logger Trait:
// Application\Modules\Logger\Dependency\Setter\Logger.php
namespace Application\Modules\Logger\Dependency\Setter;
use Application\Modules\Logger\Dependency\Logger;
trait Logger
{
use Logger; // 引入实际的 Logger 逻辑
}现在,我的 UserProcessor 类可以这样使用:
// 使用 Everon Factory
class UserProcessor
{
use Application\Modules\Logger\Dependency\Setter\Logger; // 注入 Logger
public function processUser($user)
{
// 直接通过 getLogger() 获取,无需关心如何实例化
$this->getLogger()->info("Processing user: " . $user->getName());
// ...
}
}在应用程序的启动阶段(通常是入口文件或引导文件),我们配置 Everon Factory:
use Everon\Dependency;
use Everon\Factory;
use Application\FactoryWorker\ApplicationFactoryWorker;
use Application\Modules\Logger\FileLogger; // 假设这是你的具体Logger实现
// 1. 初始化依赖容器和工厂
$Container = new Dependency\Container();
$Factory = new Factory($Container);
// 2. 注册 FactoryWorker
$Factory->registerWorkerCallback('ApplicationFactoryWorker', function() use ($Factory) {
return $Factory->buildWorker(ApplicationFactoryWorker::class);
});
// 获取 FactoryWorker 实例
$FactoryWorker = $Factory->getWorkerByName('ApplicationFactoryWorker');
// 3. 在 FactoryWorker 中定义如何构建 Logger
// Application\FactoryWorker\ApplicationFactoryWorker.php
class ApplicationFactoryWorker extends \Everon\FactoryWorker\AbstractWorker implements \Everon\FactoryWorker\FactoryWorkerInterface
{
// ... 其他构建方法
public function buildLogger(): FileLogger
{
// 这里可以根据需要配置 Logger,例如传递日志文件路径
$Logger = new FileLogger('/var/log/app.log');
// 注入 Logger 自身的依赖(如果有的话)
$this->getFactory()->injectDependencies(FileLogger::class, $Logger);
return $Logger;
}
}
// 4. 在依赖容器中注册 Logger,并指定它由 FactoryWorker 构建
$Container->register('Logger', function () use ($FactoryWorker) {
return $FactoryWorker->buildLogger();
});
// 5. 如果 UserProcessor 需要通过容器获取,也可以注册
$Container->register('UserProcessor', function () use ($FactoryWorker, $Container) {
$userProcessor = new UserProcessor();
// 注入 UserProcessor 自身的依赖
$FactoryWorker->getFactory()->injectDependencies(UserProcessor::class, $userProcessor);
return $userProcessor;
});
// 现在,你可以从容器中获取 UserProcessor 实例,它的 Logger 已经被自动注入
$userProcessor = $Container->resolve('UserProcessor');
$userProcessor->processUser(new User('Alice'));通过这种方式,UserProcessor 不再直接创建 Logger 实例,而是通过 Everon Factory 间接获取。在测试时,我可以轻松地向容器注册一个 Mock Logger,而无需修改 UserProcessor 的代码。
实战效果与总结
自从在项目中使用 Everon Factory 后,我的开发体验得到了质的飞跃:
- 代码耦合度显著降低: 各个模块只依赖接口或抽象,具体的实现由 Factory 负责组装,模块之间实现了真正的解耦。
- 单元测试变得轻而易举: 我可以轻松地替换掉真实依赖,注入 Mock 或 Stub 对象,从而专注于测试单个类的行为,大大提高了测试效率和覆盖率。
-
代码结构更清晰: 所有的对象创建逻辑都集中在
FactoryWorker中,一目了然,方便团队协作和新成员理解项目。 - 资源管理更高效: 例如,数据库连接、缓存实例等可以作为单例注册到依赖容器中,确保整个应用共享同一个实例,避免重复创建和资源浪费。
- 支持懒加载: 只有当依赖真正被需要时,Everon Factory 才会去实例化它,这有助于提升应用的启动性能。
Everon Factory 遵循“约定优于配置”的原则,避免了繁琐的配置文件,让依赖注入的实现变得简洁而直观。如果你也曾为PHP项目的耦合和测试问题所困扰,那么我强烈推荐你尝试一下 Everon Factory。它不仅能帮助你写出更干净、更可维护的代码,更能让你重新找回编码的乐趣。










