62 lines
2.3 KiB
PHP
62 lines
2.3 KiB
PHP
<?php
|
||
// +----------------------------------------------------------------------
|
||
// | YwxApp [ WE CAN DO IT JUST THINK ]
|
||
// +----------------------------------------------------------------------
|
||
// | Copyright (c) 2026-2036 http://ywxapp.cn All rights reserved.
|
||
// +----------------------------------------------------------------------
|
||
// | Author: ywxapp<admin@ywxapp.cn>
|
||
// +----------------------------------------------------------------------
|
||
|
||
namespace ywxapp\library;
|
||
|
||
/**
|
||
* 模板（皮肤）覆盖解析器 —— Discuz 式局部覆盖核心。
|
||
*
|
||
* 解析顺序（优先级高 → 低）：
|
||
* 1. templates/<激活模板>/view/<插件>/<区域>/<页面>.html ← 用户购买的自定义皮肤
|
||
* 2. addon/<插件>/view/<区域>/<页面>.html ← 插件默认视图（回退）
|
||
*
|
||
* 激活映射见 config/template.php 的 active_map：
|
||
* ['blog' => 'myblog', '*' => 'default']；值 'default'/空 = 用插件自带视图。
|
||
*
|
||
* 决策（2026-07-28）：整站皮肤 + 局部覆盖 + 每插件独立选。
|
||
*/
|
||
class TemplateResolver
|
||
{
|
||
/**
|
||
* 解析模板覆盖页的绝对路径；未命中返回 null（交由默认视图回退）。
|
||
*
|
||
* @param string $addon 插件名，如 blog
|
||
* @param string $area 区域：frontend / backend / member
|
||
* @param string $template 模板名，如 article/detail （与控制器 fetch 入参一致）
|
||
* @return string|null
|
||
*/
|
||
public static function resolve(string $addon, string $area, string $template): ?string
|
||
{
|
||
// 空模板或跨应用语法（含 @）不处理，直接回退
|
||
if ($template === '' || strpos($template, '@') !== false) {
|
||
return null;
|
||
}
|
||
|
||
$map = config('template.active_map', []);
|
||
if (!is_array($map)) {
|
||
return null;
|
||
}
|
||
$tpl = $map[$addon] ?? ($map['*'] ?? 'default');
|
||
if (empty($tpl) || $tpl === 'default') {
|
||
return null;
|
||
}
|
||
|
||
$rel = 'templates' . DIRECTORY_SEPARATOR
|
||
. $tpl . DIRECTORY_SEPARATOR
|
||
. 'view' . DIRECTORY_SEPARATOR
|
||
. $addon . DIRECTORY_SEPARATOR
|
||
. $area . DIRECTORY_SEPARATOR
|
||
. $template . '.html';
|
||
|
||
$file = root_path() . $rel;
|
||
|
||
return is_file($file) ? $file : null;
|
||
}
|
||
}
|