Download the PHP package lite-view/framework without Composer

lite-view/framework

应用实例参考

介绍

LiteView 是一个极简的 PHP MVC 框架，专注于提供清晰、可控、无黑盒的 Web 开发体验。依赖仅有 Twig（模板引擎）和 Monolog（日志），其余核心功能全部自研。

框架的初衷和意义

• 学习价值 — 从零构建框架是理解 PHP 请求生命周期、路由、中间件管道的最佳方式，比读大型框架源码更直观
• 个人/团队定制 — 没有不需要的抽象，改起来零负担，自己的项目用着最顺手
• 可控性 — 依赖只有 Twig + Monolog，没有黑盒，出问题能从根上排查
• 够用就好 — 很多 PHP 项目就是 CRUD + 几个接口，不需要重型框架，轻量即是优势

项目状态

项目版本遵循 语义化版本号

安装

快速开始

注意：仓库根目录的 index.php 是框架功能演示示例，展示了路由、中间件、控制器和模板渲染的用法。请勿在生产环境中直接使用它，而是参考示例编写你自己的入口文件。

创建你的项目入口文件（例如 public/index.php）：

并在项目根目录创建 config.json：

本地调试

php内置服务器运行模式

• 路由模式：php -S 127.0.0.1:8888 public/index.php
  • 所有请求都路由到 index.php
  • 如果匹配到存在的目录，PATH_INFO 不存在
  • 如果 URI 中带文件后缀，PATH_INFO 不存在
• 标准模式：php -S 127.0.0.1:8888（不指定入口文件）
  • 首先尝试直接提供请求的文件（带后缀名），不存在则返回 404，不会进入 PHP 路由
  • 如果请求的是目录，则查找目录中的 index.php 或 index.html

核心功能

1. 路由系统 (LiteView\Kernel\Route)

支持静态路由、参数路由、正则约束、可选参数和路由分组。

2. 中间件管道 (LiteView\Support\Dispatcher)

基于洋葱模型的中间件管道，支持前置处理、后置处理和响应修改。

3. 请求对象 (LiteView\Kernel\Visitor)

封装请求参数、Session 用户管理和 IP 获取。

4. 视图渲染 (LiteView\Kernel\View)

支持 Twig 模板和原生 PHP 模板。

5. 异常与错误处理

框架自动捕获异常、Error 和 Fatal Error，根据 debug 配置决定输出详细错误页或友好提示。

• debug: true — 显示交互式错误页（堆栈跟踪、代码片段高亮、点击展开）
• debug: false — 只显示"系统繁忙"，同时记录日志

6. API Token (LiteView\Utils\ApiToken)

内置无状态 Token 认证，支持签名验证、过期检查和 Guard 隔离。

7. 日志系统 (LiteView\Utils\Log)

基于 Monolog 的日志通道，支持多通道、自定义 Handler 和 Processor。

8. 辅助函数

配置

在项目根目录创建 config.json，框架通过 cfg('key') 读取配置。环境配置会从 config.{app_env}.json 合并覆盖。

CORS 配置

• paths: 应用 CORS 的路径列表，["*"] 表示全部路径
• allow_origins: 允许的来源，设置具体域名时会自动启用 Access-Control-Allow-Credentials

日志配置

handlers 支持数组或可调用函数返回数组；processors 为 Monolog 处理器类名数组。框架内置 main 通道写 storage/logs/main.log。