Webman无法通过composer create-project一键安装,因其官方未提供稳定版项目骨架;正确方式是从GitHub Releases下载最新dist压缩包解压后执行composer install,并运行php start.php start -d验证。

Webman 不能通过 composer create-project 一键安装,因为官方没提供可直接拉取的稳定版项目骨架 —— 这是多数人卡住的第一步。
为什么 composer create-project webman/webman 会失败或装错
官方仓库 webman/webman 是个空骨架(无 composer.json 入口),且不带 dist 包;直接运行该命令会报 Could not find package webman/webman 或退而求其次装上过时的 dev 分支。
- Webman 的正式发布方式是「下载 zip 包 + 手动初始化」,不是标准 Composer 项目模板
- 它的
composer.json在每个版本的dist包里,不在 Git 主干中 - 用
git clone拉源码再composer install可行,但默认装的是dev-master,不稳定
正确安装步骤:从 dist 包解压开始
必须跳过 create-project,改用官方发布的压缩包。这是唯一能拿到带完整依赖、已配置好 autoload 和启动逻辑的稳定环境的方式。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 访问 GitHub Releases 页面,下载最新
webman-x.x.x.zip(不是 Source code) - 解压后进入目录,运行
composer install(确保 PHP >= 7.4,且已启用ext-swoole) - 不要手动
composer require webman/webman—— 它只是个组件库,不是可运行框架 - 验证:执行
php start.php start -d,看到Webman started即成功
composer.json 里要注意的三个关键点
解压后的 composer.json 看似普通,但有三处和 Laravel/Lumen 完全不同,改错会导致启动失败或路由不生效。
-
"autoload": {"psr-4": {"app\": "app/"}—— 注意是小写app\,Windows 下大小写敏感可能出问题 -
"minimum-stability": "stable"必须存在,否则composer update可能升到dev版本破坏兼容性 -
"scripts": {"post-root-package-install": "@php -r "file_exists('.env') || copy('.env.example', '.env');""—— 这个钩子只在首次安装触发,后续改.env要自己动手
最常被忽略的是:Webman 启动依赖 start.php 文件里的 require_once 链路,一旦你移动了 vendor 或改了 BASE_PATH 常量却没同步更新 start.php,就会报 Class 'WebmanApp' not found —— 这时候别查 Composer,先盯住这个文件。

















