Hyperf 本身不提供真正意义上的“全局命令”，但可通过 Composer global 安装 hyperf/cli 并配置 PATH 实现全局调用；需先确认全局 bin 目录，将其加入系统 PATH，再执行 composer global require hyperf/cli，最后验证 hyperf -V 和 which hyperf（或 where hyperf）是否成功。
Hyperf 本身不提供真正意义上的“全局命令”，但你可以通过 Composer 的 global 功能，将 Hyperf 的命令行工具（如 hyperf:server 或第三方 CLI 工具）安装为系统级可用的命令。关键在于正确配置 Composer 全局 bin 目录，并将其加入系统 PATH。
确认 Composer 全局安装目录
Composer 默认把全局包的可执行文件放在 ~/.composer/vendor/bin（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\Composer\vendor\bin（Windows）。运行以下命令查看实际路径：
composer global config bin-dir --absolute
记下输出路径，后续需将其加入系统环境变量 PATH。
将全局 bin 目录加入系统 PATH
不加 PATH，即使装了也执行不了 hyperf 或 hyperf-cli 这类命令。
- Linux/macOS：在
~/.bashrc、~/.zshrc或对应 shell 配置文件末尾添加：export PATH="$HOME/.composer/vendor/bin:$PATH"，然后运行source ~/.zshrc（或对应文件）生效 - Windows：在“系统属性 → 高级 → 环境变量”中，编辑用户变量
Path，新增一行填入你上一步查到的完整 bin 路径（例如C:\Users\YourName\AppData\Roaming\Composer\vendor\bin）
安装 Hyperf 官方 CLI 工具（推荐方式）
Hyperf 官方并未发布独立的 hyperf 全局命令，但社区常用 hyperf/cli（由 Hyperf 官方维护）作为辅助开发工具。它提供项目初始化、组件管理等能力：
- 执行：
composer global require hyperf/cli - 安装后即可直接使用：
hyperf init my-project、hyperf create:command等 - 注意：该工具依赖当前 PHP 版本 ≥ 8.0，且要求已启用
pcntl和posix扩展（CLI 模式下）
验证是否配置成功
打开新终端（确保 PATH 生效），运行：
-
hyperf -V或hyperf --version（如果安装了hyperf/cli） -
which hyperf（Linux/macOS）或where hyperf（Windows）确认命令位置 - 若提示“command not found”，请检查 PATH 是否拼写错误、终端是否重启、或 Composer 是否用了自定义 home 目录（可通过
composer global config home查看）
