简介：这是一套面向PHP开发者与医疗信息化学习者的开源中医诊所后台管理系统，基于PHP构建，配套预配置数据库，可快速搭建部署，适合用于课程设计、二次开发或诊所业务管理场景。压缩包共约2000个文件，整体12.45MB，以JavaScript、Less、HTML、PHP为主，辅以JSON配置、Markdown说明、CSS样式及图片字体等静态资源，前后端结构完整。项目涵盖MySQL数据存储、MVC分层架构、身份验证与RBAC权限控制、RESTful API设计、前端响应式界面以及数据加密、防注入等安全实践，并涉及缓存优化、错误日志与Git版本管理等工程要点，对理解Web应用架构与医疗信息化流程有较高参考价值。目前已有928人学习下载，开发者可据此研究后台模块组织方式、数据库表结构与权限逻辑，并在此基础上按诊所实际业务进行定制扩展。
1. 从一份 PHP 中医诊所后台说起：谁在用它，能解决什么
前阵子帮一个做中医理疗的朋友看店，他抱怨每天用 Excel 记患者档案、开方记录和药材库存，月底对账时经常发现某味药材的库存对不上，患者复诊时翻半天找不到上次的方子。这种场景其实很典型——中小型中医诊所、养生馆、理疗店，业务量不大，但手工记账的混乱程度一点不比大医院少。这份 PHP 开源中医诊所后台管理源码，就是冲着这类需求去的：患者建档、就诊记录、处方管理、药材库存、收费统计，一套后台把日常运营的几件事串起来，还自带数据库文件，省去了自己设计表结构的功夫。它适合谁？懂一点 PHP 和 MySQL、想给诊所或养生馆搭个内部管理系统的开发者，或者拿它当毕业设计、课程作业的底座来二次开发。技术栈不花哨，PHP + MySQL + 原生或轻量框架，部署门槛低，改起来也顺手。
2. 技术栈与目录结构：先看清这套后台的骨架
2.1 技术选型：为什么是 PHP + MySQL 而不是别的
拿到源码包，第一件事不是急着往服务器上扔，而是先看它用了什么。这套中医诊所后台的技术栈很明确：服务端 PHP，数据库 MySQL，前端大概率是 Bootstrap 或类似的轻量 UI 框架，配合 jQuery 做交互。为什么这类项目普遍选 PHP？原因很实际——中小诊所的服务器预算有限，虚拟主机就能跑，PHP 环境几乎零配置；MySQL 更是标配，数据量不大，单库足够撑住几千到几万条患者记录。
从项目标题里的「带数据库」能推断出，压缩包里应该包含.sql文件，导入后表结构、初始数据都有了。常见做法是：config.php或database.php里集中配置数据库连接，用 PDO 或 mysqli 做数据访问。我一般会先打开这个配置文件，确认连接方式，再决定后续怎么改。
提示：如果源码里用的是 mysqli 而不是 PDO，二次开发时建议逐步替换成 PDO，预处理语句对防 SQL 注入更友好，尤其是患者姓名、电话这类用户输入字段。
2.2 目录结构：从入口文件到模块划分
虽然没看到实际文件列表，但这类 PHP 后台的目录结构有规律可循。典型的布局是这样：
/ 根目录 ├── index.php # 登录入口或仪表盘 ├── config.php # 数据库连接与全局配置 ├── /admin # 后台模块目录 │ ├── patient.php # 患者管理 │ ├── visit.php # 就诊记录 │ ├── prescription.php # 处方管理 │ ├── stock.php # 药材库存 │ └── report.php # 统计报表 ├── /includes # 公共函数与头部尾部 │ ├── header.php │ ├── footer.php │ └── functions.php ├── /assets # CSS、JS、图片 └── clinic.sql # 数据库导出文件这个结构的好处是模块清晰，每个业务功能一个文件，改哪个模块就动哪个文件，不会牵一发动全身。includes/functions.php通常是公共函数集中地，比如权限校验、数据过滤、分页逻辑，二次开发时优先看这里，能省不少重复代码。
2.3 数据库表设计：核心几张表的关系
「带数据库」意味着表结构已经定好了。中医诊所后台的核心表一般包括：
| 表名 | 用途 | 关键字段 |
|---|---|---|
patients | 患者档案 | id, name, gender, phone, age, created_at |
visits | 就诊记录 | id, patient_id, visit_date, doctor, symptoms |
prescriptions | 处方 | id, visit_id, herbs, dosage, notes |
herbs | 药材库存 | id, name, stock_qty, unit, price |
users | 后台用户 | id, username, password, role |
visits通过patient_id关联patients，prescriptions通过visit_id关联visits，这样一次就诊对应一张处方，患者复诊时能按时间线拉出全部记录。药材库存单独一张表，处方里的药材用量可以反向扣减库存——这是很多简易系统容易漏掉的一环，如果源码里没做，二次开发时值得补上。
3. 跑起来：从导入数据库到登录后台的完整步骤
3.1 环境准备：PHP 版本与扩展检查
在部署之前，先确认环境。PHP 建议 7.4 以上，8.x 也能跑，但要注意有些老代码用了mysql_*函数，在 PHP 7 之后已经移除，如果源码里出现这类函数，得改成 mysqli 或 PDO。MySQL 用 5.7 或 8.0 都行，字符集选utf8mb4，避免中文姓名或药材名出现乱码。
需要开启的扩展：pdo_mysql或mysqli、mbstring、json。如果是宝塔面板或类似环境，这些默认都有，不用额外折腾。本地开发的话，用 XAMPP 或 phpStudy 一键装好，把源码丢进htdocs或www目录即可。
3.2 导入数据库：命令行与图形化两种方式
拿到.sql文件后，先建库再导入。命令行方式：
# 登录 MySQL mysql -u root -p # 创建数据库，字符集用 utf8mb4 CREATE DATABASE clinic_db DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; # 退出后导入 mysql -u root -p clinic_db < clinic.sql如果习惯图形化工具，phpMyAdmin 或 Navicat 里新建数据库，右键「运行 SQL 文件」，选clinic.sql导入即可。导入完成后，用SHOW TABLES;确认表都建好了，再SELECT * FROM users;看看默认管理员账号是什么——通常源码说明里会写，或者密码字段是 MD5 加密的初始值。
注意：导入前先看一眼
.sql文件头部有没有CREATE DATABASE语句。如果有，直接导入就行；如果没有，必须先手动建库，否则会报「No database selected」。
3.3 配置连接与登录测试
数据库导入后，改config.php里的连接参数：
<?php // 数据库配置 define('DB_HOST', 'localhost'); define('DB_USER', 'root'); // 改成你的 MySQL 用户名 define('DB_PASS', 'your_password'); // 改成你的密码 define('DB_NAME', 'clinic_db'); // 刚才建的库名 // 连接数据库 $conn = new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME); if ($conn->connect_error) { die('连接失败: ' . $conn->connect_error); } $conn->set_charset('utf8mb4'); // 防止中文乱码 ?>这段代码做了三件事：定义常量方便统一修改、建立 mysqli 连接、设置字符集。改完保存，浏览器访问http://localhost/你的目录/index.php，应该能看到登录页。用默认账号登录，如果提示密码错误，去users表里看password字段，可能是 MD5 值，用在线工具反查或直接改成明文再 MD5 一次。
3.4 常见启动失败排查
跑不起来的情况无非几种：白屏、报错、登录后跳回登录页。白屏通常是 PHP 报错被关了显示，在php.ini里把display_errors设为On，或者代码顶部加ini_set('display_errors', 1); error_reporting(E_ALL);。报「Access denied」就是数据库账号密码不对。登录后跳回登录页，多半是 session 没配好，检查session_start()有没有在输出前调用，或者session.save_path是否可写。
4. 核心模块拆解：患者建档、处方管理与库存扣减
4.1 患者管理：从表单提交到入库的完整链路
患者管理是使用频率最高的模块。一个典型的添加患者流程：前端表单提交姓名、性别、电话、年龄，后端接收后先做数据清洗，再插入patients表。看一段简化后的代码：
<?php // patient_add.php 处理患者新增 session_start(); include 'config.php'; // 接收表单数据 $name = trim($_POST['name'] ?? ''); $gender = $_POST['gender'] ?? '未知'; $phone = trim($_POST['phone'] ?? ''); $age = intval($_POST['age'] ?? 0); // 简单校验：姓名和电话不能为空 if ($name === '' || $phone === '') { die('姓名和电话为必填项'); } // 预处理插入，防止 SQL 注入 $stmt = $conn->prepare("INSERT INTO patients (name, gender, phone, age, created_at) VALUES (?, ?, ?, ?, NOW())"); $stmt->bind_param('sssi', $name, $gender, $phone, $age); if ($stmt->execute()) { header('Location: patient_list.php?msg=添加成功'); } else { echo '添加失败: ' . $stmt->error; } $stmt->close(); $conn->close(); ?>这段代码的关键点：trim去掉首尾空格，intval强制年龄为整数，prepare+bind_param做参数绑定。sssi表示四个参数类型分别是字符串、字符串、字符串、整数。很多新手直接拼 SQL 字符串，遇到患者姓名里带单引号就翻车，预处理是必须的。created_at用NOW()由数据库生成，避免 PHP 和 MySQL 时间不一致。
4.2 处方管理：关联就诊记录与药材明细
处方模块比患者管理复杂一层，因为它要关联就诊记录，还要处理药材明细。常见做法是两张表：prescriptions存处方主信息（关联visit_id），prescription_items存每味药材的用量。但简易版可能把药材直接存成文本字段，比如「黄芪 15g，当归 10g」。如果源码是后者，二次开发时建议拆成明细表，方便统计药材用量和扣库存。
看一段处方保存的逻辑：
<?php // prescription_save.php session_start(); include 'config.php'; $visit_id = intval($_POST['visit_id']); $herbs = $_POST['herbs']; // 数组：药材名 $dosages = $_POST['dosages']; // 数组：对应用量 $notes = trim($_POST['notes'] ?? ''); // 开启事务，保证主表和明细表同时成功 $conn->begin_transaction(); try { // 插入处方主记录 $stmt = $conn->prepare("INSERT INTO prescriptions (visit_id, notes, created_at) VALUES (?, ?, NOW())"); $stmt->bind_param('is', $visit_id, $notes); $stmt->execute(); $prescription_id = $conn->insert_id; // 拿到刚插入的处方 ID // 循环插入药材明细 $itemStmt = $conn->prepare("INSERT INTO prescription_items (prescription_id, herb_name, dosage) VALUES (?, ?, ?)"); for ($i = 0; $i < count($herbs); $i++) { $herb = trim($herbs[$i]); $dosage = trim($dosages[$i]); if ($herb === '') continue; // 跳过空行 $itemStmt->bind_param('iss', $prescription_id, $herb, $dosage); $itemStmt->execute(); } $conn->commit(); header('Location: prescription_list.php?msg=处方已保存'); } catch (Exception $e) { $conn->rollback(); echo '保存失败: ' . $e->getMessage(); } ?>事务是这里的关键。处方主表和明细表必须同时写入成功，否则会出现「有处方没明细」的脏数据。insert_id拿到刚插入的主键，再作为外键写入明细表。循环里跳过空行，避免用户误提交空药材。如果源码里没用事务，二次开发时补上，这是数据一致性的基本保障。
4.3 库存扣减：处方开出后药材数量怎么变
库存扣减是中医诊所后台里最容易出 bug 的地方。理想流程是：处方保存成功后，根据药材明细扣减herbs表的stock_qty。但实际操作中，药材名称可能和库存表里的名称不完全匹配，比如处方写「黄芪」，库存表里是「炙黄芪」，直接扣减就会失败。
常见做法是加一个名称匹配逻辑，或者让开方时从库存表下拉选择，而不是手输。如果源码里没做，二次开发时可以加一个「库存校准」功能，定期对比处方用量和库存余量。扣减代码大致这样：
<?php // 在处方保存成功后调用 function deductStock($conn, $herbName, $dosage) { // 从用量字符串里提取数字，比如 "15g" -> 15 preg_match('/(\d+)/', $dosage, $matches); $qty = intval($matches[1] ?? 0); if ($qty <= 0) return; // 扣减库存，同时保证不会扣成负数 $stmt = $conn->prepare("UPDATE herbs SET stock_qty = stock_qty - ? WHERE name = ? AND stock_qty >= ?"); $stmt->bind_param('isi', $qty, $herbName, $qty); $stmt->execute(); if ($stmt->affected_rows === 0) { // 库存不足或药材名不匹配，记录日志 error_log("库存扣减失败: {$herbName} 用量 {$qty}"); } } ?>stock_qty >= ?这个条件很重要，防止库存扣成负数。affected_rows === 0说明要么药材名对不上，要么库存不够，记日志方便后续排查。如果源码里没有这个逻辑，建议加上，不然月底盘点时库存对不上，又是一笔糊涂账。
5. 避坑与常见问题：部署和二次开发中容易翻车的地方
5.1 中文乱码：从数据库到页面的字符集链路
现象：患者姓名显示成「??」或「æŽå°」。原因通常是某一环字符集不统一——数据库建库时用了latin1，或者连接时没设utf8mb4，或者 PHP 文件本身不是 UTF-8 编码。解决：建库用utf8mb4，连接后执行$conn->set_charset('utf8mb4')，PHP 文件保存为无 BOM 的 UTF-8。三处都对齐，乱码基本消失。
5.2 登录 session 丢失：为什么登录后跳回登录页
现象：输入正确账号密码，点登录后又回到登录页。原因通常是session_start()没有在页面最顶部调用，或者session.save_path目录不可写。解决：确保session_start()在任何输出之前，检查php.ini里的session.save_path路径是否存在且可写。如果是虚拟主机，可能需要在代码里指定session_save_path('./tmp')。
5.3 SQL 注入：患者姓名里带单引号就报错
现象：添加患者时姓名填「O'Brien」，提交后报 SQL 语法错误。原因是用字符串拼接 SQL，单引号破坏了语句结构。解决：所有用户输入都用prepare+bind_param处理。如果源码里还有拼接的地方，逐个改成预处理，这是安全底线。
5.4 库存扣减失败：药材名对不上导致库存不变
现象：处方开出去了，但库存数量没变。原因通常是处方里的药材名和库存表里的名称不完全一致，或者扣减逻辑根本没写。解决：开方时从库存表下拉选择药材，避免手输；扣减时加日志，记录哪些药材没匹配上，定期人工校准。
5.5 权限控制缺失：普通用户能删患者记录
现象：用普通账号登录后，居然能删除患者或修改处方。原因：源码可能只做了登录校验，没做角色权限。解决：在users表里加role字段，删除、修改等敏感操作前判断$_SESSION['role'] === 'admin'。如果源码里没有权限模块，这是二次开发优先补的功能。
6. 二次开发：从能用变成好用，几个改造方向
这套后台的底子不错，但要用得顺手，还得按自己的业务改。第一个方向是权限细化。源码可能只有「登录/未登录」两种状态，实际诊所里，前台、医生、库管、管理员的操作范围完全不同。在users表加role字段，includes/functions.php里加一个checkRole($allowed)函数，每个敏感页面顶部调用，不匹配就跳转。这个改动不大，但能避免很多误操作。
第二个方向是处方模板。中医开方有常用组合，比如「四君子汤」「六味地黄丸」的加减，每次手输药材效率低。加一张prescription_templates表，存模板名称和药材明细，开方时一键载入，再微调用量。这个功能对老中医特别友好，能省不少敲键盘的时间。
第三个方向是数据导出。诊所经常需要把某段时间的就诊记录导出来做统计或上报。用 PHP 的fputcsv生成 CSV，或者引入 PhpSpreadsheet 生成 Excel，按日期范围查询visits和prescriptions，导出成表格。代码不复杂，但实用价值高。
第四个方向是库存预警。在herbs表加一个min_qty字段，库存低于这个值时，后台首页显示提醒。查询逻辑很简单：SELECT * FROM herbs WHERE stock_qty < min_qty，结果渲染成红色列表。这个小功能能帮诊所避免「开方时才发现没药」的尴尬。
改造时有个习惯我一直保持：每次改完一个模块，先在本地用测试数据跑一遍完整流程，从添加患者到开方到扣库存，确认数据链路没断。有次改库存扣减逻辑，忘了处理药材名带空格的情况，结果测试时发现「黄芪 」和「黄芪」匹配不上，库存没扣。从那以后我每次改数据库相关代码，都强制走一遍「增删改查 + 边界值」的测试流程。希望这些经验帮到你，拿到源码后先跑通，再按自己的业务慢慢磨。
本文还有配套的精品资源，点击获取
