前言先说清楚一件事Phpbean 是一个非常早期PHP 5 时代的轻量级 MVC 框架早已停止维护它的官方站点和官方文档如今都很难找到。网上关于它的说明文章内容高度雷同基本是同一份文本被反复转抄而且这些内容来自教程站与问答站没有经过官方文档核对。所以本文不去复述那些可疑的细节而是把它的设计思路、核心文件的职责讲清楚——这些东西从它的架构描述里是能确定的——再讲一个人在 2026 年还想用这类框架时真正该关心什么。另外要提醒一个容易踩的坑GitHub 上存在同名但完全不同的项目cheneyweb/PHPBean那是一个结合 Vue、模仿 JavaWeb 开发思想的现代轻量框架和这里说的 PHP 5 时代的 Phpbean 不是一回事搜索资料时务必区分。Phpbean 当年主打的卖点是「核心文件极少、每个文件都能单独拿出来用、对程序员完全透明」。这个定位本身没有问题——它就是一套极简的 MVC 骨架不做复杂 ORM不做花哨的约定把控制权交给开发者。本文会用它当引子讲清楚「一个 MVC 框架的最小骨架长什么样」并用当前 PHP8.0重写一遍因为原版的很多写法在新版本上已经跑不起来了。一、核心文件与各自职责根据公开可见的说明Phpbean 的核心文件及其职责大致如下文件职责对应的现代概念action.phpAction 基类所有控制器都继承它内部负责对 URL 数据的处理控制器基类 / 请求对象Router.php路由解析把 URL 映射到某个 Action 的某个方法路由器RouterView.php视图渲染模板引擎 / 响应渲染器Registry.php全局注册器存放跨层共享的对象服务容器 / DI 容器PSR-11Exception.php异常处理类继承自 PHP 内置的Exception异常处理器DB/model.php、Db/mysql.php模型层只封装 MySQL 的基本增删改查ORM / 数据映射层PDO 封装除了核心还有一批「可选库类」文件库上传下载封装、分页类JS 分页与 PHP 分页、图像处理类当年只提供了验证码、验证类可与 Zend Framework 的验证类配合。官方明确表示多表联查这类复杂 ORM没有实现理由是性能需要复杂 ORM 就换 Zend Framework 的 DB 组件。这个文件划分透露出的设计取向很清楚不做大而全。没有 ORM、没有依赖注入容器、没有事件系统共享对象靠一个静态注册器传递。控制器负责取数视图负责渲染。action.php里处理 URL 数据说明参数解析是写在控制器基类里的。每个文件可独立使用。这意味着文件之间的耦合被压得很低Router不依赖ViewView也不依赖Registry。这三条放到今天看第一条和第三条是很多「微框架」仍在坚持的思路第二条则早已演变成更严格的请求—响应分离。二、请求生命周期从一个 URL 到一段 HTML任何 MVC 框架都有一条固定的主线。Phpbean 这条主线是浏览器请求↓统一入口文件唯一能被直接访问的 PHP↓Router 解析 URL找出目标 Action 与方法↓实例化 Action读取请求参数↓Action 调用 Model 取数据↓Action 把数据交给 View 渲染↓返回 HTML 字符串给入口输出这套流程的关键在于单一入口front controllerWeb 服务器把所有请求都交给同一个 PHP 文件处理其余目录一律不允许直接访问。这样做的收益是路由、权限、日志、异常处理都只需要在一个地方做一次。下面用 PHP 8.0 把这个骨架完整重写一遍。它是单文件的可以直接保存成index.php用php -S localhost:8000在本目录起内置服务器后访问根路径验证。?php // 适用于 PHP 8.0str_starts_with、mixed 返回类型、构造器属性提升均为 8.0 特性declare(strict_types1);// ---------- 1) 注册器跨层共享对象的存放点 ----------final class Registry{/** var arraystring, mixed */private static array $items [];public static function set(string $key, mixed $value): void{self::$items[$key] $value;}public static function get(string $key): mixed{// 用 array_key_exists 而非 isset因为注册的值本身可能就是 nullif (!array_key_exists($key, self::$items)) {throw new OutOfBoundsException(未注册的服务{$key});}return self::$items[$key];}}// ---------- 2) 视图把模板渲染成字符串 ----------final class View{public function __construct(private string $dir) {}/** param arraystring, mixed $data */public function render(string $tpl, array $data []): string{// basename() 剥离目录挡住 ../../ 之类的路径穿越$file $this-dir . DIRECTORY_SEPARATOR . basename($tpl) . .php;if (!is_file($file)) {throw new RuntimeException(视图不存在{$file});}extract($data, EXTR_SKIP);ob_start();try {include $file;} catch (Throwable $e) {ob_end_clean();throw $e;}return (string) ob_get_clean();}}// ---------- 3) 路由路径映射到 Action ----------final class Router{/** var arraystring, array{class-string, string} */private array $routes [];public function add(string $path, string $actionClass, string $method index): void{$this-routes[$path] [$actionClass, $method];}public function dispatch(string $path): string{// 先丢掉 ?a1 这类查询串再去掉结尾多余的斜杠$path strtok($path, ?) ?: /;$path rtrim($path, /);if ($path ) {$path /;}if (!isset($this-routes[$path])) {http_response_code(404);return 404 Not Found;}[$class, $method] $this-routes[$path];$action new $class();return (string) $action-{$method}();}}// ---------- 4) Action 基类读取请求参数 ----------abstract class Action{/** var arraystring, mixed */protected array $params [];public function __construct(){// 这里只做演示生产环境应通过过滤函数统一清洗$this-params array_merge($_GET, $_POST);}protected function param(string $name, string $default ): string{$v $this-params[$name] ?? $default;return is_scalar($v) ? (string) $v : $default;}protected function view(string $tpl, array $data []): string{return (new View(__DIR__ . /view))-render($tpl, $data);}}// ---------- 5) 具体 Action ----------final class HomeAction extends Action{public function index(): string{Registry::set(now, new DateTimeImmutable());return $this-view(home, [title Phpbean 骨架演示,name $this-param(name, 访客),now Registry::get(now)-format(Y-m-d H:i:s),]);}}// ---------- 6) 入口 ----------$router new Router();$router-add(/, HomeAction::class, index);echo $router-dispatch($_SERVER[REQUEST_URI] ?? /);配套的视图文件view/home.php该文件要输出 HTML因此保留闭合标签!DOCTYPE htmlhtml langzh-CNheadmeta charsetutf-8title? htmlspecialchars($title, ENT_QUOTES, UTF-8) ?/title/headbodyh1你好? htmlspecialchars($name, ENT_QUOTES, UTF-8) ?/h1p服务器时间? htmlspecialchars($now, ENT_QUOTES, UTF-8) ?/p/body/html这段代码和 Phpbean 的核心结构是一一对应的Registry对应注册器Router对应路由View对应视图Action对应action.phpHomeAction就是开发者自己写的业务控制器。区别在于它用的是PHP 8 的语法——mixed返回类型、构造器属性提升、strtok()取路径——以及没有写任何 SQL。三、数据层为什么必须换掉老的封装Phpbean 的Db/mysql.php是 MySQL 封装写在 PHP 5 时代几乎可以肯定基于mysql_*系列函数。这里必须明确mysql_*系列mysql_connect()、mysql_query()、mysql_fetch_array()、mysql_real_escape_string()等在 PHP 7.0 已经被完整移除不是「废弃」是代码里调用就直接报Error: Call to undefined function。任何基于它写的数据库封装在当前 PHP 上都无法运行。现行正确写法只有两条路mysqli或PDO。推荐PDO因为它支持命名占位符、支持多种数据库、异常模式更清晰?php // 适用于 PHP 8.0$pdo new PDO(mysql:host127.0.0.1;dbnamedemo;charsetutf8mb4,dbuser,dbpass,[PDO::ATTR_ERRMODE PDO::ERRMODE_EXCEPTION, // 出错抛异常而不是静默返回 falsePDO::ATTR_DEFAULT_FETCH_MODE PDO::FETCH_ASSOC, // 默认返回关联数组PDO::ATTR_EMULATE_PREPARES false, // 使用数据库真正的预处理]);$stmt $pdo-prepare(SELECT id, title FROM articles WHERE typeid :typeid LIMIT :limit);$stmt-bindValue(:typeid, 2, PDO::PARAM_INT);$stmt-bindValue(:limit, 10, PDO::PARAM_INT);$stmt-execute();foreach ($stmt as $row) {echo $row[id], , $row[title], PHP_EOL;}几个容易错的点charsetutf8mb4要写在 DSN 里不要用SET NAMES单独发语句历史上由此产生过宽字节注入问题LIMIT的占位符必须用bindValue()并指定PDO::PARAM_INT因为execute()传数组时所有参数都按字符串处理MySQL 的LIMIT不接受字符串PDO::ATTR_EMULATE_PREPARES false让预处理真正在数据库端完成。四、从 Phpbean 到现代 PHP该换掉什么如果你手上真的有一个基于 Phpbean 的老项目逐条对照会更清楚老做法现状现代做法mysql_*封装PHP 7.0 已移除PDO / mysqli 预处理__autoload()魔术函数PHP 8.0 已移除spl_autoload_register()或 Composer 的 PSR-4 自动加载自己写Registry传递共享对象可用但难测试DI 容器PSR-11依赖从构造器注入each()遍历结果集PHP 8.0 已移除7.2 起废弃foreach数组短语法array()仍可用非错误[]ereg_*做参数校验PHP 7.0 已移除preg_match()或filter_var()split()拆分 URLPHP 7.0 已移除explode()/preg_split()/parse_url()mcrypt_*加密PHP 7.2 起废弃sodium_*PHP 7.2 内置或openssl_encrypt()值得强调的是__autoload()PHP 5 时代的框架几乎都靠它自动加载类PHP 7.2 起废弃、PHP 8.0 正式移除。老框架迁移到 PHP 8 时「类找不到」的报错十有八九是这里。常见坑点❌ 把 Phpbean 源码直接丢进 PHP 8 环境跑遇到一堆Call to undefined function mysql_connect()。✅ 先确认框架的数据层用的是mysql_*还是mysqli前者必须重写为 PDO没有兼容补丁能救。❌ 用__autoload()自动加载类。✅ PHP 8.0 已移除该函数必须改用spl_autoload_register()或者直接上 Composer 的 PSR-4 自动加载。❌ 把Registry当成万能全局变量仓库任何东西都往里面塞。✅ 注册器适合放「生命周期贯穿整个请求的服务」配置、数据库连接、日志器传数据请走参数否则单元测试根本没法替换依赖。❌ 以为「核心文件少 框架快」。✅ 文件数量与运行性能没有直接关系真正影响性能的是自动加载是否命中 Opcache、SQL 是否 N1、模板是否重复编译。❌ 在 Action 里直接echoHTML 片段。✅ Action 只返回字符串渲染交给 View否则输出缓冲被提前消耗后续header()会报「headers already sent」。❌ 看到路由参数就直接拼进 SQLWHERE id {$_GET[id]}。✅ 一律用 PDO 预处理绑定参数绝不做字符串拼接这是老框架改写时最容易带进新代码的恶习。❌ 在 GitHub 上搜到cheneyweb/PHPBean就当成同一个框架然后照着现代文档去改老代码。✅ 两者是不同的项目先确认你的项目里有没有Router.php、Registry.php这些文件形态的核心。❌ 用array_merge($_GET, $_POST)取参数后不做类型判断直接把数组当字符串用。✅ 先is_scalar()判断再转字符串如示例中的param()否则用户提交name[]x就会让(string)转换报错。总结维度要点定位PHP 5 时代的轻量 MVC 框架核心文件极少每个文件可独立使用核心文件action.php控制器基类、Router.php路由、View.php视图、Registry.php注册器、Exception.php、Db/mysql.phpMySQL 封装数据层只做基本 CRUD不做复杂 ORM原版基于mysql_*PHP 7.0 起已无法运行维护状态已停止维护官方文档难寻网上流传的说明多来自教程站转抄未经官方核对同名项目GitHub 的cheneyweb/PHPBean是另一个现代轻量框架不要混淆迁移要点数据层换 PDO、自动加载换spl_autoload_register()、共享对象换 DI 容器Phpbean 的价值不在于它的代码本身而在于它展示了一个 MVC 骨架可以有多小一个入口、一个路由、一个视图、一个注册器加起来不到两百行就足以支撑一个中小站点。今天要复刻这种极简不必去复活一个停更多年的老框架——按本文第二部分的写法用 PHP 8 的语法重写一遍几十行就能得到同样的骨架而且每一行都是当前版本能跑通、能维护的代码。