league/period安装失败主因是php版本或扩展不匹配；需确认php -v≥7.4/8.0、date扩展启用，并按php版本选v4.x或v5.x，v5.x仅支持datetimeimmutable且默认左闭右开区间。
直接装不上 league/period，大概率不是 Composer 问题，而是 PHP 版本或扩展没对上。
Composer 安装失败的典型报错和原因
运行 composer require league/period 报错时，最常见的是这两类：
-
Your requirements could not be resolved to an installable set of packages.—— 项目里已有的依赖（比如symfony/console或phpunit）锁死了低版本，而league/period要求 PHP ≥ 8.0 或依赖较新的psr/http-message -
Class 'DateTimeImmutable' not found或类似提示 —— 实际是 PHP 缺少date扩展（极少见），但更可能是 PHP 版本低于 5.5（DateTimeImmutable是 5.5 加入的），而league/period最低要求 PHP 7.4（v4.x）或 PHP 8.0（v5.x）
确认 PHP 环境是否满足前提
别跳过这步。很多“装不上”其实是本地 PHP 和 composer 调用的不是同一个环境：
- 终端执行
php -v，确认输出是PHP 7.4或更高（v4.x 支持到 7.4，v5.x 起只支持 8.0+） - 执行
php -m | grep date，确保date扩展已启用 - 如果用 XAMPP/MAMP/WAMP，注意它们自带的 PHP 可能和系统 PATH 里的不一致；优先用
which php和which composer对齐路径
安装时指定兼容版本（v4.x 还是 v5.x？）
league/period v5.x（当前最新）默认要求 PHP 8.0+，如果你还在用 PHP 7.4，必须显式指定 v4：
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- PHP 7.4 项目：用
composer require league/period:^4.5 - PHP 8.0+ 项目：直接
composer require league/period（会装 v5.x） - v4 和 v5 的核心 API 几乎一致，但 v5 移除了对
DateTime的支持，只接受DateTimeImmutable；传参时若用new \DateTime()会直接报错
示例对比：
use League\Period\Period;
// ✅ v4 和 v5 都支持
$period = new Period(
new DateTimeImmutable('2023-01-01'),
new DateTimeImmutable('2023-12-31')
);
// ❌ v5 不接受 DateTime（会抛 TypeError）
$period = new Period(new DateTime('2023-01-01'), new DateTime('2023-12-31'));
引入后时间区间计算的最小可用写法
装完别急着写复杂逻辑，先跑通一个基础比较：
- 确保文件顶部有
use League\Period\Period; - 区间重叠判断：用
$a->intersects($b)，不是contains（那是看某点是否在区间内） - 注意边界：默认是左闭右开（
[start, end)），比如new Period('2023-01-01', '2023-01-02')只包含 1 月 1 日全天，不含 1 月 2 日 00:00:00 - 如果要改成左闭右闭，得用
Period::fromString('2023-01-01 to 2023-01-02', Period::BOUNDARY_INCLUDE_ALL)
边界处理和 PHP 版本约束是实际用起来最容易卡住的地方，尤其当老项目升级、或多人协作时环境不统一。别假设“装上了就万事大吉”，先验证 DateTimeImmutable 行为和区间语义是否符合预期。
