Files
YwxAppThink/addon/docs/controller/DocsFrontend.php
T
yangwx 18101cf11a feat: 上线前安全加固与发布工程化;appmall 由插件迁移为独立应用
安全(P0)
- 发布包签名:新增 scripts/package_keygen.php、scripts/package_verify.php、
  ywxapp\service\PackageVerifier;FrameworkService::apply() 解压前强制验签
  (ywxapp.framework_package_verify,默认开启)
- JWT 收紧:config/jwt.php 移除公开默认密钥,JwtService::assertStrongSecret()
  校验非空 / 长度≥32 / 已知弱值;.env.production.example 键名由 JWT_SECRET_KEY 修正为 JWT_SECRET
- /api/v1/Article:免登录白名单收窄为只读接口,写操作字段白名单 + assertOwner() 越权校验
- 开发者令牌:查找接口不再回显明文、统一失败文案 + 限流
- TemplateInstaller:文件名白名单 + realpath 归一化 + 目录内断言,修复 Zip Slip;补 use ZipArchive
- 后台登录:接入验证码、失败锁定与登录限流(config/ratelimit.php)
- 缓存 / Session 驱动可由 .env 覆盖(CACHE_DRIVER / SESSION_TYPE),集群部署改 redis
- paycenter 支付日志开关改为 PAY_LOG,不再跟随 APP_DEBUG

工程化 / 交付
- 新增 CHANGELOG.md 与 .env.production.example;composer.lock 入库锁定依赖版本
- 插件离线安装 CLI 增加 --uid,后台上传安装透传 uid,付费插件授权校验可通过
- 授权拒绝文案区分「未携带 uid」与「未找到有效授权」,便于排障
- .gitignore 放行 .env.production.example / .env.addon.example / .gitattributes / public/.htaccess

结构
- appmall 由 addon/appmall 迁移为独立应用 app/appmall(市场 / 开发者中心 / 审核 / 分润)
2026-10-22 00:53:39 +08:00

95 lines
2.6 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>
// +----------------------------------------------------------------------
declare (strict_types = 1);
namespace addon\docs\controller;
use addon\docs\model\DocsProject;
use ywxapp\controller\FrontendBase;
/**
* 文档中心前台基类
*
* 统一注入站点标题与项目列表,供顶部导航与项目切换使用。
*
* @author ywxapp <admin@ywxapp.cn>
*/
class DocsFrontend extends FrontendBase
{
// 文档为公开内容,不做登录拦截
protected $noNeedLogin = ['*'];
protected $noNeedVerify = ['*'];
/**
* 插件配置
* @var array
*/
protected $docsConfig = [];
/**
* 初始化
*/
public function _initialize()
{
parent::_initialize();
$this->docsConfig = $this->loadConfig();
$this->view->assign([
'docsTitle' => $this->docsConfig['site_title'] ?? 'YwxApp 文档中心',
'projectList' => DocsProject::enabledList(),
'currentYear' => date('Y'),
// 前台路由前缀:域名绑定/独立入口模式下为空串,路径模式下为 /docs。
// 模板统一用 {$docsBase}/xxx 生成链接,两种访问方式自适应。
'docsBase' => $this->docsBase(),
]);
}
/**
* 当前访问是否已把 docs 插件"独立成站"。逻辑统一在 docs_base_url() 全局助手。
*
* @see addon/docs/common.php
*/
protected function docsBase(): string
{
return docs_base_url();
}
/**
* 模板变量赋值
*
* AddonFrontend 基类只暴露 $this->view,这里补一个代理方法,
* 使前台控制器与后台 AddonBackend 保持一致的 assign() 写法。
*
* @param string|array $name 变量名或键值数组
* @param mixed $value 变量值
* @return $this
*/
public function assign($name, $value = null)
{
$this->view->assign($name, $value);
return $this;
}
/**
* 读取插件配置
*
* @return array
*/
protected function loadConfig(): array
{
try {
$config = get_addon_config('docs');
return is_array($config) ? $config : [];
} catch (\Throwable $e) {
return [];
}
}
}