update v5.3.0

Author: evoxwht

README.md

@@ -43,30 +43,10 @@ CRMEB开源商城系统PHP版
 
 ### 📋 更新说明
 
-```
-v5.2.0 更新说明【更新时间2023年09月13日】
-1、后台ui 从iview更新成element-ui
-2、数据统计查询计算优化，统计放在对应的模块中
-3、优化站点配置，分类对应的配置项
-4、客服关键字自动回复，添加自动回复，用户在出发关键字时，系统自动回复聊天
-5、批量发货功能，导出发货单，填写对应的物流数据，点击批量发货然后导入，即可批量写入发货状态
-6、商品起购数量，后台可设置起购件数，移动端默认显示最低的购买件数
-7、提现手续费设置，填写提现手续费百分比，范围0-100，0为无提现手续费，例：设置10%提现，提现100元，到账90元，10元手续费
-8、签到功能，增加提醒，增加连续签到奖励，累计签到奖励
-9、支持微信服务商支付
-10、优化小程序和公众号登录流程
-11、代码生成二期
-
-v5.1.0 更新说明【更新时间2023年07月10日】
-1、增加一号通商家寄件功能
-2、增加京东云，华为云，天翼云云存储
-3、增加虚拟评价可选规格
-4、增加自定义跳转小程序
-5、增加移动端订单管理查看物流信息
-6、增加一定端退款订单详情显示退款理由以及图片
-7、增加后台订单详情展示用户的发票申请记录信息，及开票信息/状态
-8、增加使用的优惠券是否退回开关，商品成功退款后，退回/不退回使用的优惠券
-```
+
+点击查看<a href="https://doc.crmeb.com/single/v53/12202" target="_blank">更新记录</a>
+
+
 ### 用心做开源，我们也很需要你的鼓励！右上角Star🌟，等你点亮！
 
 ---
@@ -163,11 +143,10 @@ So~~想要用CRMEB开源商城系统做公益项目的朋友，可以来免费
 
 ---
 ###  📞 CRMEB互动
-#### 技术娱乐！代码写累了？那就歇会吧！扫码让你开心一刻！
-![输入图片说明](readme/pic/小剧场.jpg)
+#### CRMEB开源技术交流群
+#### 扫码进群可领取开源版接口文档、产品功能清单、高清UI设计图、思维脑图！
+![输入图片说明](readme/pic/开源群.jpg)
 #### 技术社区！找方法、提bug、看官方消息、拿活跃大奖！都在 <a href="https://www.crmeb.com/ask" target="_blank">CRMEB 技术社区</a> 应有尽有
-#### 技术交流！<a href="https://pd.qq.com/s/1v2yb4e0p" target="_blank">CRMEB开源商城系统开发QQ频道已开启，点击加入一起交流学习</a>
-![输入图片说明](readme/pic/联系我们.jpg)
 
 ---
 

crmeb/.version

@@ -1,5 +1,5 @@
-version=CRMEB-KY v5.2.1
-version_code=521
+version=CRMEB-KY v5.3.0
+version_code=530
 platform=github
 app_id=ze7x9rxsv09l6pvsyo
 app_key=fuF7U9zaybLa5gageVQzxtxQMFnvU2OI

crmeb/README.md

@@ -103,6 +103,165 @@ php think workerman start --d
   - restart: 重启
 - --d : 后台执行
 
+## 开发规范
+#### 命名规范
+ThinkPHP6.0遵循PSR-2命名规范和PSR-4自动加载规范，并且注意如下规范:
+
+1. 目录和文件
+2. 目录使用小写+下划线；
+3. 类库、函数文件统一以.php为后缀；
+4. 类的文件名均以命名空间定义，并且命名空间的路径和类库文件所在路径一致；
+5. 类（包含接口和Trait）文件采用驼峰法命名（首字母大写），其它文件采用小写+下划线命名；
+6. 类名（包括接口和Trait）和文件名保持一致，统一采用驼峰法命名（首字母大写）；
+
+#### 函数和类、属性命名
+
+1. 类的命名采用驼峰法（首字母大写），例如 User、UserType；
+2. common函数的命名使用小写字母和下划线（小写字母开头）的方式，例如 get_client_ip；
+3. 控制器里面的方法使用小写字母和下划线（小写字母开头）的方式，例如 get_client_ip
+4. 方法的命名使用驼峰法（首字母小写），例如 getUserName；
+5. 属性的命名使用驼峰法（首字母小写），例如 tableName、instance；
+6. 特例：以双下划线__打头的函数或方法作为魔术方法，例如 __call 和 __autoload；
+
+#### 常量和配置
+1. 常量以大写字母和下划线命名，例如 APP_PATH；
+2. 配置参数以小写字母和下划线命名，例如 url_route_on 和url_convert；
+3. 环境变量定义使用大写字母和下划线命名，例如APP_DEBUG；
+
+#### 数据表和字段
+1. 数据表和字段采用小写加下划线方式命名，并注意字段名不要以下划线开头，例如 think_user 表和 user_name字段，不建议使用驼峰和中文作为数据表及字段命名
+
+注意：请理解并尽量遵循以上命名规范，可以减少在开发过程中出现不必要的错误
+
+#### 语法规范
+1. 尽量使用php7新语法
+2. 每个 namespace 命名空间声明语句和 use 声明语句块后面，必须 插入一个空白行
+3. 类的开始花括号（{） 必须 写在类声明后自成一行，结束花括号（}）也 必须 写在类主体后自成一行
+4. 方法的开始花括号（{） 必须 写在函数声明后自成一行，结束花括号（}）也 必须 写在函数主体后自成一行。
+5. 类的属性和方法 必须 添加访问修饰符（private、protected 以及 public），abstract 以及 final 必须 声明在访问修饰符之前，而 static 必须 声明在访问修饰符之后
+6. 控制结构的关键字后 必须 要有一个空格符，而调用方法或函数时则 一定不可 有
+7. 控制结构的开始花括号（{） 必须 写在声明的同一行，而结束花括号（}） 必须 写在主体后自成一行
+8. 纯 PHP 代码文件 必须 省略最后的 ?> 结束标签
+9. 所有方法，类，控制器类，都 必须 添加访问修饰符
+    ~~~
+
+    /**
+     * 中文注释
+     * @param string $str 声明类型
+     * @param array $arr
+     * @return bool
+     */
+    public function action(string $str, array $arr)
+    {
+         return true;
+    }
+    ~~~
+10. 参数列表中，每个逗号后面 必须 要有一个空格，而逗号前面 一定不可 有空格
+    ~~~
+     function foo($arg1, &$arg2, $arg3 = [])
+     {
+            // method body
+     }
+    ~~~
+11. 参数 可以 分列成多行，此时包括第一个参数在内的每个参数都 尽量 单独成行。
+    ~~~
+    <?php
+    $foo->bar(
+        $longArgument,
+        $longerArgument,
+        $muchLongerArgument
+    );
+    ~~~
+12. 标准的 if 结构如下代码所示，请留意「括号」、「空格」以及「花括号」的位置，
+    注意 else 和 elseif 都与前面的结束花括号在同一行
+    ~~~
+    <?php
+    if ($expr1) {
+        // if body
+    } elseif ($expr2) {
+        // elseif body
+    } else {
+        // else body;
+    }
+    ~~~
+13. 赋值等号前后必须加空格符
+    ~~~
+    <?php
+    $arr = [];
+    ~~~
+
+
+#### PHP 7.1+ 常用新语法
+
+1. 三元运算符
+   ~~~
+   <?php
+
+   $arr = ['crmeb'=>true];
+   之前
+   echo isset($arr['crmeb']) ? $arr['crmeb'] : '';
+   之后
+   echo $arr['crmeb'] ?? '';
+   ~~~
+2.  define() 定义常量数组
+   ~~~
+   <?php
+    define('ARR',['a','b']);
+   ~~~
+3.  命名空间优化
+   ~~~
+    <?php
+    //PHP7之前语法
+    use FooLibrary\Bar\Baz\ClassA;
+    use FooLibrary\Bar\Baz\ClassB;
+    // PHP7新语法写法
+    use FooLibrary\Bar\Baz\{ ClassA, ClassB};
+
+   ~~~
+#### CRMEB PRO规范
+ 1. 所有数据验证放在模块下的 validates 目录下
+ 2. JSON返回使用父级 AuthController类中的success 和 fail
+ 3. 错误判断抛出异常，由一个错误类统一控制输出
+    ~~~
+    <?php
+
+        throw new AuthException('错误信息',400);
+    ~~~
+ 4. 错误码和错误提示语应该统一管理，方便切换多语言
+ 5. 数据库操作使用模型类，不能使用Db::table()
+ 6. 获取表单数据使用 app\Request
+    ~~~
+    <?php
+    use app\Request;
+
+
+    public function index(Request $request) {
+
+        //获取提交的数据，并以二维数组形式返回
+        $arr = $request->getMore([
+            'name',
+            'nickname'
+        ]);
+        //获取提交的数据，并以二维数组形式返回并附加默认值
+        $arr = $request->getMore([
+           ['name','123'],
+           ['nickname','0']
+        ]);
+        //获取提交的数据,并以一维数组形式返回并附加默认值
+        [$name, $nickname] = $request->getMore([
+           ['name','123'],
+           ['nickname','0']
+        ],true);
+
+    }
+    ~~~
+ 7. 所有控制器类命令和表名对应，按照大驼峰命名规范
+ 8. 所有文件夹命名按照小写字母加下划线定义
+ 9. 所有属性名，变量名尽量遵守小驼峰命名规范
+ 10. 复杂逻辑，多状态应适当添加行内注释
+ 11. 模型里只能写关于搜索条件语句,查出数据得组合书写在services层进行处理,services创建命令:php make:services api@user/User
+
+
 ## 文档
 
 [使用手册](https://doc.crmeb.com)

crmeb/app/README.md

@@ -0,0 +1,29 @@
+在ThinkPHP框架中，"app"目录是用于存放应用程序的核心代码和资源的目录。它是整个应用程序的主要工作目录，包含了应用的业务逻辑、控制器、模型、视图以及其他相关组件。
+
+具体来说，"app"目录通常包含以下几个子目录和文件：
+
+app/adminapi：该目录包含管理端应用的控制器文件，用于处理用户请求、业务逻辑和数据交互等操作。
+
+app/api：该目录包含用户端应用的控制器文件，用于处理用户请求、业务逻辑和数据交互等操作。
+
+app/dao： 该目录包含数据访问对象（DAO）的类文件，用于封装数据访问操作，提供统一的数据访问接口。
+
+app/http：该目录包含HTTP请求和响应跨域中间键。
+
+app/jobs：该目录包含所有的消息队列任务。
+
+app/kefuapi：该目录包含客服端应用的控制器文件，用于处理用户请求、业务逻辑和数据交互等操作。
+
+app/lang：该目录包含语言包文件，用于支持多语言功能。
+
+app/listener：该目录包含事件监听器的类文件，用于处理系统事件和事件通知。
+
+app/model：该目录包含模型类文件，用于封装数据访问操作，提供统一的数据访问接口。
+
+app/outapi：该目录包含对外接口应用的控制器文件，用于处理用户请求、业务逻辑和数据交互等操作。
+
+app/service：该目录包含服务类文件，用于封装业务逻辑和数据交互操作，提供统一的服务接口。
+
+除了上述目录外，"app"目录还可能包含其他自定义的子目录，用于组织应用的不同模块或功能。
+
+总之，"app"目录是ThinkPHP应用程序的核心目录，其中的文件和目录结构定义了应用的业务逻辑、数据交互和用户界面等方面。开发者可以在该目录下编写和组织代码，实现具体的应用功能。

crmeb/app/Request.php

@@ -34,7 +34,7 @@ class Request extends \think\Request
      * @var array
      */
     protected $except = ['menu_path', 'api_url', 'unique_auth',
-        'description', 'custom_form', 'content', 'tableField'];
+        'description', 'custom_form', 'content', 'tableField', 'url'];
 
     /**
      * 获取请求的数据
@@ -118,6 +118,7 @@ public function replaceWord($farr, $str)
     {
         if (filter_var($str, FILTER_VALIDATE_URL)) {
             $url = parse_url($str);
+            if (!isset($url['scheme'])) return $str;
             $host = $url['scheme'] . '://' . $url['host'];
             $str = $host . preg_replace($farr, '', str_replace($host, '', $str));
         } else {

crmeb/app/adminapi/README.md

@@ -0,0 +1,17 @@
+crmeb/app/adminapi这个目录主要是后台管理系统的API接口文件。
+
+具体来说:
+
+- adminapi目录下的文件都是后台管理系统的控制器(Controller)文件,这些控制器被用来处理后台系统的各种请求。
+
+- 每一个控制器文件对应后台管理系统某个功能模块,比如AuthController处理认证模块请求,StoreProduct处理商品模块请求等。
+
+- 控制器内有各种方法,这些方法就相当于API接口,可以处理GET、POST请求,返回JSON数据。
+
+- 浏览器或APP在调用这些API接口时,会发送请求到相应的控制器方法,例如登录接口请求到Login文件的login方法。
+
+- 控制器处理完请求后,通过返回Response对象返回处理结果给浏览器或APP。
+
+所以简单来说,adminapi目录负责后台管理系统的所有API接口,这些接口被APP或前端调用来完成各种管理操作,如查询数据、添加修改删除等。开发者在新增后台功能时,也需要在此目录增加对应的控制器和接口。
+
+它实际上负责后台系统的通信交互层,解耦了后端逻辑和前端展示,采用 RESTful规范设计。

crmeb/app/adminapi/controller/Common.php

@@ -11,6 +11,7 @@
 namespace app\adminapi\controller;
 
 use app\services\system\config\SystemConfigServices;
+use app\services\system\config\SystemConfigTabServices;
 use app\services\system\SystemAuthServices;
 use app\services\order\StoreOrderServices;
 use app\services\product\product\StoreProductServices;
@@ -22,6 +23,7 @@
 use app\services\user\UserServices;
 use crmeb\services\CacheService;
 use crmeb\services\HttpService;
+use think\facade\Config;
 
 /**
  * 公共接口基类 主要存放公共接口
@@ -236,28 +238,28 @@ public function jnotice()
             $value[] = [
                 'title' => "您有$data[ordernum]个待发货的订单",
                 'type' => 1,
-                'url' => '/admin/order/list?status=1'
+                'url' => '/' . Config::get('app.admin_prefix', 'admin') . '/order/list?status=1'
             ];
         }
         if ($data['inventory'] != 0) {
             $value[] = [
                 'title' => "您有$data[inventory]个商品库存预警",
                 'type' => 2,
-                'url' => '/admin/product/product_list?type=5',
+                'url' => '/' . Config::get('app.admin_prefix', 'admin') . '/product/product_list?type=5',
             ];
         }
         if ($data['commentnum'] != 0) {
             $value[] = [
                 'title' => "您有$data[commentnum]条评论待回复",
                 'type' => 3,
-                'url' => '/admin/product/product_reply?is_reply=0'
+                'url' => '/' . Config::get('app.admin_prefix', 'admin') . '/product/product_reply?is_reply=0'
             ];
         }
         if ($data['reflectnum'] != 0) {
             $value[] = [
                 'title' => "您有$data[reflectnum]个提现申请待审核",
                 'type' => 4,
-                'url' => '/admin/finance/user_extract/index?status=0',
+                'url' => '/' . Config::get('app.admin_prefix', 'admin') . '/finance/user_extract/index?status=0',
             ];
         }
         return app('json')->success($this->noticeData($value));
@@ -406,5 +408,56 @@ public function saveCopyright()
         return app('json')->success(100000);
     }
 
-
+    /**
+     * 系统搜索菜单
+     * @return \think\Response
+     * @author 吴汐
+     * @email 442384644@qq.com
+     * @date 2024/2/1
+     */
+    public function menusSearch()
+    {
+        // 从请求中获取关键字
+        [$keyword] = $this->request->postMore([
+            ['keyword', ''],
+        ], true);
+        // 获取系统菜单服务实例
+        $menusServices = app()->make(SystemMenusServices::class);
+        // 查询菜单列表
+        $menusList = $menusServices->selectList([['menu_name', 'like', '%' . $keyword . '%'], ['auth_type', '=', 1]], 'menu_name as title,menu_path as path,id')->toArray();
+        // 获取系统配置服务实例
+        $configServices = app()->make(SystemConfigServices::class);
+        // 获取系统配置标签服务实例
+        $configTabServices = app()->make(SystemConfigTabServices::class);
+        // 查询配置项列表
+        $configList = $configServices->selectList([['info', 'like', '%' . $keyword . '%']], 'info as title,config_tab_id')->toArray();
+        $configTabList = $configTabServices->selectList([['title', 'like', '%' . $keyword . '%']], 'title,id as config_tab_id')->toArray();
+        $configAllList = array_merge($configList, $configTabList);
+        // 获取配置项对应的标签ID
+        $tabIds = array_unique(array_column($configAllList, 'config_tab_id'));
+        // 查询配置项标签列表
+        $tabList = $configTabServices->getColumn([['id', 'in', $tabIds]], 'menus_id', 'id');
+        // 将配置项标签列表中的菜单ID与配置项列表中的菜单ID对应起来
+        foreach ($configAllList as &$item1) {
+            $item1['menus_id'] = $tabList[$item1['config_tab_id']] ?? 0;
+        }
+        // 获取配置项标签对应的菜单ID
+        $configTabIds = array_values($tabList);
+        // 查询配置项标签对应的菜单列表
+        $configMenusList = $menusServices->getColumn([['id', 'in', $configTabIds]], 'menu_name as title,menu_path as path,id', 'id');
+        // 将配置项列表中的菜单ID与配置项标签对应的菜单ID对应起来
+        foreach ($configAllList as $item2) {
+            $menusList[] = [
+                'title' => $configMenusList[$item2['menus_id']]['title'] . '-' . $item2['title'],
+                'path' => $configMenusList[$item2['menus_id']]['path'] . '?tab_id=' . $item2['config_tab_id'],
+                'id' => $configMenusList[$item2['menus_id']]['id']
+            ];
+        }
+        // 将菜单列表中的路径前缀添加到每个菜单项的 path 属性上
+        foreach ($menusList as &$item) {
+            $item['path'] = '/' . Config::get('app.admin_prefix', 'admin') . $item['path'];
+        }
+        // 返回 JSON 格式的菜单列表
+        return app('json')->success($menusList);
+    }
 }