Webman 必须通过 composer create-project 初始化骨架项目,不能用 composer install 或 require 安装;因其依赖特定目录结构(如 config/、app/、start.php),无 autoload 配置,require 仅下载源码却无法运行。

Webman 不能通过 composer install 安装——它不是普通 Composer 包,而是需要从骨架项目克隆或用 composer create-project 初始化的完整应用结构。
为什么 composer require webman/webman 会失败
Webman 不是设计为可被其他项目 require 的库,它的核心是入口文件 start.php、配置目录 config/ 和进程管理逻辑,这些依赖特定项目结构。直接 require 只会拉取源码到 vendor/,但无法启动服务,也缺少路由、中间件、HTTP 生命周期等运行支撑。
-
webman/webman包的composer.json中没有autoload配置,不提供类自动加载能力 - 其
bin/webman命令脚本依赖项目根目录下的config/和app/,不在vendor/内可访问 - 运行时报错常见为
Failed to open stream: No such file or directory in start.php
正确安装方式:用 create-project 初始化骨架
这是唯一官方支持的安装路径,本质是复制预设结构的 Git 仓库并执行 composer install 安装依赖。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer create-project webman/webman myapp(myapp是你的项目名) - 过程会自动 clone github.com/webman-php/webman 的最新稳定 tag,并执行
composer install --no-dev - 生成的目录包含:
app/(控制器)、config/(多环境配置)、public/(静态资源入口)、start.php(主启动文件) - 若需指定版本,加
@v1.6.0后缀,例如:composer create-project webman/webman myapp @v1.6.0
安装后必须立刻做的三件事
骨架项目默认处于“可运行但不可用”状态,跳过以下任一环节都可能导致启动失败或功能异常。
- 检查 PHP 版本:Webman v1.6+ 要求
PHP >= 8.0,运行php -v确认,低于则报ParseError: syntax error, unexpected token - 赋予
start.php执行权限(Linux/macOS):chmod +x start.php,否则php start.php start提示Permission denied - 运行
php start.php start -d启动守护进程前,先试运行php start.php start(前台模式),观察控制台是否输出Webman started和监听地址,避免后台静默失败
Webman 的“安装”本质是项目初始化,不是包引入;它的扩展机制(如插件)才走 composer require,但框架本体必须从骨架开始。很多人卡在第一步,就是因为试图把它当 Laravel 包一样 require。

















