UniversalQuery 万能查询API插件

📖 简介

UniversalQuery 是一个万能查询API插件，提供灵活强大的数据库查询接口，支持任意表查询、连表查询、条件筛选等功能，输出JSON和XML格式数据。

✨ 特性

🔍 万能查询 - 支持查询任意数据表和字段
🔗 连表查询 - 支持多表JOIN（left join）查询，自动识别关联关系
🎯 灵活条件 - 支持多种WHERE操作符（=、>、<、LIKE、IN等）
📊 聚合函数 - 支持COUNT、SUM、AVG、MAX、MIN等统计查询
🔒 安全可靠 - 参数化查询防SQL注入，基本安全检查
📤 多格式输出 - 支持JSON和XML格式
📝 完整文档 - 内置API文档和使用示例

🚀 快速开始

API接口

1. 万能查询接口

URL: /index.php?s=weapp/UniversalQuery/query

方法: GET/POST

参数:

table (必需) - 表名，支持任意数据表
fields (可选) - 查询字段，用逗号分隔，默认 *
join (可选) - 连表查询（使用LEFT JOIN），格式：table1,table2
on (可选) - 自定义连表条件，格式：table1.field=table2.field
where (可选) - WHERE条件，格式：field:operator:value
limit (可选) - 限制条数，默认10，最大50
page (可选) - 页码，默认1，用于分页查询
offset (可选) - 偏移量，默认0，直接指定起始位置
order (可选) - 排序字段，格式：field 或 field:desc
format (可选) - 返回格式：json/xml，默认json

基本使用

1. 查询文章列表

GET /index.php?s=weapp/UniversalQuery/query&table=archives&fields=aid,title,add_time&limit=5&order=aid:desc

2. 自定义连表条件带on的

GET /index.php?s=weapp/UniversalQuery/query&table=archives&join=arctype&on=archives.typeid=arctype.id&fields=archives.title,arctype.typename&where=archives.status:=:1&limit=10

3. 多表连接（自定义ON条件）

GET /index.php?s=weapp/UniversalQuery/query&table=archives&join=product_content,arctype&on=product_content:archives.aid=product_content.aid,arctype:archives.typeid=arctype.id&fields=archives.title,product_content.seo_title,arctype.typename&where=archives.channel:=:2&limit=10

4. 统计文章数量

GET /index.php?s=weapp/UniversalQuery/query&table=archives&fields=count(*) as total&where=channel:=:1

5. 分页查询示例

# 页码分页（第2页，每页10条）
GET /index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2

使用示例

JavaScript Ajax 调用

// 基础查询fetch('/index.php?s=weapp/UniversalQuery/query&table=archives&fields=aid,title&limit=5')
    .then(response => response.json())
    .then(data => {
        if (data.code === 1) {
            console.log('查询成功:', data.data);
            console.log('记录数:', data.count);
        } else {
            console.error('查询失败:', data.msg);
        }
    });// 分页查询fetch('/index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2')
    .then(response => response.json())
    .then(data => {
        if (data.code === 1) {
            console.log('总记录数:', data.total);
            console.log('当前页:', data.pagination.current_page);
            console.log('总页数:', data.pagination.total_pages);
        }
    });

PHP 调用

// 基础查询$url = '/index.php?s=weapp/UniversalQuery/query&table=archives&where=channel:=:2&limit=10';$response = file_get_contents($url);$data = json_decode($response, true);if ($data['code'] === 1) {
    foreach ($data['data'] as $item) {
        echo $item['title'] . "\n";
    }}// POST请求查询$postData = http_build_query([
    'table' => 'product_content',
    'fields' => 'aid,title,users_price',
    'where' => 'status:=:1,users_price:>:0',
    'limit' => 20,
    'order' => 'users_price:desc']);$context = stream_context_create([
    'http' => [
        'method' => 'POST',
        'header' => 'Content-type: application/x-www-form-urlencoded',
        'content' => $postData
    ]]);$response = file_get_contents('/index.php?s=weapp/UniversalQuery/query', false, $context);$data = json_decode($response, true);// 分页查询示例$url = '/index.php?s=weapp/UniversalQuery/query&table=archives&limit=10&page=2';$response = file_get_contents($url);$data = json_decode($response, true);if ($data['code'] === 1) {
    echo "总记录数: " . $data['total'] . "\n";
    echo "当前页: " . $data['pagination']['current_page'] . "\n";
    echo "总页数: " . $data['pagination']['total_pages'] . "\n";}

jQuery 示例

// 动态查询表单$('#queryForm').on('submit', function(e) {
    e.preventDefault();
    
    const params = {
        table: $('#table').val(),
        fields: $('#fields').val() || '*',
        where: $('#where').val(),
        limit: $('#limit').val() || 10,
        order: $('#order').val()
    };
    
    $.get('/index.php?s=weapp/UniversalQuery/query', params)
        .done(function(data) {
            if (data.code === 1) {
                displayResults(data.data);
            } else {
                alert('查询失败: ' + data.msg);
            }
        });});