在公司里，运营、老板或者其他同事经常会来找我问数据。很多时候，一个简单的 SQL 就能解决问题，但他们从来不愿意学 SQL，也不想安装任何查询工具。每次被打断写代码，我都非常无奈。
于是，我写了一个小工具——Data Query Tool，让同事自己动手查数据，自己专心写代码，同时还能保证简单、快速、安全。
问题
- 同事不会 SQL，也不想学。
- 安装数据库客户端工具成本高，不方便在每台电脑上部署，哪怕是 phpMyAdmin 他们都不愿意去了解。
- 每次帮人查数据都很耗时间，打断了开发思路。
我希望的是：让非技术同事可以在浏览器里直接点击，就得到他们想要的数据，最好还能导出 Excel，省的来找我要数据。
解决方案
我选择了用 PHP 写一个零依赖、无框架、单文件启动的查询工具：
-
只要把代码放到服务器上（最好是公司内网），运行：
php -S 0.0.0.0:8000就可以通过浏览器访问
http://??**?*务器IP:8000。 -
常用 SQL 配置成模板，支持参数化：
- 文本输入（input）
- 日期选择（date）
- 下拉选择（select）
-
同事直接选择 SQL 模板、填入参数，就能查询，不用写 SQL。
-
内网部署安全可靠，零打扰开发流程。
SQL 配置说明
工具使用 config.json 来管理 SQL 模板，结构示例：
{
"sql_templates": [
{
"name": "查询所有用户",
"query": "SELECT user_id as '用户ID',phone as '手机号',real_name as '姓名',FROM_UNIXTIME(created_at) as '创建时间' from ch_users where deleted_at is null",
"query_params": {}
},
{
"name": "根据手机号查询用户",
"query": "SELECT user_id as '用户ID',phone as '手机号',real_name as '姓名',FROM_UNIXTIME(created_at) as '创建时间' from ch_users where phone = {{phone}} and deleted_at is null",
"query_params": {
"phone": {
"type": "input",
"description": "手机号"
}
}
},
{
"name": "根据注册时间查询用户",
"query": "SELECT user_id as '用户ID',phone as '手机号',real_name as '姓名',FROM_UNIXTIME(created_at) as '创建时间' from ch_users where created_at >= UNIX_TIMESTAMP({{start_time}}) and created_at <= UNIX_TIMESTAMP({{end_time}}) and deleted_at is null",
"query_params": {
"start_time": {
"type": "date",
"description": "开始时间"
},
"end_time": {
"type": "date",
"description": "结束时间"
}
}
},
{
"name": "根据订单状态搜索订单信息",
"query": "SELECT borrow_sn as '订单号',real_name as '姓名',borrow_amount as '合同金额',FROM_UNIXTIME(created_at) as '签约时间' from ch_borrows where `status` = {{status}} and deleted_at is null",
"query_params": {
"status": {
"type": "select",
"options": [
{ "value": "5", "label": "拒绝签约" },
{ "value": "6", "label": "取消签约" },
{ "value": "9", "label": "签约失败" },
{ "value": "11", "label": "已签约" },
{ "value": "12", "label": "已完成" }
],
"description": "订单状态"
}
}
}
]
}
使用示例
-
将代码放到服务器或电脑
git clone https://**gi*thub.com/zxc7563598/data-query-tool.git cd data-query-tool -
启动 PHP 内置服务器
php -S 0.0.0.0:8000 -
浏览器访问
打开http://??**?*务器IP:8000- 选择 SQL 模板
- 填写或选择参数
- 点击查询，即可显示结果
-
可选：编辑
config.json- 配置 SQL 模板
- 配置模板参数类型和描述
效果截图
总结
其实也没啥高大上的理由，我写这个工具就是因为——老板和同事再也不会天天来烦我查数据了。
他们想要啥，自己点点就行；我也不用被一行 SQL 打断思路。
说白了，这东西就是 给自己图个清净。
