Base Controller

WNCMS 的 base controller 是一个精简的基础，集中处理视图解析。在大多数情况下，您不应该直接扩展此类别。相反，应扩展其子 controllers，它们封装了特定层级的行为。

我应该扩展哪个 Controller？

对于 Backend（后台 CRUD）

扩展： Wncms\Http\Controllers\Backend\BackendController

用于： 后台 CRUD 页面、设定页面、列表和编辑 models。

原因： 提供 model 命名、cache tag 辅助方法和统一的 backend CRUD 模式。

命名空间： App\Http\Controllers\Backend\... 或套件 backend controllers。

视图： backend.{models}.* Blade 视图。

对于 Frontend（公开主题页面）

扩展： Wncms\Http\Controllers\Frontend\FrontendController

用于： 由当前主题渲染的公开网站页面（首页、文章、页面、标签等）。

原因： 主题感知渲染、网站上下文和 frontend 惯例。

命名空间： App\Http\Controllers\Frontend\... 或套件 frontend controllers。

视图： frontend.* Blade 视图，透过主题解析。

对于 API（JSON 端点）

扩展： Wncms\Http\Controllers\Api\ApiController

用于： 供外部应用程式（Vue、Next.js、mobile）使用的 JSON APIs。

原因： API 相关问题，如认证、标准化回应/resources。

命名空间： App\Http\Controllers\Api\V1\... 或套件 API controllers。

回应： JSON 回应 / API resources。

何时直接扩展 Base Class

• 建立新的 controller 层级（例如，专用子系统），其他 controllers 将会扩展它。
• 建立共享抽象，在分层之前添加横切辅助方法（罕见）。

如果您不符合这些情况，请使用上述子 controller。

共用多站点辅助方法

Base Controller 现在提供可复用的多站点辅助方法，backend/frontend controllers 可共用相同的网站解析与能力检测逻辑：

protected function supportsWncmsMultisite(string $modelClass): bool
protected function resolveModelWebsiteIds(string $modelClass, array|string|int|null $websiteIds = null): array
protected function syncModelWebsites($model, array $websiteIds): void

• supportsWncmsMultisite()：
  • 透过 getWebsiteMode() 与 bindWebsites() 检查模型是否支援
  • 将 single 与 multi 视为已启用多站点模式
• resolveModelWebsiteIds()：
  • 支援阵列或逗号分隔字串输入网站 ID
  • 在 single 模式只取第一个网站 ID
  • 在 multi 模式使用全部网站 ID
  • 当 gss('multi_website') 关闭时，回退到当前网站 ID
  • 只保留存在的网站 ID
• syncModelWebsites()：
  • 按模型网站模式同步绑定
  • single：绑定第一个网站
  • multi：先清空旧绑定，再绑定当前选择

下一步

• Backend：参见 Backend Controller
• Frontend：参见 Frontend Controller
• API：参见 API Controller
• 脚手架：参见 Create a Controller