数据库命令行工具

功能概述

数据库命令行工具是一套用于在命令行中直接操作数据库的便捷工具集，提供查询、执行、统计、查看表结构等多种功能。该工具集主要用于开发调试阶段，帮助开发者快速查看和操作数据库数据。

使用限制

重要：所有数据库命令行工具仅在 APP_DEBUG = true（开发者模式）下可用，生产环境中自动禁用以保证安全性。

可用命令

1. tools:db:query - 执行 SQL 查询

执行 SELECT 查询语句并以表格或 JSON 格式显示结果。

php think tools:db:query "SELECT * FROM ul_user LIMIT 10"
php think tools:db:query "SELECT id, username FROM ul_user WHERE status = 1" --format=json

参数说明：

sql: SQL 查询语句（必须）
--format: 输出格式，可选值：table（默认，表格形式）、json（JSON 格式）

使用场景：

快速查看表数据
调试复杂 SQL 查询
导出数据为 JSON 格式

2. tools:db:execute - 执行 SQL 写入操作

执行 INSERT、UPDATE、DELETE 等写操作 SQL 语句，执行前需要确认。

php think tools:db:execute "UPDATE ul_user SET status = 1 WHERE id = 1"
php think tools:db:execute "DELETE FROM ul_log WHERE create_time < '2024-01-01'"

参数说明：

sql: SQL 执行语句（必须）
--yes: 跳过确认直接执行（谨慎使用）

安全机制：

执行前显示将影响的行数
需要手动确认（输入 yes）才会执行
使用 --yes 参数可跳过确认（仅限脚本场景）

使用场景：

批量更新数据
清理历史数据
临时数据修复

3. tools:db:table - 使用查询构造器操作

使用 ThinkPHP 查询构造器进行链式操作，支持 select、update、delete、insert。

# 查询
php think tools:db:table user select "where('status', 1).limit(10)"
# 更新
php think tools:db:table user update "where('id', 1)" --data='{"status": 1}'
# 删除
php think tools:db:table user delete "where('status', 0)"
# 插入
php think tools:db:table user insert --data='{"username": "test", "password": "123456"}'

参数说明：

table: 表名（不需要前缀 ul_，自动处理）
action: 操作类型：select、update、delete、insert
where: WHERE 条件链（使用 ThinkPHP 查询构造器语法）
--data: JSON 格式的数据（用于 update 和 insert）
--format: 输出格式：table（默认）、json

使用场景：

快速构建查询条件
批量数据操作
无需记忆完整 SQL 语法

4. tools:db:count - 统计表记录数

统计表的记录总数，支持 WHERE 条件。

php think tools:db:count user
php think tools:db:count user --where="where('status', 1)"

参数说明：

table: 表名（不需要前缀 ul_，自动处理）
--where: WHERE 条件链

使用场景：

快速统计数据量
统计特定条件下的记录数

5. tools:db:info - 显示数据库信息

显示当前数据库连接信息和所有表列表。

php think tools:db:info

输出内容：

数据库连接配置（host、port、database、charset）
所有数据表列表（带行数统计）

使用场景：

检查数据库连接状态
查看所有可用表
快速了解数据库结构

6. tools:db:desc - 查看表结构

显示指定表的详细结构信息，包括字段定义和索引。

php think tools:db:desc user

输出内容：

字段信息：字段名、类型、是否为空、默认值、注释
索引信息：索引名、索引类型、索引字段

使用场景：

快速查看表结构
检查字段定义
查看索引配置

注意事项

仅限开发环境使用：所有命令仅在 APP_DEBUG = true 时可用
表名前缀自动处理：命令中的表名会自动添加 ul_ 前缀
写操作需确认：execute 和 table 命令的写操作需要手动确认
格式化输出：所有查询命令都支持 --format=table（默认）和 --format=json 两种输出格式
权限控制：使用 .env 文件中配置的数据库用户权限，确保有足够的操作权限