76 lines
2.9 KiB
PHP
76 lines
2.9 KiB
PHP
<?php
|
||
/**
|
||
* 视图渲染。
|
||
*
|
||
* 流程：render() 把数据展开 → 把「本页模板文件路径 / 当前页标识 / 标题」交给
|
||
* layout.php → layout 在正文位置 require 本页模板。
|
||
*/
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App;
|
||
|
||
final class View
|
||
{
|
||
public static function render(string $tpl, array $data = [], string $page = ''): void
|
||
{
|
||
$file = dirname(__DIR__) . '/templates/' . $tpl . '.php';
|
||
if (!is_file($file)) {
|
||
throw new \RuntimeException('模板不存在：' . $tpl);
|
||
}
|
||
|
||
$tplFile = $file;
|
||
$pageKey = $page ?: $tpl;
|
||
$pageTitle = $data['title'] ?? '岁月家';
|
||
$extraHead = $data['extraHead'] ?? '';
|
||
|
||
extract($data, EXTR_SKIP);
|
||
require dirname(__DIR__) . '/templates/layout.php';
|
||
}
|
||
|
||
/**
|
||
* 只渲染**模板本身**，返回字符串（不套 layout）。
|
||
*
|
||
* 🔴 v40（用户 2026-10-10）：「观影详情里面的编辑按钮应该也是弹出的，和新增是一样的，
|
||
* 编辑完以后，页面动态更新。」
|
||
* ⇒ AJAX 保存**校验失败**时，必须把这同一个表单**原样重画**回去
|
||
* （字段报错、`old()` 回填、附件/海报面板全靠模板自己产出）。
|
||
* 如果不重画而只回一个错误文案，用户就会看到"值全丢了、红字也没有"——
|
||
* 与整页路径（`View::render`）行为不一致，那种"两条路各说各话"的 bug 最难查。
|
||
*
|
||
* ⚠️ 与 `render()` 的唯一区别：不 require layout.php。
|
||
* layout 会输出 `<html>`/顶栏，塞进一段 innerHTML 里会直接坏掉结构。
|
||
*/
|
||
public static function renderPartial(string $tpl, array $data = []): string
|
||
{
|
||
$file = dirname(__DIR__) . '/templates/' . $tpl . '.php';
|
||
if (!is_file($file)) {
|
||
throw new \RuntimeException('模板不存在：' . $tpl);
|
||
}
|
||
extract($data, EXTR_SKIP);
|
||
ob_start();
|
||
require $file;
|
||
return (string)ob_get_clean();
|
||
}
|
||
|
||
/**
|
||
* 独立的整页（登录、安装、错误），不套顶栏 —— 但**仍然要是一份完整 HTML**。
|
||
*
|
||
* ⚠️ 曾经这里直接 require $file，输出里没有 doctype / head / CSS，
|
||
* 浏览器拿默认样式渲染，登录页看起来就像「完全没样式」。
|
||
* 现在统一套一层 layout-bare.php（无顶栏的最小骨架）。
|
||
*/
|
||
public static function renderBare(string $tpl, array $data = []): void
|
||
{
|
||
$file = dirname(__DIR__) . '/templates/' . $tpl . '.php';
|
||
if (!is_file($file)) {
|
||
throw new \RuntimeException('模板不存在：' . $tpl);
|
||
}
|
||
$tplFile = $file;
|
||
$pageTitle = $data['title'] ?? '岁月家';
|
||
$extraHead = $data['extraHead'] ?? '';
|
||
extract($data, EXTR_SKIP);
|
||
require dirname(__DIR__) . '/templates/layout-bare.php';
|
||
}
|
||
}
|