VSlim Overview

这页是 VSlim 面向官网和文档首页的总览页。

如果只想先回答这几个问题：

• VSlim 是什么？
• 它和 vphp、vhttpd 的关系是什么？
• 它支持哪些应用形态？
• 先看哪几页最有效？

先看这页就够了。

Product Definition

VSlim 是一个运行在 vphp 之上的极简 PHP 框架，重点不是传统 MVC 大而全，而是：

• 保持小而直接的 app model
• 给 HTTP / stream / WebSocket / MCP 提供统一应用入口
• 让 PHP 更自然地承接 AI / agent / streaming 场景

一句话定义：

• VSlim = 一个受 Slim 启发、面向 AI 场景的极简 PHP 框架

Stack Position

在整套技术栈里，它位于中间层：

• vphp
  • 语言桥和 Zend Binding
• vslim
  • 应用框架层
• vhttpd
  • transport / runtime 层

也就是说：

• vphp 解决“V 和 PHP 怎么互通”
• vslim 解决“应用怎么写”
• vhttpd 解决“应用怎么跑”

Core App Shapes

VSlim 当前最重要的应用形态有：

• VSlim\App
  • 普通 HTTP app
• VSlim\Stream\Response / VSlim\Stream\Factory
  • stream app / SSE / text stream
• VSlim\WebSocket\App
  • websocket app
• VSlim\Mcp\App
  • MCP app

如果不装扩展、只走 Composer package，对应 pure PHP 入口是：

• VPhp\VSlim\App
• VPhp\VSlim\Stream\*
• VPhp\VSlim\WebSocket\App
• VPhp\VSlim\Mcp\App

Main Capabilities

HTTP App

VSlim\App 负责：

• 路由注册
• middleware / before / after
• route group
• resource route
• dispatch / dispatch_envelope
• URL generation

入口文档：

• app/README.md

Stream

VSlim\Stream 负责：

• text stream
• SSE stream
• Ollama helper
• 和 vhttpd stream runtime 对接

入口文档：

• stream/README.md
• stream/factory.md
• stream/ollama.md

WebSocket

VSlim\WebSocket\App 负责：

• on_open
• on_message
• on_close
• room / presence helper
• 和 vhttpd websocket transport 对接

入口文档：

• websocket/README.md

MCP

VSlim\Mcp\App 负责：

• initialize
• tools
• resources
• prompts
• notification / queued message helper
• 和 vhttpd 的 MCP Streamable HTTP runtime 对接

入口文档：

• mcp/README.md
• mcp/runbook.md

Integration Boundary

VSlim 和 vhttpd 的边界现在很明确：

• VSlim
  • 定义开发者写应用的形态
• vhttpd
  • 定义 transport/runtime surface

所以：

• VSlim\App 是应用模型
• vhttpd/php-worker 负责识别和调度这些 app

对应 worker / envelope 说明：

• protocol.md
• integration/worker.md

Other Built-in Areas

除了主 app shape，VSlim 当前还有这些补充能力：

• request / response facade
  • http/request.md
  • http/response.md
• config
  • config/config.md
• container
  • container/container.md
• PSR-7 bridge / worker integration
  • psr7_bridge.md
  • integration/psr7.md
• ORM / View / Controller
  • orm.md
  • view/view.md
  • view/controller.md

Recommended Reading Order

第一次接触 VSlim：

1. 先看这页
2. 再看 README.md
3. 再看 app/README.md

如果你关注 AI / stream：

1. stream/README.md
2. mcp/README.md
3. websocket/README.md

如果你关注 vhttpd 集成：

1. protocol.md
2. integration/worker.md