CORE FEATURES / 功能特性

请求如何执行,
应该一目了然。

核心围绕路径解析、控制器加载与方法调用工作。把通用调度留在框架,把业务决策留在应用。

↗

清晰的路径调度

URL 映射到目录、控制器与入口方法。支持多级目录,从最深候选逐级查找,让请求的执行过程直观可见。

路径解析 → 文件加载 → 方法调用
⌘

命名空间控制器

使用命名空间组织控制器,支持设置命名空间前缀和控制器后缀。

NAMESPACE
◎

核心与插件分离

核心专注调度,模板、配置、数据库、日志和 HTTP 等能力按需加载,保持应用结构清晰。

按需使用,独立组合
›_

支持显式路径调用

通过 SlightPHP::run($path) 在 CLI 或内部调用中执行控制器。非空路径使用 part 语义,不更新顶层路由状态。

CLI / 内部调用
≡

可配置的调度规则

自定义默认 zone、page、entry、分隔符、命名空间和允许的方法前缀。短 URL 可交给 Route 映射。

默认值与目录结构由您定义
◇

明确的应用边界

加载文件时验证 appDir 目录边界,仅调用可公开访问的方法。响应输出、HTTP 状态、权限和业务校验由应用负责。

轻量核心,显式控制
ONE REQUEST / 调度过程

从路径到方法的四个步骤。

01 / 取路径

确定请求来源

显式参数、setPathInfo、PATH_INFO、REQUEST_URI,依次选取可用路径。

02 / 拆路径

解析并补默认值

排除查询串,按分隔符拆分,补齐默认 zone、page 和 entry。

03 / 找控制器

由深到浅查找

逐层尝试目录,加载应用目录内的命名空间控制器。

04 / 调方法

传入请求与响应

调用公开入口方法并返回原始结果,未匹配时抛出异常,由应用处理。

请求路径与命名空间控制器。

请求文件类与方法
/home/main/entryHome/MainController.phpHome\MainController::Entry($request, $response)

框架按目录映射命名空间,默认控制器后缀为 Controller。

查看控制器代码 →
APPLICATION BOUNDARIES

清楚职责,才能用得稳妥。

框架是否自动输出响应?

不会。run() 返回控制器结果,入口负责输出、JSON 序列化和 HTTP 状态码。

HTTP 方法会自动决定控制器方法吗?

不会。Request-Type 请求头用于可配置的方法前缀,与 GET / POST 无关。6.5.2 起,候选方法名的已配置类型前缀与请求头不匹配时会被拒绝(405)。应用应明确校验请求方法与权限。

核心包含登录、权限和 CSRF 吗?

不包含。身份认证、授权、CSRF、业务校验与输出转义应由应用实现,可参考本站任务工作台。