Cadmin php 服务端

项目地址: [github] [gitee]

在线文档地址: https://baiy.github.io/Cadmin/

特点

1. 为便于给现有系统加入后台管理功能和加快新系统开发, 后台核心系统尽可能的减少依赖, 不侵入外层业务系统.
2. 对请求处理按照请求类型可自定义请求调度类,便于不用业务系统使用和开发. 系统内置Thinkphp/Laravel框架的请求调度类

安装

composer require baiy/cadmin

数据库

详见 数据库结构 一章

使用方法

在代码安装和数据库导入完毕后, 接下来需要将后台系统的入口代码嵌入当前系统的合适位置, 并进行相应的配置

入口代码说明

<?php$admin = new \Baiy\Cadmin\Admin($pdo, $request);
// $admin->setTablePrefix(); // [可选] 设置系统内置数据表前缀 设置后注意修改表名// $admin->registerDispatcher(); // [可选] 注册自定义请求调度器// $admin->registerPassword(); // [可选] 注册自定义用户密码生成器// $admin->setInputActionName($name); // [可选] 设置请求标识变量名// $admin->setInputTokenName($name); // [可选] 设置请求token变量名// $admin->setLogCallback(function(\Baiy\Cadmin\Log $log){}); // [可选] 请求日志记录回调函数// [可选] 运行时SQL监听 便于日志记录 需要根据实际项目使用sql监听方法进行对应调用// $admin->getContext()->addListenSql($sql, $time);// 获取业务处理响应结果 返回 `Psr\Http\Message\ResponseInterface` 对象$response = $admin->run();

Thinkphp 6.0

代码插入位置

/route/app.php

请求根据实际路由配置文件添加代码

示例代码

<?phpusethink\facade\Db;
usethink\facade\Log;
usethink\facade\Route;
// 客户端api路由入口 请求记住此url这是提供给客户端api地址
Route::any('/api/admin/', function (){
// 临时方案: tp 需要先查询一次数据库 才能获取到pdo对象
Db::connect()->execute("select 1");
// 自行构建 PSR-7 请求对象$request = \Laminas\Diactoros\ServerRequestFactory::fromGlobals()
$admin = new \Baiy\Cadmin\Admin(Db::connect()->getPdo(), $request);
$admin->registerDispatcher(new \Baiy\Cadmin\Dispatch\Thinkphp60()); // [可选] 注册内置调度类// 其他配置省略 见上方[入口代码说明] ..... // [可选] 设置请求日志记录回调函数// $admin->setLogCallback(function (\Baiy\Cadmin\Log $log) {// Log::write($log->toJson(), 'notice');// });// 运行时SQL监听 便于日志记录// Db::listen(function ($sql, $time, $master) use ($admin) {// $admin->getContext()->addListenSql($sql, $time);// });// 运行return$admin->run();
})->allowCrossDomain();

Laravel

代码插入位置

/routes/api.php

请求根据实际路由配置文件添加代码

添加到/routes/web.php

示例代码

<?phpuseIlluminate\Support\Facades\DB;
useIlluminate\Support\Facades\Log;
useIlluminate\Support\Facades\Route;
usePsr\Http\Message\ServerRequestInterface;
// 客户端api路由入口 请求记住此url这是提供给客户端api地址// PSR-7 请求对象构建 https://learnku.com/docs/laravel/10.x/requestsmd/14849#psr7-requests
Route::any('/api/admin/', function (ServerRequestInterface$request) {
// 前后端分离项目一般会有跨域问题 自行处理header('Access-Control-Allow-Origin: *');
$admin = new \Baiy\Cadmin\Admin(Db::connection()->getPdo(), $request);
$admin->registerDispatcher(new \Baiy\Cadmin\Dispatch\Laravel()); // [可选] 注册内置调度类// 其他配置省略 见上方[入口代码说明] .....// [可选] 设置请求日志记录回调函数// $admin->setLogCallback(function (\Baiy\Cadmin\Log $log) {// Log::info($log->toJson());// });// 运行时SQL监听 便于日志记录// Db::listen(function ($query) use ($admin) {// $admin->getContext()->addListenSql(// sprintf(str_replace("?","%s",$query->sql),...$query->bindings),// $query->time// );// });// 运行return$admin->run();
});

自定义用户密码生成策略

1. 实现 Baiy\Cadmin\Password\Password 接口
2. 注册密码生成器,使用\Baiy\Cadmin\Admin::registerPassword()

系统内置密码生成器: https://github.com/baiy/Cadmin-server-php/blob/master/src/Password/PasswrodDefault.php

内置密码生成规则: base64_encode(hash('sha256',hash("sha256", $password.$salt,FALSE).$salt,FALSE).'|'.$salt);

自定义请求调度器开发

1. 实现 \Baiy\Cadmin\Dispatch\Dispatch 接口
2. 注册调度器,使用\Baiy\Cadmin\Admin::registerDispatcher()

系统内置调度器: https://github.com/baiy/Cadmin-server-php/tree/master/src/Dispatch