semitexa/ssr
最新稳定版本：2026.05.11.1359
Composer 安装命令：
composer require semitexa/ssr
包简介
Semitexa SSR - Twig-based server rendering with components, layouts, assets, and deferred slots
README 文档
README
Twig-based server-side rendering with components, layout slots, theme overrides, and locale-aware URL generation.
Purpose
Renders HTML responses using Twig. Provides a component system discovered via #[AsComponent], layout slot composition via #[AsLayoutSlot], theme override support for module templates, and locale-aware URL generation.
Role in Semitexa
Depends on Twig, Locale, and Tenancy. Used by Mail, Platform WM, Platform User, Platform Settings, and Demo. Required for packages that render HTML pages.
Key Features
#[AsComponent]attribute for component discovery#[AsLayoutSlot]for layout slot registration#[AsDataProvider]and#[AsTwigExtension]for template extensionsLayoutRendererfor slot-based page composition- Theme override system (module templates overridable via
src/theme/) UrlGeneratorwith locale-aware routingModuleTemplateRegistryfor per-module template discovery- Development hot-reload support
- Automatic
robots.txtfallback with Semitexa-specific crawler hints when the project does not provide a real file - Automatic
llms.txtfallback for LLM-oriented crawl guidance when the project does not provide a real file
Deferred SSE Safety
SSR_DEFERRED_PERSISTENT_SSE=falseis the safe default. Deferred SSR streams final HTML blocks once and then closes the SSE connection.SSR_DEFERRED_PERSISTENT_SSE_REQUIRE_AUTH=trueadds a second guard for persistent mode. Even when persistent SSE is explicitly enabled, live reconnect-capable streams still require an authenticated session by default.- For public pages and demos, keep persistent SSE disabled unless you have a specific live-update use case and have capacity controls in place.
Notes
SSR is required for HTML pages. JSON-only APIs do not need this package. Layout slots use handle-based scoping: * for global, layout frame name, or specific page handle.
If a project does not provide robots.txt or public/robots.txt, SSR emits a minimal default file automatically. Set ROBOTS_SITEMAP_URL when you want the generated file to advertise a classic sitemap explicitly. SSR also exposes /sitemap.json as a crawler-oriented JSON route inventory and advertises it from the fallback robots.txt.
If a project does not provide llms.txt or public/llms.txt, SSR emits a fallback /llms.txt document that points agents to /sitemap.json, /robots.txt, and Semitexa's page-document JSON conventions.
When an SSR page route declares extra response formats via #[AsPayload(produces: ...)], Semitexa renders <link rel="alternate" type="..."> tags for the non-HTML variants of the current payload DTO. This keeps the <head> aligned with the actual route contract instead of hardcoding alternates in Twig.
统计信息
- 总下载量： 103
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 1
- 点击次数： 1
- 依赖项目数： 6
- 推荐数： 0
其他信息
- 授权协议： MIT
- 更新时间： 2026-02-23