常见问题

表格信息查询系统是一套基于 Excel 文件的在线查询平台，主要面向需要把内部表格数据（名单、证书、成绩、库存、工单等）安全、便捷地对外开放查询的用户。

访客无需注册，输入对应编号（如注册编号、证书编号）即可查询到自己的记录。适合学校、企业、协会、政务窗口等需要"自助查询"的场景。

不需要数据库。系统是纯 PHP 程序，配置以文件形式保存。只要把文件上传到支持 PHP 的服务器（虚拟主机或云服务器均可），即可直接运行。

开箱即用，无数据库安装、建表、备份等运维成本，表格数据本身以 .xls 文件存储。

分为三个版本，能力递增：

• V1 测试版：仅含基础查询与简单设置（Banner / SEO / 查询 / 页脚 / 改密 / 状态），无上传管理、无防护，适合体验。
• V2 基础版：在 V1 基础上增加后台文件上传/删除、Logo 与背景图上传、CSRF/bcrypt 安全防护、登录锁定、前台说明卡片、失效数据标记。
• V3 专业版推荐：在 V2 基础上新增「指定列加计运算」与「单元格智能合并 / 移动端分区卡片展示」。

各版本完整差异见产品页「版本对比」。

为保持简洁统一，表格仅支持传统 Excel 的 .xls（BIFF 格式）。上传 .xlsx、.csv 等格式时，系统会提示"仅支持 .xls 格式"。

解决办法：请用 Excel / WPS 打开文件，点击「文件 → 另存为」，选择「Excel 97-2003 工作簿（.xls）」后再上传。

两点必须满足：

• 第一行必须是表头（列名），系统靠它定位每一列。
• 必须存在一列，其表头文字与后台「查询设置」里配置的查询字段完全一致（例如 注册编号）。缺少对应列会提示"未找到 XX 字段列"。

表头文字的空格、全/半角都要与后台配置完全一致。

在后台「数据管理」中上传的每个 .xls 文件即一张独立的数据表，文件名就是表名。

前台查询页会自动列出所有表格，访客通过下拉框选择要查询的表，再输入对应编号即可。新增或删除表格后刷新前台即生效。

系统本身不限制上传文件大小，实际限制取决于服务器的 PHP 上传配置（upload_max_filesize 与 post_max_size）。

若大文件上传失败，请联系主机商调高上传上限，或拆分表格后分批上传。

前台提供三项：数据表下拉框 + 查询字段输入框 + 验证码。输入编号（含 4 位验证码）提交后，系统精确匹配对应行并展示完整记录。

结果页支持打印与返回，移动端以分区卡片形式呈现，便于手机阅读。

当前为精确匹配。系统按表头定位查询列，对整串内容做完全相等比较。

例如查询 2024001 只会返回该编号整串完全一致的记录，不会做"包含式"模糊搜索。请确保访客输入的编号与表格中的值完全一致。

• 查询字段：前台输入框对应的列（例如 注册编号），可在后台「查询设置」修改为其列名。
• 自定义查询字段V1/V2/V3 均支持：支持把任意列设为可查询字段。前台即可切换按不同列查询——既能按编号查，也能按姓名、手机号等查，更灵活。

• Logo：后台「Banner」标签上传（≤2MB，支持 SVG）。V1 仅支持文字 Logo，V2 / V3 支持本地图片上传。
• 背景图：同上，≤5MB 或填写外链 URL。V1 仅支持外链 URL，V2 / V3 支持本地上传。
• 前台说明卡片：后台「前台说明」标签可设置标题、正文与过期提示文案，展示在查询表单下方。

V2 / V3 支持 在 Excel 中，给该记录的「查询字段」单元格设置删除线字体即可。前台查询到该行时，会自动加删除线、黄底高亮，并弹出过期提示；提示文案可在后台「前台说明」中自定义（如"该信息已失效，请留意"）。

V3 专属 在后台「查询设置」的「加计字段」中，填入需要求和的列名，多个用逗号分隔（如 任务金额,工单数量）。系统仅对数值列累加，并在结果底部显示合计行。加计列不参与单元格合并。

V3 专属 当相邻记录在指定列的值相同时，前台会自动纵向合并相同单元格，让重复信息更紧凑、阅读更清爽。在移动端，结果则改为分区卡片展示，每条记录独立成卡，更适合手机浏览。

默认后台入口为 /admin.php。

V2 / V3 支持在「安全设置」中修改后台文件名（改名后会复制出新文件并禁用旧入口），提升后台隐蔽性，降低被扫描爆破的风险。

推荐使用官方「密码重置工具」reset.php 一键重置：

• 将 reset.php 上传到查询系统根目录，用浏览器访问该文件；
• 点击「确定」即随机生成 6 位数字密码，以 bcrypt 写入 config.php 并自动删除自身；点击「取消」则不做任何改动并自毁。
• 用该 6 位临时密码登录后台，登录后请立即修改为新的正式密码。
• ⚠️ 用完后务必人工确认 reset.php 已自删成功；若服务器防篡改 / 防火墙权限导致自动删除失败，需手动删除，切勿长期保留在正式环境。如需再次重置，重新上传即可。

若不便使用重置工具，也可手动打开根目录 config.php，将 admin_password 改为新的密码哈希（V2 / V3 用 bcrypt；V1 用 SHA-256，旧 sha256 密码首次登录后会自动升级为 bcrypt）。建议由有服务器文件权限的人员操作，改完保存即可用新密码登录。

出于安全考虑，连续输错 5 次密码会锁定后台 10 分钟（基于会话），锁定期间无法登录。

请等待 10 分钟后再试，或按上一条方式重置密码。

V2 / V3 具备三重防护：

• CSRF 防护：后台关键操作附带令牌，防止跨站请求伪造。
• bcrypt 密码加密：密码不以明文存储。
• 登录失败锁定：5 次错误锁定 10 分钟。

V1 不含上述防护，不建议用于生产环境。

请依次排查：

• 文件是否为 .xls 格式（xlsx / csv 不会被识别）；
• 文件名是否含非常用或系统保留字符；
• 是否成功上传到数据目录（默认 biaoge/）。

确认无误后刷新前台页面即可在下拉框看到新表。

说明表格中不存在与后台「查询字段」设置的名字完全一致的列。常见原因：表头多了空格、或用了半角/全角字符不一致。

解决办法：核对表头文字是否与后台配置一致，或把后台的查询字段改为表格中实际存在的列名。

上传失败通常来自两类原因，可分别排查：

• 服务器目录权限不足：系统需将数据目录（默认 biaoge/）写入上传的文件。若该目录对 Web 服务进程（如 Linux 下的 www / www-data 用户，或 Windows 下 IIS 应用池身份）没有写入权限，或目录被设为只读、处于服务器防篡改 / 文件锁保护之下，上传会因无法落盘而失败。请确认目录权限已正确授予 Web 进程，且未被安全软件拦截。
• 本地文件被占用导致写入不完整：上传前若本地 Excel 仍打开着该表格，操作系统会对其加文件锁（占用文件句柄）。此时读取到的文件内容可能不完整，或在传输过程中被中断，导致上传的文件缺失、损坏或中途失败。建议上传前先关闭本地 Excel 再操作，确保文件未被任何进程占用。

排除以上两点后重新上传；若仍失败，可检查服务器错误日志或磁盘剩余空间。

这是后台「加计字段」中仍保留着默认列名所致——只要该字段非空，系统就会在结果底部生成合计行（即便只查到一条记录）。

解决办法：进入后台「查询设置」的「加计字段」，将其中内容清空（留空）并保存；前台查询结果即不再显示合计行。