ThinkPHP中不直接存文件，而是存路径（最常用）、文本内容（TEXT字段）、二进制数据（BLOB，慎用）或结构化数据（JSON/TEXT字段）；需区分存储对象与方式，上传后按需处理并安全入库。
ThinkPHP 中不直接“存文件”，而是把文件内容、路径或二进制数据写入数据库。常见做法是：上传文件到服务器指定目录，再将文件名、路径、大小、类型等元信息存进数据库；少数场景（如小图标、配置模板）会把文件内容以字符串或二进制形式入库。关键在于区分“存什么”和“怎么存”。
存文件路径（最常用、推荐）
适用于图片、Excel、PDF 等常规附件。上传后只记录路径，读取时拼接 URL 或用文件系统读取。
- 前端表单需设置
enctype="multipart/form-data" - 后端用
$file = $this->request->file('xxx')获取上传对象 - 调用
$file->move()保存到public/uploads/等目录，获取相对路径（如uploads/20260921/abc.xlsx） - 将该路径字符串存入数据库的
varchar字段，例如：db()->insert(['file_path' => $savePath, 'original_name' => $file->getInfo('name')])
存文件内容为字符串（适合文本类）
如 HTML 模板、JSON 配置、CSV 内容等纯文本，可读性强、便于 SQL 查询。
- 用
file_get_contents($file->getPathname())读取原始内容 - 确保内容编码为 UTF-8，避免中文乱码
- 存入
TEXT类型字段，使用 PDO 预处理防止注入：$stmt = $pdo->prepare("INSERT INTO templates (content) VALUES (?)"); $stmt->execute([$content]);
存文件为二进制（BLOB，慎用）
仅建议极小文件（如用户头像图标、证书签名），大文件会拖慢数据库、备份困难、影响性能。
立即学习“PHP免费学习笔记（深入）”；
- 读取为二进制：
$binData = file_get_contents($file->getPathname()); - 数据库字段类型必须为
BLOB或MEDIUMBLOB - 插入时绑定参数：
$stmt->bindParam(1, $binData, PDO::PARAM_LOB); - 读取后需用
header()输出或 base64 编码展示，不能直接 echo
存数组/结构化数据（非文件本身，但常被混淆）
比如 Excel 解析后的二维数组、用户上传的 JSON 配置，本质是数据，不是文件。
- 用
json_encode($data, JSON_UNESCAPED_UNICODE)转为字符串 - 存入
TEXT字段；MySQL 5.7+ 可用JSON类型字段，支持原生查询 - 读取后用
json_decode($str, true)还原为 PHP 数组 - 避免用
serialize()，跨版本兼容性差，且无法被数据库函数解析
