hyperf项目必须用composer create-project hyperf/hyperf-skeleton初始化，不可git clone源码；需php≥8.0、swoole≥5.0且启用协程、opcache cli关闭、composer≥2.5，并确保git/unzip/curl等工具齐全。
直接用 Git 克隆代码再用 Composer 安装依赖，无法启动 Hyperf 项目。Hyperf 不是普通 PHP 包，必须通过 create-project 命令初始化骨架，否则缺少启动入口、容器配置、注解扫描机制等关键结构。
先确保基础环境就绪
Hyperf 要求明确且严格：
- PHP ≥ 8.0（v3.x 推荐 8.1+）
- Swoole 扩展 ≥ 5.0，且启用协程（
swoole.enable_coroutine=On） - 禁用 CLI 模式下的 OPcache：
opcache.enable_cli=Off（否则注解扫描失败） - 安装 Composer 2.5+（旧版可能解析不到 hyperf-skeleton 的最新约束）
- 确认系统有
git、unzip、curl等基础工具
正确创建项目（不是 git clone）
不要手动 git clone hyperf/hyperf 或 hyperf/hyperf-skeleton 仓库——这只会得到源码，不是可运行项目。必须用 Composer 初始化：
Volcengine Digital Human Video Generator
下载
火山引擎数字人视频生成技能。用户上传照片并提供对白或配音文案后，系统自动完成形象创建、TTS配音（性别检测与多音色匹配）及视频合成，并将结果返回。触发词：数字人、视频合成、口播视频、数字人视频。
- 执行：
composer create-project hyperf/hyperf-skeleton myapp - 该命令会自动拉取 skeleton 模板、执行
composer install、生成 autoload 映射，并校验所有 hyperf 组件版本对齐 - 进入目录：
cd myapp - 验证启动：
php bin/hyperf.php start，默认监听127.0.0.1:9501
Git 只用于管理你自己的代码
Git 在部署中只承担一个角色：版本控制你修改后的业务代码。流程如下：
- 首次部署后，运行
git init && git add . && git commit -m "init hyperf project" - 后续更新：在开发机改完代码 →
git push→ 生产机git pull -
注意：不要把
vendor/提交进 Git；每次git pull后，如 composer.lock 有变更，需补运行composer install --no-dev --no-scripts - 若仅是代码变更无依赖变动，可跳过 install，直接重启服务
生产环境守护与重启
Hyperf 是常驻进程，不能靠 php bin/hyperf.php start 手动维持：
- 推荐用 systemd：写
/etc/systemd/system/hyperf.service，指定 WorkingDirectory 为项目根目录，ExecStart 指向php bin/hyperf.php start - 或用 Supervisor：配置 program 指向同一启动命令，设置 autostart=true 和 autorestart=true
- 更新代码后，只需 reload 对应服务：
sudo systemctl reload hyperf或supervisorctl restart hyperf
