本文详解 Laravel 9 中集成 Yasumi 节假日计算库的正确方式，重点解决因容器绑定语法变更导致的 Argument #2 must be of type Closure|string|null 错误，并提供可复用的服务注册、按需实例化及最佳实践建议。
本文详解 laravel 9 中集成 yasumi 节假日计算库的正确方式，重点解决因容器绑定语法变更导致的 `argument #2 must be of type closure|string|null` 错误，并提供可复用的服务注册、按需实例化及最佳实践建议。
Laravel 9 的服务容器要求 singleton() 方法的第二个参数必须是闭包（Closure）、字符串（服务类名）或 null，而原始代码中直接传入了 \Yasumi\Yasumi::create(...) 的执行结果（即一个 Yasumi 实例），违反了类型约束，因此触发了严格类型错误。
✅ 正确做法是将实例化逻辑封装为闭包，确保每次解析时动态创建（并自动缓存）单例对象。以下是推荐的 AppServiceProvider 注册方式：
<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
use Carbon\Carbon;
use Yasumi\Yasumi;
class AppServiceProvider extends ServiceProvider
{
public function register()
{
// ✅ 正确：传入闭包，延迟执行且符合容器类型约束
$this->app->singleton('yasumi', function () {
return Yasumi::create('USA', (int) Carbon::now()->year);
});
// ✅ 进阶：支持依赖注入与配置驱动（推荐）
$this->app->singleton(Yasumi::class, function ($app) {
$country = config('app.holiday_country', 'USA');
$year = (int) config('app.holiday_year', Carbon::now()->year);
return Yasumi::create($country, $year);
});
}
public function boot()
{
// 可选：发布配置文件便于管理
$this->publishes([
__DIR__.'/../config/holidays.php' => config_path('holidays.php'),
], 'config');
}
}? 关键说明与注意事项：
- 年份需为整型：Yasumi::create() 第二个参数必须是 int，使用 (int) Carbon::now()->year 比 format('Y')（返回字符串）更安全；
- 避免硬编码国家：通过 config('holidays.country') 统一管理地区，便于多环境/多租户切换；
- 按需刷新年份：Yasumi 实例默认只计算指定年份的节假日。若需跨年查询，应重新实例化（如 Yasumi::create('JP', 2025)），不建议全局复用跨年实例；
- 类型提示增强可维护性：绑定 Yasumi::class（而非字符串 'yasumi'）可启用 IDE 自动补全与类型检查；
-
安装前提：确保已通过 Composer 安装最新版 Yasumi（v4+ 支持 PHP 8.1+，兼容 Laravel 9）：
composer require azuyalabs/yasumi
? 使用示例（在控制器中）：
use Yasumi\Yasumi;
class HolidayController extends Controller
{
public function list(Request $request)
{
$yasumi = app(Yasumi::class); // 或通过构造函数注入
$holidays = $yasumi->getHolidays(); // 返回 \DateTimeImmutable 对象集合
return response()->json($holidays->map(fn($h) => [
'name' => $h->getName(),
'date' => $h->getDate()->format('Y-m-d'),
'type' => $h->getType(),
]));
}
}总结：Laravel 9 的容器契约更严格，集成第三方库时务必遵循 Closure|string|null 的绑定规范；结合配置驱动与类型安全绑定，可让 Yasumi 集成既健壮又易扩展。
