PHPackages baolong/think-library - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. baolong/think-library ActiveLibrary baolong/think-library ===================== Library for ThinkAdmin v1.0.3(2mo ago)019↓100%1MITPHPPHP >=7.1 Since Mar 5Pushed 2mo agoCompare [ Source](https://github.com/807735/ThinkLibrary)[ Packagist](https://packagist.org/packages/baolong/think-library)[ Docs](https://thinkadmin.top)[ RSS](/packages/baolong-think-library/feed)WikiDiscussions master Synced 1mo ago READMEChangelogDependencies (5)Versions (4)Used By (1) ThinkLibrary for ThinkAdmin =========================== [](#thinklibrary-for-thinkadmin) [![Latest Stable Version](https://camo.githubusercontent.com/0b539166687eb16d811afc64507f666e8c8e51e99d178a43f1c78adedd2e1ccb/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b2d6c6962726172792f762f737461626c65)](https://packagist.org/packages/zoujingli/think-library)[![Latest Unstable Version](https://camo.githubusercontent.com/41251f2628797f9d613765c4aeb5dc7f109a6626dbfb48f23a2a2d3d87e64148/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b2d6c6962726172792f762f756e737461626c65)](https://packagist.org/packages/zoujingli/think-library)[![Total Downloads](https://camo.githubusercontent.com/89acbd8450caf0457e4a67381ea2692a394c4ce7ecf51291d9d11a7d573ddc84/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b2d6c6962726172792f646f776e6c6f616473)](https://packagist.org/packages/zoujingli/think-library)[![Monthly Downloads](https://camo.githubusercontent.com/3d0d2a2f067f58dcca3d75c0d8ddddcbb7b98cc2b6ab6b88508bb3436ea5a191/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b2d6c6962726172792f642f6d6f6e74686c79)](https://packagist.org/packages/zoujingli/think-library)[![Daily Downloads](https://camo.githubusercontent.com/bc9681e3e7eb9d50f5231f2ba75cf9446c13ba1c6368bb14b528e55061e16c07/68747470733a2f2f706f7365722e707567782e6f72672f7a6f756a696e676c692f7468696e6b2d6c6962726172792f642f6461696c79)](https://packagist.org/packages/zoujingli/think-library)[![PHP Version](https://camo.githubusercontent.com/6edd55d00ff169d80f252ddfcd8137da3213250a8ebd4626e06ca0f80efb0657/68747470733a2f2f7468696e6b61646d696e2e746f702f7374617469632f69636f6e2f7068702d372e312e737667)](https://thinkadmin.top)[![License](https://camo.githubusercontent.com/ed1cc526cca7696d0cbff80c209ae76557cc44ceb7cf67dc6c99b67a1064b668/68747470733a2f2f7468696e6b61646d696e2e746f702f7374617469632f69636f6e2f6c6963656e73652d6d69742e737667)](https://mit-license.org) **ThinkLibrary** 是一个针对 **ThinkPHP 6 & 8** 的封装库，它提供了完整的 **CRUD**（创建、读取、更新、删除）操作和一系列常用工具。 业务功能特性 ------ [](#业务功能特性) **核心架构功能：** - **标准控制器基类**: 提供完整的 CRUD 操作封装，包括分页、表单、验证、队列等通用功能 - **基础模型类**: 实现魔术方法和静态助手调用，支持操作日志记录和数据一致性保障 - **自定义服务基类**: 提供依赖注入和实例化机制，支持服务的统一管理和扩展 - **全局函数库**: 包含数据处理、系统配置、HTTP 请求、JWT 认证等实用函数 - **快捷查询逻辑器**: 提供链式查询构建，简化数据库操作 - **表单验证机制**: 支持规则别名和自定义验证，确保数据输入安全 - **异步任务队列**: 支持延时执行和循环任务，提升系统响应性能 - **CSRF 令牌验证**: 内置表单安全验证，防止跨站请求伪造攻击 - **高精度计算支持**: 集成 BC Math 高精度数学函数，确保金融计算的准确性 **技术特性：** - **PSR-12 标准**: 严格遵循 PHP-FIG 编码规范，确保代码质量和可维护性 - **模块化设计**: 各功能模块独立封装，便于扩展和维护 - **高性能优化**: 针对高并发场景进行专门优化，支持缓存和数据库连接池 - **异常处理完善**: 完善的异常捕获和日志记录机制，便于问题排查 - **向后兼容**: 保持 API 稳定性，确保平滑升级 - **数据完整性保障**: 通过数据库约束确保业务数据的一致性和有效性 功能说明 ---- [](#功能说明) 1. **数据列表展示组件** - 功能：展示数据列表，支持分页、排序和高级搜索。 - 优化点：提供友好的用户界面和交互体验，确保数据展示的准确性和实时性。 - 高级特性：支持多种排序方式、自定义搜索字段和条件。 2. **表单处理模块** - 功能：用于创建、展示和提交表单数据。 - 优化点：表单验证和错误处理机制，确保数据的有效性和完整性。 - 高级特性：支持多种表单元素、表单验证规则和动态表单生成。 3. **数据状态快速处理模块** - 功能：根据业务需求快速更新数据状态。 - 优化点：提供简洁的接口和操作方式，支持多字段同时更新。 - 高级特性：支持条件判断和事务处理，确保数据一致性和完整性。 4. **数据安全删除模块** - 功能：根据业务需求安全地删除数据。 - 优化点：提供软删除和硬删除两种方式，确保数据彻底消失或标记为已删除。 - 高级特性：支持根据条件自动软删除、可配置的软删除标记字段。 5. **文件存储通用组件** - 功能：支持多种文件存储方式，包括本地服务存储、云存储等。 - 优化点：提供统一的接口和配置方式，方便开发者快速集成和使用。 - 高级特性：支持文件上传、下载、删除和版本控制等功能。 6. **通用数据保存更新模块** - 功能：根据 key 值及 where 条件判断数据是否存在，进行更新或新增操作。 - 优化点：提供简洁的接口和操作方式，减少冗余代码和重复工作量。 - 高级特性：支持乐观锁和悲观锁机制，确保并发控制和数据一致性。 7. **通用网络请求模块** - 功能：支持 GET、POST 和 PUT 请求，可配置请求参数、证书等。 - 优化点：提供统一的接口和配置方式，方便开发者快速发起网络请求。 - 高级特性：支持请求重试、超时设置、自动捕获异常等功能。 8. **系统参数通用 g-k-v 配置模块** - 功能：快速配置系统参数，支持长久化保存。 - 优化点：提供简洁的接口和操作方式，方便开发者管理和维护系统参数。 - 高级特性：支持参数加密存储、权限控制和日志记录等功能。 9. **UTF8 加密算法支持模块** - 功能：提供 UTF8 字符串的加密和解密功能。 - 优化点：确保加密过程的安全性和数据的机密性。 - 高级特性：支持多种加密算法、密钥管理等功能。 10. **接口 CORS 跨域默认支持模块** - 功能：默认支持跨域请求，输出标准化 JSON 数据。 - 优化点：减少开发者的工作量，自动处理跨域问题。 - 高级特性：支持定制化响应头、跨域请求限制等功能。 11. **表单 CSRF 安全验证模块** - 功能：自动为表单添加 CSRF 安全验证字段，防止恶意提交。 - 优化点：简化开发者的工作流程，提高表单提交的安全性。 - 高级特性：支持自定义验证规则、多种验证方式等功能。 参考项目 ---- [](#参考项目) #### ThinkAdmin - V6 [](#thinkadmin---v6) - Gitee 仓库 - Github 仓库 - Gitcode 仓库 - 体验地址 ( 账号密码都是 admin ) 代码仓库 ---- [](#代码仓库) **ThinkLibrary** 遵循 **MIT** 开源协议发布，并免费提供使用。 部分代码来自互联网，若有异议可以联系作者进行删除。 - 在线体验地址： ( 账号和密码都是 `admin` ) - **Gitee** 仓库地址： - **Github** 仓库地址： - **Gitcode** 仓库地址： 版权所有 Copyright © 2014-2026 by ThinkAdmin () All rights reserved。 使用说明 ---- [](#使用说明) 1. **依赖管理**：ThinkLibrary 需要 Composer 支持进行安装和依赖管理。 2. **安装指南**：您可以使用以下命令通过 Composer 安装 ThinkLibrary：`composer require zoujingli/think-library`。 3. **使用示例**：在使用 ThinkLibrary 时，确保您的控制器类继承自 `think\admin\Controller`。一旦继承完成，您就可以通过 `$this` 对象访问并使用全部功能。 ``` // 定义 MyController 控制器 class MyController extend \think\admin\Controller { // 指定当前数据表名 protected $dbQuery = '数据表名'; // 显示数据列表 public function index(){ $this->_page($this->dbQuery); } // 当前列表数据处理 protected function _index_page_filter(&$data){ foreach($data as &$vo){ // @todo 修改原列表 } } } ``` - 必要数据库表SQL（sysdata 函数需要用这个表） ``` CREATE TABLE `system_data` ( `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT, `name` varchar(100) DEFAULT NULL COMMENT '配置名', `value` longtext COMMENT '配置值', PRIMARY KEY (`id`) USING BTREE, KEY `idx_system_data_name` (`name`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统-数据'; ``` - 必要数据库表SQl（sysoplog 函数需要用的这个表） ``` CREATE TABLE `system_oplog` ( `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT, `node` varchar(200) NOT NULL DEFAULT '' COMMENT '当前操作节点', `geoip` varchar(15) NOT NULL DEFAULT '' COMMENT '操作者IP地址', `action` varchar(200) NOT NULL DEFAULT '' COMMENT '操作行为名称', `content` varchar(1024) NOT NULL DEFAULT '' COMMENT '操作内容描述', `username` varchar(50) NOT NULL DEFAULT '' COMMENT '操作人用户名', `create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统-日志'; ``` - 必要数据库表SQL（`sysconf`函数需要用到这个表） ``` CREATE TABLE `system_config` ( `type` varchar(20) DEFAULT '' COMMENT '分类', `name` varchar(100) DEFAULT '' COMMENT '配置名', `value` varchar(500) DEFAULT '' COMMENT '配置值', KEY `idx_system_config_type` (`type`), KEY `idx_system_config_name` (`name`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统-配置'; ``` - 系统任务列队支持需要的数据表 ``` CREATE TABLE `system_queue` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `code` varchar(20) DEFAULT '' COMMENT '任务编号', `title` varchar(50) NOT NULL DEFAULT '' COMMENT '任务名称', `command` varchar(500) DEFAULT '' COMMENT '执行指令', `exec_data` longtext COMMENT '执行参数', `exec_time` bigint(20) unsigned DEFAULT '0' COMMENT '执行时间', `exec_desc` varchar(500) DEFAULT '' COMMENT '状态描述', `enter_time` bigint(20) DEFAULT '0' COMMENT '开始时间', `outer_time` bigint(20) DEFAULT '0' COMMENT '结束时间', `attempts` bigint(20) DEFAULT '0' COMMENT '执行次数', `rscript` tinyint(1) DEFAULT '1' COMMENT '单例模式', `status` tinyint(1) DEFAULT '1' COMMENT '任务状态(1新任务,2处理中,3成功,4失败)', `create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间', PRIMARY KEY (`id`) USING BTREE, KEY `idx_system_queue_code` (`code`), KEY `idx_system_queue_title` (`title`) USING BTREE, KEY `idx_system_queue_status` (`status`) USING BTREE, KEY `idx_system_queue_rscript` (`rscript`) USING BTREE, KEY `idx_system_queue_create_at` (`create_at`) USING BTREE, KEY `idx_system_queue_exec_time` (`exec_time`) USING BTREE ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='系统-任务'; ``` #### 列表处理 [](#列表处理) ``` // 列表展示 $this->_page($dbQuery, $isPage, $isDisplay, $total); // 列表展示搜索器（按 name、title 模糊搜索；按 status 精确搜索） $this->_query($dbQuery)->like('name,title')->equal('status')->page(); // 对列表查询器进行二次处理 $query = $this->_query($dbQuery)->like('name, title')->equal('status'); $db = $query->db(); // @todo 这里可以对db进行操作 $this->_page($db); // 显示列表分页 ``` #### 表单处理 [](#表单处理) ``` // 表单显示及数据更新 $this->_form($dbQuery, $tplFile, $pkField , $where, $data); ``` #### 删除处理 [](#删除处理) ``` // 数据删除处理 $this->_deleted($dbQuery); ``` #### 禁用启用处理 [](#禁用启用处理) ``` // 数据禁用处理 $this->_save($dbQuery, ['status'=>'0']); // 数据启用处理 $this->_save($dbQuery, ['status'=>'1']); ``` #### 文件存储组件（ oss 及 qiniu 需要配置参数） [](#文件存储组件-oss-及-qiniu-需要配置参数) ``` // 配置默认存储方式 sysconf('storage.type','文件存储类型'); // 七牛云存储配置 sysconf('storage.qiniu_region', '文件存储节点'); sysconf('storage.qiniu_domain', '文件访问域名'); sysconf('storage.qiniu_bucket', '文件存储空间名称'); sysconf('storage.qiniu_is_https', '文件HTTP访问协议'); sysconf('storage.qiniu_access_key', '接口授权AccessKey'); sysconf('storage.qiniu_secret_key', '接口授权SecretKey'); // 生成文件名称(链接url或文件md5) $filename = \think\admin\Storage::name($url, $ext, $prv, $fun); // 获取文件内容（自动存储方式） $result = \think\admin\Storage::get($filename); // 保存内容到文件（自动存储方式） $result = \think\admin\Storage::save($filename, $content); // 判断文件是否存在 boolean \think\admin\Storage::has($filename); // 获取文件信息 $result = \think\admin\Storage::info($filename); //指定存储类型（调用方法） $result = \think\admin\Storage::instance('local')->save($filename, $content); $result = \think\admin\Storage::instance('qiniu')->save($filename, $content); $result = \think\admin\Storage::instance('txcos')->save($filename, $content); $result = \think\admin\Storage::instance('upyun')->save($filename, $content); $result = \think\admin\Storage::instance('alioss')->save($filename, $content); // 读取文件内容 $result = \think\admin\Storage::instance('local')->get($filename); $result = \think\admin\Storage::instance('qiniu')->get($filename); $result = \think\admin\Storage::instance('txcos')->get($filename); $result = \think\admin\Storage::instance('upyun')->get($filename); $result = \think\admin\Storage::instance('alioss')->get($filename); // 生成 URL 访问地址 $result = \think\admin\Storage::instance('local')->url($filename); $result = \think\admin\Storage::instance('qiniu')->url($filename); $result = \think\admin\Storage::instance('txcos')->url($filename); $result = \think\admin\Storage::instance('upyun')->url($filename); $result = \think\admin\Storage::instance('alioss')->url($filename); // 检查文件是否存在 boolean \think\admin\Storage::instance('local')->has($filename); boolean \think\admin\Storage::instance('qiniu')->has($filename); boolean \think\admin\Storage::instance('txcos')->has($filename); boolean \think\admin\Storage::instance('upyun')->has($filename); boolean \think\admin\Storage::instance('alioss')->has($filename); // 生成文件信息 $resutl = \think\admin\Storage::instance('local')->info($filename); $resutl = \think\admin\Storage::instance('qiniu')->info($filename); $resutl = \think\admin\Storage::instance('txcos')->info($filename); $resutl = \think\admin\Storage::instance('upyun')->info($filename); $resutl = \think\admin\Storage::instance('alioss')->info($filename); ``` #### 通用数据保存 [](#通用数据保存) ``` // 指定关键列更新（$where 为扩展条件） boolean data_save($dbQuery, $data, 'pkname', $where); ``` #### 通用网络请求 [](#通用网络请求) ``` // 发起get请求 $result = http_get($url, $query, $options); // 发起post请求 $result = http_post($url, $data, $options); ``` #### 系统参数配置（基于 system\_config 数据表） [](#系统参数配置基于-system_config-数据表) ``` // 设置参数 sysconf($keyname, $keyvalue); // 获取参数 $keyvalue = sysconf($kename); ``` ### 数据加密 [](#数据加密) **自研 UTF8 加密** ``` // 自研 UTF8 字符串加密操作 $string = encode($content); // 自研 UTF8 加密字符串解密 $content = decode($string); ``` **数据解密** ``` use think\admin\extend\CodeExtend; // 数据 AES-256-CBC 对称加密 $encrypt = CodeExtend::encrypt($content, $enckey); // 数据 AES-256-CBC 对称解密 $content = CodeExtend::decrypt($encrypt, $enckey); ``` **文本转 UTF8 编码** ``` use think\admin\extend\CodeExtend; // 文本转 UTF8 编码 $content = CodeExtend::text2utf8($content) ``` **文本 Base64 URL 编码** ``` use think\admin\extend\CodeExtend; // 文本 Base64 URL 编码 $safe64 = CodeExtend::enSafe64($content) // 文本 Base64 URL 解码 $content = CodeExtend::deSafe64($safe64) ``` ### 数据压缩处理 [](#数据压缩处理) ``` use think\admin\extend\CodeExtend; // 数据压缩 ( 内容越大效果越好 ) $enzip = CodeExtend::enzip($content) // 数据解压 ( 内容越大效果越好 ) $content = CodeExtend::dezip($enzip) ``` ### 数组结构处理 [](#数组结构处理) ``` use think\admin\extend\CodeExtend; // 二维数组 转为 立体数据结构，需要存在 id 及 pid 关系 $tree = CodeExtend::arr2tree($list); // 二维数组 转为 扁平数据结构，需要存在 id 及 pid 关系 $tree = CodeExtend::arr2table($list); ``` ### Health Score 35 — LowBetter than 79% of packages Maintenance86 Actively maintained with recent releases Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity31 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 69d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/ce2b0b1229b973ce7cdeaab2573f19fe1abb24f6be6883f5dbfa8a173e2074c6?d=identicon)[baolong](/maintainers/baolong) --- Top Contributors [![807735](https://avatars.githubusercontent.com/u/13691671?v=4)](https://github.com/807735 "807735 (16 commits)") ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/baolong-think-library/health.svg) ``` [![Health](https://phpackages.com/badges/baolong-think-library/health.svg)](https://phpackages.com/packages/baolong-think-library) ``` ### Alternatives [zoujingli/think-library Library for ThinkAdmin 8569.8k18](/packages/zoujingli-think-library)[jaguarjack/catchadmin The CatchAdmin Background management 8962.6k](/packages/jaguarjack-catchadmin)[apiadmin/apiadmin Just For Api 5024.2k](/packages/apiadmin-apiadmin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)