hyperf启动需两步：先确认php≥8.0、swoole启用且swoole.use_shortname=off、vendor存在；再执行php bin/hyperf.php start，访问http://127.0.0.1:9501验证。
Hyperf安装完成后，启动服务其实就两步：确保环境就绪，再执行启动命令。关键不在“能不能启”，而在于“启得稳、访问通、改得快”。下面直接说清楚怎么做。
确认基础环境已就位
启动前必须检查三项：
-
PHP版本 ≥ 8.0（Hyperf v3.x 要求），运行
php -v查看； -
Swoole扩展已启用，且
swoole.use_shortname = Off已写入php.ini（否则启动报错）； -
项目依赖完整，确认
vendor/目录存在，若缺失可补运行composer install。
执行标准启动命令
进入项目根目录后，运行：
php bin/hyperf.php start
成功时终端会显示类似：
[INFO] Hyperf\HttpServer\Server: HTTP server listening at http://0.0.0.0:9501
此时用浏览器访问 http://127.0.0.1:9501 即可看到默认响应页（如返回 {"message":"Welcome to Hyperf!"}）。
Windows下特别注意端口与权限
Windows系统常见两个卡点：
- 9501端口被占用？用
netstat -ano | findstr :9501查进程ID，再用taskkill /PID xxx /F杀掉； - 权限不足或路径含中文？建议把项目放在纯英文路径下（如
D:\hyperf-app），避免 Composer 或 Swoole 加载异常。
开发阶段推荐加个热重载
每次改代码都手动 stop + start 太折腾，装个 watcher 就能自动刷新：
- 运行
composer require hyperf/watcher； - 执行
php bin/hyperf.php vendor:publish hyperf/watcher生成配置； - 改完代码后，直接用
php bin/hyperf.php server:watch启动，文件一保存，服务自动重启。
