composer init 不感知 PHP Fiber 特性，需手动指定 "php": ">=8.1.0" 并验证 class_exists('Fiber') 为 true 才算支持；它不生成代码、不校验运行时能力，仅初始化依赖声明。
composer init 本身不感知 PHP Fiber 特性
直接运行 composer init 不会自动检测或配置对 PHP 8.1 Fiber 的支持——因为 Fiber 是语言级特性，不是 Composer 管理的依赖。Composer 只负责声明和加载依赖，它不参与运行时能力校验或代码生成。你看到的“支持 Fiber”实际取决于：PHP 版本是否 ≥ 8.1、代码里是否用 new Fiber()、是否在 composer.json 中正确约束 php 版本。
生成骨架时必须显式锁死 PHP 版本
如果不指定 PHP 版本，composer init 默认写入 "php": "^7.2" 或更宽松的范围，这会导致后续在 PHP 8.1+ 环境中启用 Fiber 的代码无法被低版本环境兼容，也容易掩盖运行时错误。
- 交互式执行时，在 “Package name” 后遇到 “PHP version” 提示，**不要直接回车**，输入：
>=8.1.0 - 或跳过交互，用命令行一次性生成：
composer init --name=myapp/fiber-demo --require="php:>=8.1.0" --no-interaction
- 生成后立即检查
composer.json中的require.php字段，确认是类似"php": ">=8.1.0"，而非"^8.1"（后者允许 8.2+，但若用了 8.2 新增的 Fiber 方法如Fiber::getCurrent()，8.1 就会报错）
init 后需手动补全 Fiber 使用前提
composer init 不创建任何 PHP 文件，更不会帮你写 Fiber 示例代码。要真正“支持 Fiber”，你还得确保：
- 项目根目录下有至少一个入口文件（如
index.php），里面能安全调用new Fiber()—— 这要求 CLI SAPI 或支持协程的 Web 服务器（如 Swoole），Apache/NGINX + FPM 默认不支持 Fiber 跨请求生命周期 - 如果要用
Fiber::suspend()/Fiber::resume()，必须在 Fiber 实例内调用，外部直接调用会抛出Fatal error: Uncaught Error: Call to a member function suspend() on null - 避免在 Fiber 内使用未声明为
fibersafe的扩展函数（如某些 PDO 操作、cURL 同步调用），否则可能死锁；建议搭配ext-parallel或swoole做异步替代
验证 Fiber 是否可用比 init 更关键
很多人以为 composer init 完成就算“支持 Fiber”，其实最关键的一步是本地验证。在项目目录下运行：
立即学习“PHP免费学习笔记（深入）”；
php -r "var_dump(class_exists('Fiber'));"
输出 bool(true) 才算过关。如果为 false，常见原因有：
- 系统默认 PHP 版本低于 8.1（
php -v查看） - CLI 和 Web SAPI 使用不同 php.ini，而 CLI 的
php.ini中禁用了zend_extension=opcache.so（Fiber 依赖 OPcache 启用） - Docker 环境中 base 镜像没升级到 8.1+，比如仍用
php:8.0-cli
Fiber 不是开箱即用的功能，它依赖 PHP 编译选项（--enable-fiber）和运行时环境一致性，init 只是起点，漏掉任一环都跑不起来。
