使用AI开发Discuz! X插件之Cursor rules分享【转】

小龙

不一定准确 ，不过我使用这个rules开发了两个插件，目前使用没有问题。
希望有大佬可以完善并分享

1. 
   
2. # DiscuzX插件开发的规则
   
3. 
   
4. ### 一、全局规则
   
5. ■ **框架约束**
   
6. 1. 所有插件必须基于`/[插件标识符]`目录开发
   
7. 3. 所有PHP类文件需遵循`class_`前缀命名规范
   
8. 4. 模板文件必须存放于`template/`子目录
   
9. 
   
10. ■ **安全规范**
    
11. - 所有用户输入必须通过`dhtmlspecialchars()`过滤
    
12. - 数据库操作必须使用`DB::query()`方法
    
13. - 禁止直接操作$_GET/$_POST，需通过`getgpc()`获取参数
    
14. 
    
15. ■ **开发流程**
    
16. 1. 优先使用Discuz!X内置的38个嵌入点
    
17. 2. 页面输出必须通过`return`而非`echo`
    
18. 3. 插件配置项需存储在`$_G['cache']['plugin']`
    
19. 
    
20. 
    
21. ### 二、PHP开发规则
    
22. ■ **核心类规范
    
23. 1. 继承`discuz_plugin`基类时必须实现`install()/uninstall()`方法
    
24. 2. 模块类命名格式：`class_[模块名]_[插件标识符]`
    
25. 3. 使用`hookscript`机制时必须包含`check.inc.php`
    
26. 
    
27. ■ **缓存机制
    
28. - 加载插件缓存：`loadcache('plugin')`
    
29. - 更新配置时需调用`updatecache('plugin')`
    
30. - 临时数据存储使用`memory('set', $key, $value)`
    
31. 
    
32. ■ **API调用示例
    
33. // 用户权限验证模板
    
34. if(!$_G['uid']) {
    
35.     showmessage('not_loggedin', '', array(), array('login' => 1));
    
36. }
    
37. 
    
38. 
    
39. ### 三、模板开发规则
    
40. 
    
41. ■ **模板规范
    
42. 1. 语言变量必须通过`{lang plugin_identifier:key}`调用
    
43. 2. 循环结构需使用`<!--{loop $list $value}-->`语法
    
44. 3. 条件判断必须包含`<!--{if}-->...<!--{/if}-->`标签
    
45. 
    
46. ■ **CSS规范
    
47. - 样式类名需添加插件标识符前缀（例：.pluginid_btn）
    
48. - 优先继承`common.css`基础样式
    
49. - 移动端模板需存放在`template/touch/`
    
50. 
    
51. ### 四、Debug 日志
    
52. ```
    
53. function plugin_identifier_debug_log($msg) {
    
54.     $log_file = DISCUZ_ROOT.'data/log/plugin_identifier_debug.log';
    
55.     file_put_contents($log_file, date('Y-m-d H:i:s')." - ".$msg.PHP_EOL, FILE_APPEND);
    
56. }
    
57. ```
    
58. // 示例：记录变量值
    
59. ```
    
60. plugin_identifier_debug_log('用户ID:'.$uid.' 执行操作:'.$action);
    
61. ```
    
62. 
    
63. 
    

复制代码