HyperfComposer全局配置设置教程

本文详细讲解了如何通过 Composer 全局安装和环境变量配置，让 Hyperf 的命令行工具（如 `hyperf/cli`）真正实现系统级全局调用——虽然 Hyperf 本身不内置全局命令，但只需三步：确认 Composer 全局 bin 目录、将其正确添加至系统 PATH、再执行 `composer global require hyperf/cli`，即可在任意路径下直接运行 `hyperf init`、`hyperf -V` 等命令，大幅提升开发效率；文末还贴心提供了各平台 PATH 配置方法、PHP 环境要求及常见验证技巧，帮你一次性解决“command not found”难题。

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 查看）

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~