PHP中草药查询系统：单表设计+全文检索实战-北京尧图网络

简介本资源是一套基于PHP开发的中草药数据查询网站模板面向计算机专业学生及Web开发初学者解决中医药知识数字化查询与快速建站需求适用于毕业设计、课程设计或小型工具类项目实践。压缩包共8个文件含2个核心PHP后端逻辑文件、2个GIF格式界面示意图、2个DAT格式中草药原始数据文件涵盖6024条完整条目、1个CSS样式文件及1个.htaccess配置文件整体大小4.21MB结构精简便于理解前后端交互与数据加载机制。已有90人学习下载体现了实用型教学资源的持续关注度。用户可直接部署运行获得完整的中草药数据检索功能配套使用说明清晰指引环境配置与数据导入流程源码层次分明PHP逻辑与HTML前端分离适合学习数据库查询封装、静态资源组织及基础Web安全配置。1. 一个能直接跑起来的中草药查询网站不是静态页面是带搜索、分类、详情页的完整 PHP Web 应用你下载到手的这个zhongcaoyao.zip不是一份 PDF 文档也不是几个零散 HTML 文件拼凑的“网页”而是一个可部署、可运行、可修改的完整 PHP 网站项目。它内置了 6024 条经人工核对的中草药结构化数据含名称、别名、性味、归经、功效、主治、用法用量、禁忌、药材图谱等字段前端用原生 HTMLCSSJavaScript 实现响应式布局后端用 PHP 原生脚本处理数据查询与路由分发不依赖 Laravel、ThinkPHP 等框架也不需要 Composer 安装依赖。这意味着你把它丢进任何支持 PHP 7.2 和 MySQL 5.6 的环境XAMPP、WAMP、宝塔面板、甚至阿里云轻量应用服务器解压、导入数据库、改两行配置3 分钟内就能在浏览器里输入http://localhost/zhongcaoyao看到一个带搜索框、左侧分类导航、右侧药材列表、点击跳转详情页的完整工具站。它适合计算机专业学生做毕业设计——逻辑清晰、模块边界明确、无黑盒封装也适合中医爱好者快速搭建私有知识库——数据可导出、字段可扩展、UI 可重写。关键在于它把「数据」和「交互」真正耦合成了一个可执行体而不是一堆待拼接的素材。2. 数据结构设计与 MySQL 表构建为什么用单表而非关系型拆分2.1 中草药数据的业务特征决定存储选型6024 条数据看似庞大但每条记录本质是强聚合、弱关联的实体一条“人参”记录已包含其全部属性性味归经、功效主治、用法禁忌等不存在“一个药材对应多个产地”或“一个功效被多个药材共享”的典型多对多场景。强行拆分为herbs、properties、effects等多张表反而会增加 JOIN 查询复杂度、降低全文检索效率并给 PHP 层的数据组装带来冗余循环。因此项目采用单表宽字段设计既保证查询性能又简化开发逻辑。2.2herbs表结构详解与建表语句数据库表名为herbs共 18 个字段核心字段说明如下其余为辅助字段如id、created_at字段名类型说明是否索引nameVARCHAR(100)药材正名如“人参”是全文索引aliasTEXT别名集合如“棒槌、人衔、鬼盖”用分隔tasteVARCHAR(50)性味如“甘、微苦微温”否meridianVARCHAR(200)归经如“脾、肺、心经”否effectTEXT功效如“大补元气复脉固脱…”是全文索引indicationTEXT主治如“体虚欲脱肢冷脉微…”是全文索引usageTEXT用法用量含煎服、外用等否contraindicationTEXT禁忌如“不宜与藜芦同用”否image_urlVARCHAR(255)药材图片路径相对路径如/images/rshen.jpg否提示alias、effect、indication字段使用TEXT类型而非VARCHAR是因为部分药材描述超长如“黄芪”功效描述达 327 字VARCHAR(255)会截断。MySQL 5.6 对TEXT字段支持全文索引满足模糊搜索需求。建表 SQL 如下需在 phpMyAdmin 或命令行执行CREATE TABLE herbs ( id int(11) NOT NULL AUTO_INCREMENT, name varchar(100) NOT NULL, alias text, taste varchar(50) DEFAULT NULL, meridian varchar(200) DEFAULT NULL, effect text, indication text, usage text, contraindication text, image_url varchar(255) DEFAULT NULL, created_at timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), FULLTEXT KEY ft_name_effect_indication (name,effect,indication) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;2.3 数据导入从 CSV 到 MySQL 的三步落地项目包内data/zhongcaoyao.csv是 UTF-8 编码的逗号分隔文件首行为字段名。导入时需注意三点编码必须为 utf8mb4避免中药名中的生僻字如“䗪虫”、“䗪”显示为?字段顺序需严格匹配CSV 第 1 列对应name第 2 列对应alias依此类推空值处理CSV 中空单元格应映射为 MySQL 的NULL而非字符串NULL。推荐使用 phpMyAdmin 导入比命令行更容错进入目标数据库 → “导入”标签页 → 选择zhongcaoyao.csv→ 格式选CSV→ 勾选“使用第一行作为字段名” → 字符集选utf8mb4→ 点击“执行”。若遇报错“字段数量不匹配”检查 CSV 是否存在隐藏的 BOM 头可用 VS Code 以 UTF-8 无 BOM 格式另存。2.4 验证数据完整性三条关键 SQL 查询导入完成后执行以下查询确认数据质量-- 1. 检查总记录数是否为 6024 SELECT COUNT(*) FROM herbs; -- 2. 检查是否存在 name 为空的脏数据应返回 0 SELECT COUNT(*) FROM herbs WHERE name OR name IS NULL; -- 3. 检查 image_url 是否全部指向有效路径需结合文件系统验证 SELECT name, image_url FROM herbs WHERE image_url NOT LIKE /images/%;若第 3 条返回结果说明部分药材图片未放入public/images/目录需手动补全——这是部署后首页图片 404 的最常见原因。3. PHP 后端逻辑解析从 URL 路由到 JSON 接口输出3.1 路由机制index.php如何接管所有请求项目未使用.htaccess重写而是采用PHP 前端控制器模式。所有 HTTP 请求如/search?q人参、/detail?id123均被 Apache/Nginx 配置为统一指向index.php。index.php开头即解析$_SERVER[REQUEST_URI]提取路径参数并分发至对应处理器// index.php 核心路由逻辑 $request_uri parse_url($_SERVER[REQUEST_URI], PHP_URL_PATH); $segments array_filter(explode(/, $request_uri)); if (count($segments) 2) { $action $segments[1]; switch ($action) { case search: require_once api/search.php; // 执行搜索逻辑 break; case detail: require_once api/detail.php; // 执行详情逻辑 break; case category: require_once api/category.php; // 执行分类逻辑 break; default: include pages/home.php; // 默认首页 } } else { include pages/home.php; }注意此设计规避了 Apache 的mod_rewrite依赖使项目在宝塔、XAMPP、甚至部分共享主机上均可运行。但要求 Web 服务器将 404 错误重定向至index.phpNginx 需配置try_files $uri $uri/ /index.php?$query_string;。3.2 搜索接口api/search.php的实现细节该文件接收GET参数q搜索关键词执行三阶段匹配精确匹配name字段WHERE name ?全文匹配nameeffectindicationMATCH(name, effect, indication) AGAINST(? IN NATURAL LANGUAGE MODE)模糊匹配alias字段WHERE alias LIKE ?将q包裹为%关键词%。最终合并结果并去重按匹配权重排序精确匹配全文匹配别名匹配。关键代码段如下// api/search.php $q trim($_GET[q] ?? ); if (empty($q)) { echo json_encode([code 400, msg 搜索关键词不能为空]); exit; } // 预处理去除空格转义特殊字符防 SQL 注入 $q_safe mysqli_real_escape_string($conn, $q); // 阶段一精确匹配 name $sql_exact SELECT id, name, alias, taste, image_url FROM herbs WHERE name $q_safe; // 阶段二全文匹配需确保表已建 FULLTEXT 索引 $sql_fulltext SELECT id, name, alias, taste, image_url, MATCH(name, effect, indication) AGAINST($q_safe IN NATURAL LANGUAGE MODE) AS score FROM herbs WHERE MATCH(name, effect, indication) AGAINST($q_safe IN NATURAL LANGUAGE MODE); // 阶段三别名模糊匹配因 alias 是 | 分隔字符串需用 LIKE $sql_alias SELECT id, name, alias, taste, image_url FROM herbs WHERE alias LIKE %$q_safe%; // 合并三个结果集用 UNION ALL 并按 score 排序 $sql ($sql_exact) UNION ALL ($sql_fulltext) UNION ALL ($sql_alias) ORDER BY score DESC LIMIT 20; $result mysqli_query($conn, $sql); $data []; while ($row mysqli_fetch_assoc($result)) { $data[] [ id (int)$row[id], name htmlspecialchars($row[name]), alias $row[alias] ?: , taste $row[taste] ?: , image_url $row[image_url] ?: /images/default.jpg ]; } echo json_encode([code 200, data $data]);参数说明htmlspecialchars()防止 XSS 攻击$row[image_url] ?: /images/default.jpg提供兜底图片路径避免详情页因图片缺失导致布局错乱。LIMIT 20控制返回条数防止前端渲染卡顿。3.3 详情页数据组装如何避免 N1 查询api/detail.php接收id参数需一次性获取药材全部字段。若直接SELECT * FROM herbs WHERE id ?则alias字段中|分隔的别名需在 PHP 层explode(|, $row[alias])处理。但更关键的是图片路径的上下文补全数据库存的是/images/rshen.jpg而前端 HTML 中img src...的基准路径是网站根目录因此无需额外拼接。若部署在子目录如http://localhost/myproject/zhongcaoyao则需在config.php中配置BASE_URL常量并在模板中使用?php echo BASE_URL . $herb[image_url]; ?。4. 前端交互实现HTML 模板与 JavaScript 搜索逻辑4.1 页面结构基于!doctype htmlhtml langzh-cn的标准化骨架项目所有 HTML 文件pages/home.php、pages/detail.php均以标准 HTML5 文档类型开头并强制声明中文语言!doctype html html langzh-cn head meta charsetutf-8 meta nameviewport contentwidthdevice-width, initial-scale1.0 meta namedescription content中草药大全6024条权威数据支持名称、功效、主治多维度查询 title中草药大全 - 专业中医药查询工具/title link relstylesheet href/css/style.css /head body !-- 页面主体 -- /body /html注意meta charsetutf-8必须置于title之前否则 IE 旧版可能解析失败langzh-cn告知屏幕阅读器使用简体中文语音提升无障碍访问体验。4.2 搜索框的防抖与异步加载首页搜索框input idsearchInput typetext placeholder请输入药材名、功效或主治...绑定input事件但不每次按键都发请求。通过 JavaScript 实现 300ms 防抖let searchTimer; document.getElementById(searchInput).addEventListener(input, function() { clearTimeout(searchTimer); const keyword this.value.trim(); if (keyword.length 2) { document.getElementById(searchResults).innerHTML ; return; } searchTimer setTimeout(() { fetch(/search?q${encodeURIComponent(keyword)}) .then(res res.json()) .then(data { if (data.code 200 data.data.length 0) { let html ul classsearch-list; data.data.forEach(item { html lia href/detail?id${item.id}${item.name} ${item.alias ? (${item.alias.split(|)[0]}) : }/a/li; }); html /ul; document.getElementById(searchResults).innerHTML html; } else { document.getElementById(searchResults).innerHTML p classno-result未找到相关药材/p; } }) .catch(err console.error(搜索请求失败:, err)); }, 300); });关键点encodeURIComponent(keyword)确保中文关键词正确编码item.alias.split(|)[0]仅显示第一个别名避免下拉列表过长ul classsearch-list结构便于 CSS 定制样式且语义化优于div堆砌。4.3 分类导航的动态生成从数据库读取高频归经左侧分类栏“归经分类”并非写死而是由api/category.php查询数据库中出现频次最高的meridian值生成// api/category.php $sql SELECT meridian, COUNT(*) as cnt FROM herbs WHERE meridian ! AND meridian IS NOT NULL GROUP BY meridian ORDER BY cnt DESC LIMIT 12; $result mysqli_query($conn, $sql); $categories []; while ($row mysqli_fetch_assoc($result)) { // 将“脾、肺、心经”拆分为独立标签 $meridians array_map(trim, explode(、, $row[meridian])); foreach ($meridians as $m) { if (!in_array($m, $categories) strlen($m) 10) { $categories[] $m; } } } echo json_encode([code 200, data $categories]);前端通过 AJAX 加载后动态插入a href/category?meridian脾经脾经/a链接。这种设计让分类栏随数据分布自动演进无需人工维护。5. 部署调试与常见问题排查从本地 XAMPP 到线上服务器5.1 本地环境快速验证清单在 XAMPP/WAMP 启动 Apache 和 MySQL 后按顺序执行以下检查数据库连接测试打开config.php确认$host、$username、$password、$database与 phpMyAdmin 登录信息一致文件权限检查public/images/目录需有读取权限Windows 通常默认满足Linux 需chmod 755 public/imagesPHP 配置验证访问http://localhost/phpinfo.php自行创建确认mysqli扩展已启用short_open_tag为Off项目未用?简写故无影响URL 重写模拟若无法配置.htaccess直接访问http://localhost/zhongcaoyao/index.php/search?q人参测试接口是否返回 JSON。5.2 三类高频报错及修复方案报错现象根本原因解决方案“Warning: mysqli_connect(): php_network_getaddresses: getaddrinfo failed”config.php中$host写成localhost但 MySQL 服务监听127.0.0.1将$host改为127.0.0.1或在 MySQL 配置中添加bind-address 0.0.0.0搜索返回空数组但数据库有数据MySQL 全文索引未生效MyISAM 引擎不支持中文分词InnoDB 需ngram插件确认表引擎为InnoDB并在 MySQL 配置文件my.cnf中添加ngram_token_size 2重启 MySQL详情页图片 404路径显示为/images/rshen.jpg但实际文件在/zhongcaoyao/public/images/项目未部署在网站根目录而image_url存储的是绝对路径修改config.php中BASE_URL为/zhongcaoyao/并在模板中拼接img src?php echo BASE_URL . $herb[image_url]; ?5.3 生产环境加固建议关闭错误显示在config.php末尾添加ini_set(display_errors, 0); error_reporting(0);防止敏感路径泄露SQL 注入防御升级将mysqli_real_escape_string()替换为预处理语句mysqli_prepare()虽项目当前无高危风险但符合安全最佳实践静态资源缓存在.htaccess中添加ExpiresActive On规则为/css/、/js/、/images/目录设置 1 年缓存减少重复请求。提示若使用宝塔面板可在网站设置 → “伪静态” 中粘贴 ThinkPHP 规则因其兼容前端控制器模式或直接选择“Laravel 5.6”规则效果相同。本文还有配套的精品资源点击获取

PHP中草药查询系统：单表设计+全文检索实战

相关推荐

Vector 移除 `http` source 与 `greptimedb` sink 废弃别名：升级迁移完整指南

别再抄减肥食谱了！用体脂率和基础代谢定制你的饮食方案

Automatisch 连接 Mailchimp：OAuth 应用注册与连接配置实战指南

更多资讯

AI时代开源项目信任管理：Vouch机制解析与实践