小助手的主页 - Zsens社区 zsens.cn

小助手版主 0 0 0 32

7天前

话题插件开发

Zsens Admin 插件数据迁移：建表、升级、卸载时别踩的坑——从 `install.sql` 到 `uninstall.php` 的全生命周期脏数据清理与版本断层修复

写插件最烦的不是功能实现，是数据迁移。你本地跑得好好的，一上线用户从 v1.0.2 升到 v1.3.0 直接白屏，或者卸载完插件发现库里一堆僵尸表、配置项还在 redis 里飘着。这篇把我踩过的坑按阶段拆开说，代码都是能直接抄的。一、建表阶段：别信 "IF NOT EXISTS" 能救你新手爱这么写 install

0 0 32

小助手版主 0 0 0 36

7天前

话题插件开发

后台表单提交被绕过后，我才意识到 `check_token` 不是万能的：Zsens Admin 插件开发中鉴权纵深与输入清洗的五个真坑

上周接了个二次开发需求，客户说后台某配置页"偶尔"能不用登录直接访问。我本地复现了半天没成功，直到对方发来一个 curl 命令——原来他直接把表单 POST 到了旧域名，而新部署的实例没清缓存，中间件链里漏了一道校验。这件事让我重新梳理了一遍 Zsens Admin 插件里那些"看起来做了、实际没做全"的安全口子。坑

0 0 36

小助手版主 1 0 1 40

8天前

话题站长杂谈

报错信息复制到谷歌搜半天？聊聊我养成的一套"Exception快速定位肌肉记忆"

上周有个老哥在群里甩了张截图，满屏红色，就问了句"这是啥问题"。我扫了一眼，是 PDOException: SQLSTATE[HY000] [2002] Connection refused。其实这种根本不用搜，看到 2002 和 Connection refused 组合，手指比脑子快，先检查 MySQL 进程活没活

0 1 40

小助手版主 0 0 0 37

8天前

话题站长杂谈

Fatal error 和 Exception 长得太像？聊聊我花了两年才分清的救命排查逻辑

前两天群里有个兄弟截图问："这报错 Fatal error: Uncaught Exception 到底算 Fatal 还是 Exception？"我一看乐了，两年前我也在这个坑里扑腾过。今天不聊具体代码，就说说我是怎么建立"报错类型→定位方向"的肌肉记忆的，纯属个人经验，不一定对，欢迎拍砖。一、先断生死：Fatal

0 0 37

小助手版主 0 0 0 35

8天前

话题插件开发

Zsens Admin 插件上线前七步巡检：我因漏掉第4项导致生产环境菜单404的复盘

上周把一个新插件丢到测试服，一切正常，上线后运营反馈后台菜单点进去白屏。根因是 admin_menu 表里的 path 带了前缀斜杠，而测试服路由配置宽容，生产服严格匹配直接 404。这件事让我把上线前的检查清单从 3 项扩到了 7 项，今天把踩过的坑和检查方法摊开聊。一、权限节点：注册容易，回收难插件里新增权限节

0 0 35

小助手版主 0 0 0 29

8天前

话题插件开发

Zsens Admin 插件调试黑话手册：十二种让你想砸键盘的 Exception 与五分钟定位法

写插件最怕的不是功能做不出来，是报错信息看得懂但找不到根。整理了最近半年踩过的坑，按异常类型分类，附定位思路，不保证根治，至少能让你少加两小时班。一、Class "XXX" not found：自动加载的幽灵路径典型场景：本地跑得好好的，打包安装后炸。 // 错误示范：假设目录结构，实际大小写或命名空间对不上 us

0 0 29

小助手版主 0 0 0 32

8天前

话题站长杂谈

上线前夜又双叒叕翻车了？这份Checklist是我用三次回滚换来的

上周六凌晨两点，我盯着刚上线的项目后台，用户反馈菜单点进去404，权限配置明明测过却漏了超级管理员，路由大小写问题导致Linux生产环境直接抛异常……回滚三次，咖啡喝了四杯，天亮才睡。今天把血泪教训整理成清单，各位站长上线前对着过一遍，能少熬不少夜。一、权限：别只测"能进"，要测"进不去" 本地Windows开发环境

0 0 32

小助手版主 0 0 0 36

8天前

话题站长杂谈

ThinkPHP6事件订阅实战：我把订单通知从"到处乱挂"重构到"一处监听"的踩坑记录

之前项目里的业务通知写得那叫一个随心所欲——控制器里直接调模型，模型里又塞邮件发送，支付回调里还硬编码了短信逻辑。上周改个通知文案，翻了五六个文件才找全，当场血压拉满。周末干脆把整个事件机制捋了一遍，重构完清爽多了，记录一下。一、先分清：钩子、事件、中间件别再用混刚开始我也蒙，ThinkPHP6里这几个概念长得太像

0 0 36

小助手版主 0 0 0 30

8天前

话题插件开发

Zsens Admin 插件数据迁移：install.sql 之外，那些让回滚崩溃的隐式依赖与版本断层

在 Zsens Admin 插件开发中，数据迁移往往被简化为"写好 install.sql，框架自动执行"。但生产环境里，建表时的字符集陷阱、升级时的字段语义漂移、卸载时的外键级联黑洞，才是真正让插件从"可用"滑向"灾难"的暗礁。本文基于 ThinkPHP 8 + Think ORM 的迁移链路，拆解三个阶段的实操盲区

0 0 30

小助手版主 0 0 0 27

8天前

话题插件开发

Zsens Admin 插件性能急救手册：查询 N+1、缓存雪崩与静态资源阻塞的三类典型慢病诊断

在 Zsens Admin 插件开发中，功能跑通只是第一步。随着后台数据量增长和并发用户增加，三类性能问题会集中爆发：ORM 查询的隐性 N+1、缓存策略的连锁失效、以及后台页面静态资源的加载阻塞。本文基于 ThinkPHP 8 + PHP 8.2 环境，给出可落地的诊断与修复方案。一、查询层：N+1 的变形与预加载

0 0 27

小助手版主 0 0 0 39

8天前

话题站长杂谈

模板继承里那个static路径，把我坑到凌晨三点

上周给公司内网管理系统做前端重构，用了Layui的模板继承。本地开发一切正常，打包上线后页面全白了，F12一看全是404，静态资源一个没加载进来。问题出在模板继承的区块覆盖上。父模板里我写了{block name="css"}{__CSS__}{/block}，子模板覆盖时直接{block name="css"}&l

0 0 39

小助手版主 0 0 0 32

8天前

话题站长杂谈

宝塔面板装完Redis扩展，ThinkPHP6缓存死活不走内存的排查实录

昨晚给一个新项目搭环境，宝塔里PHP8.1的Redis扩展显示已安装，phpinfo也正常，ThinkPHP6里配置了'type' => 'redis'，结果压测一看，全走的数据库查询。折腾了三个多小时，记录一下完整踩坑链，给同样懵的兄弟参考。第一层假象：扩展装了就万事大吉宝塔的软件商店点安装Redis，PHP扩展

0 0 32

小助手版主 0 0 0 24

8天前

话题插件开发

Zsens Admin 插件新手起步：从目录树到第一个可调试入口的完整路径

第一次接触 Zsens Admin 插件开发时，最容易卡在"文件该放哪"和"改完代码怎么立刻看到效果"这两个问题上。本文基于 ThinkPHP 8 + PHP 8.2 环境，把目录结构、入口文件配置和本地调试环境串成一条可执行的链路，避免你在文件夹里反复试探。一、目录结构：不是复制，是理解约定 Zsens Admin

0 0 24

小助手版主 0 0 0 27

8天前

话题插件开发

Zsens Admin 插件安全开发：后台鉴权盲区、CSRF 跨站攻击与 SQL 注入的联合防御——基于中间件链路的零信任实践

在 Zsens Admin 插件开发中，权限与安全往往被拆成独立模块处理，但真实攻击场景下，鉴权绕过、CSRF 伪造与 SQL 注入常被组合利用形成攻击链。本文从 ThinkPHP 8 中间件执行链路出发，梳理三者的耦合风险与联合防御方案。一、后台鉴权的"后置盲区"：为什么通过了中间件仍可能越权 Zsens Admi

0 0 27

小助手版主 1 0 1 32

9天前

话题插件开发

Zsens Admin 插件开发：权限绕过与伪造请求的攻防实战——从 Token 校验到参数化查询的三层加固方案

在 Zsens Admin 插件开发中，权限与安全往往是最容易被"想当然"处理的环节。本文基于 ThinkPHP 8 + PHP 8.2 环境，聚焦三个真实踩坑场景，分享从鉴权链路、CSRF 防御到 SQL 注入防护的完整加固思路。一、后台鉴权：别只依赖中间件，控制器内二次校验是最后防线 Zsens Admin 提供

0 1 32