Webman 必须通过 composer create-project 初始化骨架项目，不能用 composer install 或 require 安装；因其依赖特定目录结构（如 config/、app/、start.php），无 autoload 配置，require 仅下载源码却无法运行。
Webman 不能通过
安装——它不是普通 Composer 包，而是需要从骨架项目克隆或用
初始化的完整应用结构。
为什么
会失败
Webman 不是设计为可被其他项目
的库，它的核心是入口文件
、配置目录
和进程管理逻辑，这些依赖特定项目结构。直接
只会拉取源码到
，但无法启动服务，也缺少路由、中间件、HTTP 生命周期等运行支撑。
包的
中没有
配置，不提供类自动加载能力
其
命令脚本依赖项目根目录下的
和
，不在
内可访问
运行时报错常见为
正确安装方式：用
初始化骨架
这是唯一官方支持的安装路径，本质是复制预设结构的 Git 仓库并执行
安装依赖。
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
运行
（
是你的项目名）
过程会自动 clone
github.com/webman-php/webman
的最新稳定 tag，并执行
生成的目录包含：
（控制器）、
（多环境配置）、
（静态资源入口）、
（主启动文件）
若需指定版本，加
后缀，例如：
安装后必须立刻做的三件事
骨架项目默认处于“可运行但不可用”状态，跳过以下任一环节都可能导致启动失败或功能异常。
检查 PHP 版本：Webman v1.6+ 要求
，运行
确认，低于则报
赋予
执行权限（Linux/macOS）：
，否则
提示
运行
启动守护进程前，先试运行
（前台模式），观察控制台是否输出
和监听地址，避免后台静默失败
Webman 的“安装”本质是项目初始化，不是包引入；它的扩展机制（如插件）才走
，但框架本体必须从骨架开始。很多人卡在第一步，就是因为试图把它当 Laravel 包一样
。
composer installcomposer create-projectcomposer require webman/webmanrequirestart.phpconfig/requirevendor/webman/webmancomposer.jsonautoloadbin/webmanconfig/app/vendor/Failed to open stream: No such file or directory in start.phpcreate-projectcomposer installcomposer create-project webman/webman myappmyappcomposer install --no-devapp/config/public/start.php@v1.6.0composer create-project webman/webman myapp @v1.6.0PHP >= 8.0php -vParseError: syntax error, unexpected tokenstart.phpchmod +x start.phpphp start.php startPermission deniedphp start.php start -dphp start.php startWebman startedcomposer requirerequire