thinkphp 8.0 中应通过 final 类、私有构造/克隆/反序列化、静态私有实例属性及严格 null 判断的 getinstance() 实现线程安全单例；配置须解耦（推荐容器注入），并通过服务绑定与 __invoke 支持全局调用。
在 ThinkPHP 8.0 项目中，需要让日期格式化、字符串截取、数组递归合并等通用工具方法在整个请求生命周期内复用同一实例，避免重复初始化开销，同时确保配置可隔离、方法调用无副作用、后续能统一注入日志或监控逻辑。
定义单例工具类骨架
创建 app/common/Tool.php，声明私有构造、禁止克隆、禁用反序列化——这三步缺一不可，否则外部可通过 new、clone 或 unserialize 绕过单例控制。
使用 【final class Tool】 修饰类名，防止被继承后破坏单例契约；构造函数必须设为 private，否则 new Tool() 就能绕过 getInstance。
在类顶部声明私有静态属性 【private static ?Tool $instance = null;】，PHP 8+ 的联合类型 ?Tool 明确表达“可能为空”，比传统写法更安全。
实现懒加载实例获取
编写 public static function getInstance() 方法，判断 $instance 是否为 null，是则 new self() 初始化，否则直接返回已有实例。
这一步必须用 === null 严格比较，不能用 == null 或 !self::$instance，否则当实例内部属性为 false/0/'' 时可能误判为未初始化。
getInstance() 方法不接收任何参数，所有配置项应通过独立的 setConfig() 方法注入，否则每次调用 getInstance('utf8') 都会触发新实例创建，彻底失去单例意义。
注入可变配置与方法扩展
方法一：在 getInstance 后链式调用 setConfig()
Tool::getInstance()->setConfig(['date_format' => 'Y-m-d H:i:s'])->formatDate(time());
方法二：在构造函数中预留配置参数，但需配合工厂类解耦——直接在 __construct 中塞配置会导致单例无法复用不同配置场景，例如测试环境用 mock 时间戳、生产环境用真实时间。
方法三（推荐）：将配置交由容器管理，定义 app/config/tool.php 配置文件，再在 getInstance 内部通过 think\Container::pull('config')->get('tool') 获取，使单例类本身无状态、可测试、可替换。
绑定到服务容器并全局可用
第一步：在 app/provider/AppServiceProvider.php 的 register() 方法中添加
$this->app->bind('tool', function ($app) { return Tool::getInstance(); });
第二步：在 app/common/Tool.php 中增加 public function __invoke() 方法，返回 $this，这样就能在控制器中直接写 $this->tool->formatDate($time)。
第三步：打开 app/middleware/CheckRequest.php（或其他中间件），在 handle() 开头插入 Tool::getInstance();，强制在请求早期完成单例初始化，避免多处并发调用 getInstance() 时因 PHP 请求生命周期特性产生多个实例。
