实践指南
Web 应用
在稳定 1.0 网络栈中选择言枢、言访、言标、言页或言讯,并明确生产安全责任。
言序核心不内置 Web 框架。稳定生态把职责拆成可独立选择的层:言枢组织服务端应用、 路由与中间件;言访调用外部 HTTP/HTTPS 服务;言标提供自动转义模板;言页构造安全 HTML;言讯提供受预算约束的 HTTP/1.1 服务端协议对象。
建议顺序:
- 阅读Web 与网络总览,确认目标是否在当前支持范围内。
- 常规服务端应用从言枢和言标开始。
- 调用外部 API 或编写可注入的客户端测试时使用言访。
- 只有需要底层节点或协议对象时,再进入言页或言讯。
- 沿言枢博客运行页面、JSON、言据 API、静态文件和测试。
- 发布前逐项检查安全与生产边界。
安装时锁定稳定发布线,不依赖默认分支:
yanbao add web --version '^1.0'
yanbao add request --version '^1.0'
yanbao install言枢 1.0 最低需要言序 1.1.12;言访 1.0 最低需要 1.1.11。言枢会传递锁定言据 1.2、 言页 1.0、言讯 1.0 和言访 1.0,普通服务端项目无需重复声明这些内部依赖。
这些库不替代 TLS 终止、最终 CSP、身份认证、业务授权、限流或生产级反向代理。网络 外连、监听和文件权限必须在顶层项目清单中按实际目标显式声明;Mock 和无端口测试成功 也不能证明 DNS、TLS、代理或真实超时配置正确。