README

Server-side routing bridge for Blackcube CMS. Maps dcore slugs to PHP handlers, injects SEO metadata, handles errors — all through PSR-15 middleware.

👁 License
👁 Packagist Version

Where ssr sits

┌────────────────────────────┐
│ your app (Yii/Slim/Laravel) │
└──────────────┬─────────────┘
 ↓
 ┌──────────────────────┐
 │ ssr ← you are here │
 │ routing, SEO, handlers│
 └───────────┬──────────┘
 ↓
 ┌──────────┐
 │ dcore │
 │ (data) │
 └──────────┘
 ↓
 DB

Quickstart

composer require blackcube/ssr

#[RoutingHandler(route: 'page')]
final class PageHandler implements RequestHandlerInterface
{
 public function __construct(
 private readonly Content $content,
 private readonly WebViewRenderer $viewRenderer,
 ) {}

 public function handle(ServerRequestInterface $request): ResponseInterface
 {
 return $this->viewRenderer->render('page', ['content' => $this->content]);
 }
}

Documentation

• Installation — requirements, configuration, DI wiring
• Routing — middleware, handler registry, attributes, dispatch modes
• SEO — Xeo injection, meta tags, Open Graph, Twitter Cards, JSON-LD
• Errors — Yii fallback handler, throwable factory, error handler registration
• Locale — YiiLocaleManager (set/get/resolve, session-backed, supported via Language)
• Integration — PSR and Yii integration, Quill helper

License

BSD-3-Clause. See LICENSE.md.