webman 不能通过 composer install 安装,必须用 composer create-project 创建项目骨架;因其是框架级结构,非普通库,直接 require 会导致类找不到、入口缺失、配置未加载等问题。

Webman 不能通过 composer install 安装——它不是普通 Composer 包,而是需要通过 composer create-project 创建全新项目骨架。
为什么 composer require webman/webman 会失败
Webman 是一个框架级项目结构,不是可直接引入的库。它的入口、配置、目录约定(如 app/、config/、public/)都依赖完整初始化。直接 require 会导致:
-
Class 'Webman\App' not found—— 缺少自动加载规则和启动文件 -
public/index.php不存在 —— 无法响应 HTTP 请求 -
config/bootstrap.php缺失 —— 核心服务未注册
正确安装方式:用 create-project 拉取官方骨架
运行以下命令(确保已安装 Composer 且 PHP ≥ 7.4):
composer create-project webman/webman myapp
其中 myapp 是你的项目目录名。该命令会:
- 从
https://github.com/webman-php/webman克隆最新稳定版骨架 - 自动执行
composer install安装依赖(含workerman/workerman、psr/log等) - 生成标准目录结构,包括
start.php启动脚本
完成后进入目录并启动:
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
cd myapp<br>php start.php start
常见卡点与绕过方法
国内用户常遇到 GitHub 下载慢或超时:
- 临时换镜像源:
composer config -g repo.packagist composer https://packagist.phpcomposer.com(注意该镜像已停用,推荐改用https://packagist.org+git clone手动拉取) - 跳过 Git 克隆,直接下载 ZIP:
curl -L https://github.com/webman-php/webman/archive/refs/tags/v1.5.0.tar.gz | tar -xzf - --strip-components=1 -C myapp,再进目录运行composer install - 如果提示
ext-swoole或ext-openssl缺失,先确认 PHP 扩展已启用:php -m | grep -E 'swoole|openssl'
安装后第一件事:检查 start.php 和端口绑定
Webman 默认监听 0.0.0.0:8787,但开发时建议改用 127.0.0.1:8787 避免暴露本地服务。编辑 start.php 中的 $worker->listen 行:
$worker->listen('http://127.0.0.1:8787');
另外注意:start.php 不是 Web 入口,不要把它放到 public/ 下;它是 CLI 启动脚本,必须在项目根目录下执行。
Webman 的核心逻辑藏在 app/ 和 config/ 里,而不是 vendor/ —— 这意味着你几乎不会去动 vendor/webman/webman,所有定制都在项目目录内完成。










