问题背景：通用逻辑文件的管理挑战
在复杂的CodeIgniter4项目中，开发者经常会创建一些包含广泛功能、不直接对应数据库表的类。这些类可能用于：
这些通用功能通常以“库”（Libraries）的形式存在，并被多个控制器甚至其他库频繁调用。然而，如果每次调用都创建一个新的库实例，将会造成不必要的内存开销。理想情况下，我们希望这些库能够以单例模式运行，即只创建一个实例并在整个请求生命周期内共享。虽然模型（Models）可以通过工厂模式实现共享实例，但上述通用逻辑并不直接管理数据，将其定义为模型并不恰当。
解决方案：利用CodeIgniter4的服务模式
CodeIgniter4提供了一种优雅的解决方案来管理应用程序的全局依赖和共享实例——即服务（Services）。通过将这些通用库注册为服务，我们可以确保在需要时获取到它们的共享实例，而不是每次都创建新的对象。
1. 定义通用库
首先，我们需要定义包含通用逻辑的库文件。例如，一个名为 ExampleLibrary 的库：
// app/Libraries/ExampleLibrary.php
namespace App\Libraries;
class ExampleLibrary
{
public function __construct()
{
// 库的初始化逻辑
// error_log('ExampleLibrary instance created.'); // 用于测试实例是否每次都创建
}
public function performDataAnalysis(array $data): array
{
// 执行数据分析和格式化
return array_map(fn($item) => strtoupper($item), $data);
}
public function getMessage(string $entityType): string
{
// 根据实体类型返回消息
return "Message for " . $entityType;
}
}2. 创建自定义服务
接下来，在 app/Config/Services.php 文件中，添加一个静态方法来定义我们的服务。这个方法将负责实例化 ExampleLibrary 并管理其共享状态。
// app/Config/Services.php
namespace Config;
use CodeIgniter\Config\BaseService;
use App\Libraries\ExampleLibrary; // 引入我们定义的库
class Services extends BaseService
{
/**
* 提供 ExampleLibrary 的共享实例。
*
* @param boolean $getShared 是否获取共享实例。
* @return ExampleLibrary
*/
public static function exampleService($getShared = true)
{
if ($getShared) {
// 如果请求共享实例，则通过 getSharedInstance 方法获取或创建单例。
return static::getSharedInstance('exampleService');
}
// 否则，每次都返回一个新的实例（通常不推荐用于此场景）。
return new ExampleLibrary();
}
}代码解析：
- public static function exampleService($getShared = true): 这是我们定义的服务方法。$getShared 参数允许我们控制是否获取共享实例。
- static::getSharedInstance('exampleService'): 这是核心。getSharedInstance 方法会检查 exampleService 这个键是否已经存在于内部的共享实例池中。如果存在，它会返回现有的实例；如果不存在，它会调用当前服务方法（即 exampleService 自身，但 $getShared 会被设置为 false 来创建新实例），并将新创建的实例存储起来，然后返回。这样就实现了单例模式。
3. 在控制器或其它库中调用共享实例
现在，我们可以在任何控制器或其它库中，通过 service() 辅助函数轻松获取 ExampleLibrary 的共享实例。
// app/Controllers/Home.php
namespace App\Controllers;
use App\Libraries\ExampleLibrary; // 可以选择性引入，但不是必须的
class Home extends BaseController
{
protected $exampleLibrary;
public function __construct()
{
// 在构造函数中获取共享实例
$this->exampleLibrary = service('exampleService');
}
public function index()
{
$data = ['item1', 'item2', 'item3'];
$processedData = $this->exampleLibrary->performDataAnalysis($data);
$message = $this->exampleLibrary->getMessage('user');
echo "Processed Data: " . implode(', ', $processedData) . "
";
echo "Message: " . $message . "
";
// 再次获取，验证是否是同一个实例
$anotherInstance = service('exampleService');
// var_dump($this->exampleLibrary === $anotherInstance); // 应为 true
}
}在上述控制器中，$this->exampleLibrary = service('exampleService'); 会确保 $this->exampleLibrary 始终引用 ExampleLibrary 的唯一共享实例。无论 service('exampleService') 被调用多少次，只要 $getShared 参数为 true（默认值），它都会返回同一个对象。
核心优势与适用场景
- 内存优化： 避免了重复实例化大型或频繁使用的对象，显著减少了内存占用。
- 性能提升： 减少了对象创建的开销，尤其是在高并发场景下。
- 代码一致性： 确保所有模块访问的都是同一个实例，避免了因不同实例状态不同而导致的问题。
- 集中管理： app/Config/Services.php 成为管理应用核心依赖和共享资源的中心点，提高了可维护性。
-
适用场景：
- 通用工具类： 如日志记录器、缓存管理器、配置读取器等。
- 复杂计算引擎： 避免重复加载数据或初始化复杂状态。
- 第三方库的封装： 如果第三方库本身不提供单例模式，可以通过服务进行封装。
注意事项
- 避免滥用： 并非所有类都需要作为共享服务。只有那些频繁使用、内部状态无关紧要或需要全局一致性的类才适合。
- 状态管理： 如果共享服务内部维护了可变状态，需要特别注意并发访问和状态同步问题。通常建议共享服务是无状态的，或者其状态管理是线程安全的。
- 依赖注入： 尽管 service() 辅助函数很方便，但在更复杂的场景中，可以考虑使用 CodeIgniter4 的依赖注入容器来管理服务的生命周期和依赖关系，这提供了更大的灵活性和可测试性。
- 命名规范： 为服务方法选择清晰、描述性的名称，以便于理解其用途。
总结
通过CodeIgniter4的服务模式，我们可以高效地管理那些不属于模型但又被广泛使用的通用逻辑库。利用 getSharedInstance 方法，可以轻松实现这些库的共享实例，从而有效优化内存使用，提高应用性能，并确保整个应用中这些功能的统一性和一致性。这是一个在构建高性能、可维护CodeIgniter4应用时非常重要的设计模式。
