简介一份面向PHP开发者及医疗信息化学习者的开源中医诊所后台管理系统专为中医诊所的管理场景设计可支撑患者信息、预约记录、药品库存等业务模块的运转与维护。项目基于PHP和MySQL构建覆盖MVC架构、用户认证与RBAC权限控制、RESTful API、数据安全防护、缓存与日志处理等核心技术点既适合学习Web应用架构也便于按实际需求二次开发。压缩包共含2000个文件以php、js、css、html等前后端代码为主附带sql数据库脚本及大量配置、说明文档整体大小12.45MB目录层级清晰便于定位关键代码与资源。目前已有928人学习下载从数据库设计到接口交互均包含可参考的实践代码对于想掌握PHP医疗后台开发或快速搭建诊所管理系统的开发者是一份可部署、可研读、可扩展的完整示例。1. 拿到「PHP开源中医诊所后台管理」压缩包先看它能解决什么这个包在 PHP 圈子里流传很广一套轻量后台装着患者档案、处方开单、药材库存、收费结算这些模块再附带一份 MySQL 的 SQL 文件解压就能装。对个体中医诊所和小型门诊来说Excel 管方子和药材撑不了一年买商业 HIS 重且贵——这套开源的 PHP 后台正好卡在中间解压、配库、登录一天内跑起来就能用。对开发者来说它也是一个完整的 PHP 增删改查样本表结构、登录鉴权、前后台交互全都有。它适合三类人想零成本上线的诊所运营者接外包想短平快交付的开发者以及想看着真实业务把 PHPMySQL 功底补齐的新手。后面五章我把这套东西从头拆开源码包里哪些目录有用、数据库怎么导、本地怎么跑通、中医业务表能否适配你的需求最后落在常见坑和二次开发的改法上。2. 拆开源码包先认目录再导入数据库2.1 解压后先看三个关键目录别急着双击 index.php拿到压缩包后第一个动作是解压Windows 直接右键Linux 服务器用 unzip。常见做法是先铺开目录树再动手不要一头扎进代码。像这类带后台的 PHP 源码包通常会有三个核心区域入口与控制器根目录的 index.php 和几个 include 文件夹、模板与样式view 或 template 目录、数据库文件通常叫 database.sql 或 db.sql放在根目录或 sql 目录。如果包里带着 install 目录说明有图形安装向导没有就按下面手导 SQL。mkdir -p /data/www/clinic cd /data/www/clinic unzip ../PHP开源中医诊所后台管理【带数据库】.zip -d . # 列出顶层结构确认入口文件和 SQL 文件的位置 ls -lh find . -maxdepth 2 -name *.sql -o -name index.php | sort这段命令把压缩包解到站点目录然后定位两个关键对象入口的 index.php 和数据库脚本。很多人拿到包直接双击 index.php结果白屏或一堆报错十有八九是数据库没导入或者 PHP 环境压根没解析。先确认文件在合适的位置再确认 PHP 能正常运行顺序不能反。用 find 额外找一次 SQL 文件的另一个好处是防漏有的打包者会把 SQL 藏在 admin/sql/ 这种二级目录下只翻根目录会错过。2.2 导入 SQL命令行比 phpMyAdmin 更少出乱子数据库导入是这套包能否跑通的第一道坎。SQL 文件通常包含建库、建表、插入初始数据三部分有的包连 CREATE DATABASE 都写在里面有的要求你先建库再 source。我一般建议先建库再导入避免字符集声明混在一起。mysql -uroot -p -e CREATE DATABASE IF NOT EXISTS clinic DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; mysql -uroot -p clinic database.sql # 确认表数量和关键表 mysql -uroot -p -e USE clinic; SHOW TABLES;这里用 utf8mb4 而不是 utf8在于处方里可能出现生僻药名和冷门汉字四字节字符集能兜住。默认字符集不统一是后面中文乱码的根源所以建库时就把字符集钉死。导入后务必用 SHOW TABLES 看一眼如果表是空的或数量对不上先怀疑 SQL 文件自身编码再怀疑导入时选错了库。还有一个排错技巧导入时把错误直接重定向到文件方便回溯。mysql -uroot -p clinic database.sql 2 import_error.log2.3 环境选型PHP 7.4 搭配 MySQL 5.7 是最稳的组合这类打包好的源码多数写于 PHP 5.x 时代代码里可能带 mysql_* 老函数也可能依赖 session、GD 扩展。我建议本地首选 PHP 7.4 加 MySQL 5.7Linux 服务器用宝塔面板或 Docker 固定同版本组合。PHP 8 不是不能用但老代码踩兼容坑的概率直线上升后面避坑章会专门讲。先用一条命令探测环境避免装了高版本再回头折腾。php -v # 确认 PHP 版本 php -m | grep -E mysqli|pdo_mysql|gd|session如果有 mysqli 或 pdo_mysql配置就够如果只有 mysql 老扩展干脆换 PHP 7.4 环境省事。GD 扩展关系到验证码和图片上传的裁剪压缩没有 GD 登录页可能能进但验证码会直接变成红叉。这一步花两分钟能省半天折腾。开发时顺手用 phpstorm 之类的编辑器把整个项目过一遍语法高亮也能快速发现混着旧语法和高版本不兼容的地方。3. 把后台跑起来改配置、起服务、登录后台3.1 改三个数据库参数连接文件里的 host、user、password带数据库的 PHP 源码连接配置一般集中在 config/database.php 或根目录的 config.php偶尔在 inc/。你搜一下 dbname、user、password 三个键名把值改成自己的数据库账号。老包爱用 define 定义常量新一点的用 PDO 数组本质一样让 PHP 知道去哪连库。// config/database.php 常见写法MySQLi define(DB_HOST, 127.0.0.1); // 本机开发用 127.0.0.1别用 localhost define(DB_USER, root); // 线上务必单独建低权限账号 define(DB_PASS, your_password); define(DB_NAME, clinic); // 必须和导入 SQL 时的库名一致 // 老包偶尔还会定义 BASE_URL用于页面跳转和静态资源路径 define(BASE_URL, http://127.0.0.1:8080/);DB_HOST 用 127.0.0.1 还是 localhost在 Linux 上的差异能直接导致连不上库。localhost 会触发 PHP 走 socket127.0.0.1 走 TCPMySQL 默认 socket 路径不一致时就会报 Access denied。BASE_URL 是最容易被忽略的一项很多老包用它拼 CSS、JS 和跳转地址不改的话页面能加载但样式全丢登录成功又弹回登录页。改完配置后顺手验证一下连接用官方 php 内置脚本或简单 PDO 探针都行。?php // 快速验证脚本 check_db.php用完后删除 $conn new mysqli(127.0.0.1, root, your_password, clinic); if ($conn-connect_error) { die(连接失败 . $conn-connect_error); } echo 数据库连接正常; $conn-close();3.2 用 PHP 内置服务器起服务最快验证代码链路配好数据库文件后不必先配 Apache 虚拟主机。让 PHP 内置服务器跑起来是最快的验证方式。内置服务器适合调试访问量上来之后再切 Nginx 或 Apache生产环境不要用它扛压。cd /data/www/clinic php -S 127.0.0.1:8080 # 有多个入口文件时把 router 指到 index.php php -S 127.0.0.1:8080 index.php然后浏览器打开 http://127.0.0.1:8080/。如果跳出登录表单说明 PHP 解析正常数据库连接配置也基本对了。如果白屏把 php.ini 的 display_errors 打开再扫一眼终端输出——绝大多数错误在这就会现形。内置服务器的 router 参数很实用它把请求都转发给 index.php 做前端控制器许多老布局无需单独写 rewrite 规则就能跑通。顺手提一句终端里频繁改动代码后不需要重启内置服务器PHP 每次请求都会重新读文件。3.3 登录后台默认账号与第一眼布局登录后台时默认管理员账号常见是 admin / admin、admin / 123456 或 admin / admin888有的包写死在 install.sql 里有的在 README 里。不用猜直接在数据库里查mysql -uroot -p -e USE clinic; SELECT id, username FROM sys_user;看到用户名后如果密码字段是 MD5可以直接 UPDATE 一条已知 MD5 值进去。登录进去后老包大多是左侧菜单加右部内容的框架结构菜单挂患者管理、处方管理、药品库存、系统设置。首次进入重点看两件事页面 CSS 是否正常菜单点击后地址栏的 path 是否与目录结构吻合——不少包在这两步露馅。菜单里若带着验证码登录框会挡住新手直接用默认账号配合验证码刷新机制试几次即可。3.4 做一次「增删改查」闭环验证后台能打开不等于业务链路完整。强烈建议在系统里真实走一遍流程新增一个患者录入一张处方确认药材库存扣减生成收费单。这一步把核心三张表联动串起来前端、控制器、数据层全链路验证一遍。真出现报错按错误信息倒着改代码比猜测环境问题更高效。-- 验证库存联动处方保存后可用库存是否扣减 SELECT 药品名称, 库存数量 FROM 药材库存 WHERE 药品ID 12;如果库存没动说明老包在处方保存逻辑里没有触发库存更新这就是你要改的业务点。另外观察下 URL 是 GET 参数传 id 还是 POST 表单提交这决定了后续二次开发改动范围老包喜欢把删除、审核都放在 GET 链路上安全性和规范性都差一些。4. 中医业务模块落地患者、病历、处方、库存的表结构拆解4.1 三张核心表和它们的外键关系这类中医诊所后台表设计大同小异patient患者、prescription处方/病历、drug药材或药品、bill结算单。处方表里通常挂着 patient_id 和 doctor_id药品明细另起一张 prescription_detail因为一张处方可以有很多味药。医馆业务和普通门诊不同之处在于复诊率高、证型记录、剂量单位克、配伍禁忌需要备注。老包一般只有处方主表和明细表证型和禁忌靠文本字段硬撑二次开发时可以加字段。-- 常见核心表结构节选 CREATE TABLE patient ( id int(11) NOT NULL AUTO_INCREMENT, name varchar(50) DEFAULT NULL COMMENT 患者姓名, age int(11) DEFAULT NULL, gender tinyint(1) DEFAULT 1 COMMENT 1男 2女, phone varchar(20) DEFAULT NULL, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT患者档案; CREATE TABLE prescription ( id int(11) NOT NULL AUTO_INCREMENT, patient_id int(11) NOT NULL COMMENT 患者ID逻辑外键关联 patient.id, doctor_remark text COMMENT 辨证思路/医嘱, total_amount decimal(10,2) DEFAULT 0.00, create_time datetime DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT处方主表;外键不一定在物理层真的建逻辑上改业务代码时仍按 patient_id → prescription_id → detail_id 这条线找数据。老包不开 FK 的原因是导入数据时怕外键顺序报错这也解释了为什么你看到表结构里没有 FOREIGN KEY 关键词。真要写连表统计先从这几张表出发就不会偏。4.2 方剂明细表剂量单位是第一个要对齐的地方中药计量单位是“克”但也会出现“片”“袋”“付”。老包最常见的坑是把单位写死在字段里剂量字段配个 varchar 自由填统计时根本没法聚合。落地时我一般建议剂量存纯数字单位用字典统一管理显示层再拼接单位这样“12 克”和“12 袋”不会在汇总时混成 24。// 处方明细保存PDO 预处理单位 g 存数字 $sql INSERT INTO prescription_detail (prescription_id, drug_id, drug_name, dose, unit, price, amount) VALUES (:pid, :did, :dname, :dose, :unit, :price, :amount); $stmt $pdo-prepare($sql); $stmt-execute([ :pid $prescriptionId, :did $drugId, :dname $drugName, :dose 12, // 12 克 :unit g, :price 0.18, // 每克单价 :amount 12 * 0.18, // 单味药合计 ]);用 PDO 预处理除了防注入还让同一条语句反复复用。一张处方动辄十几味药逐条拼 SQL 既慢又容易出引号问题。amount 字段在库里存 2.16 这种数值后期对账建议在数据库层改成 DECIMAL(10,3)做账时再四舍五入到分避免浮点误差累积到账单汇总。做库存概览时把这个表 LEFT JOIN 药表就能得到每种药材近三个月的用量趋势。4.3 药材库存与预警低于安全库存就该提醒库存表是这套系统里最实用的一张表药名、规格、库存量、安全库存阈值、采购价都必须有。预警逻辑很简单一条 SQL 就能拉出需要补货的药材。最好额外带一个 update_time方便判断库存数据新不新鲜。SELECT drug_id, drug_name, stock, safe_stock FROM drug WHERE stock safe_stock ORDER BY (stock - safe_stock) ASC;配合后台仪表盘把这条 SQL 放到首页统计里运营每天打开系统就能看到缺货药材。有的包没有安全库存字段需要手动加列并回填默认值这时用 ALTER TABLE 是常规操作。改表结构前一定先备份一个 mysqldump 命令就是后悔药mysqldump -uroot -p clinic clinic_before_alter.sql日常备份可以做成定时任务每天凌晨导一次这样即使后面改动翻车也能恢复到前一天状态。我自己的习惯是配置保留最近 7 份备份避免把磁盘跑满。4.4 收费结算金额精度和尾差处理收费单的金额涉及多个明细求和、折扣、抹零小数点容易出事。老包很多在 PHP 层用 float 叠加最后显示 14.400000000000002 之类脏数。处理办法是数据库字段用 DECIMAL(10,2)PHP 端所有金额计算用 bcmath 扩展或者在最外层 round($total, 2) 兜底。$total round((float)$subtotal, 2); $sql UPDATE bill SET pay_amount {$total} WHERE id {$billId};round 是高性价比的兜底但要较真每一笔账还是上 bcadd。这个坑在小诊所一天十几张单时看不出一旦对接电子对账单尾差就会被放大。数据同步到生产库时也建议用 mysqldump 导出的 SQL 方式避免图形化工具在高版本之间跳字符集。收银人员最容易抱怨的另一件事是“一张处方改一味药必须整单重开”这是设计决定的无法靠配置解决。5. 常见问题排查与避坑老 PHP 项目的五个经典翻车现场5.1 页面白屏PHP 完全不响应现象访问 index.php 直接白屏源代码也看不全。原因老代码用了 mysql_* 系列函数PHP 7 之后这些函数被彻底移除代码一旦走到查数据库就触发 fatal error。另一种可能是 Web 服务根本没做 rewrite访问路径全部 404。解决按优先级来先在终端执行 php -l index.php 做语法检查再看扩展列表里有没有 mysqli、pdo_mysql最后看 Web 服务错误日志。血泪经验Windows 下文件带 BOM 也可能导致输出前就有空白字符用编辑器另存为 UTF-8 without BOM 可以解决。如果项目有一堆文件写一个小循环把所有 .php 文件批量语法检查比手工一个个快。5.2 SQL 导入一半报错或导入后中文乱码现象SQL 文件拖进 phpMyAdmin 执行中途报错导入成功但后台里全是问号。原因SQL 文件本身是 GBK 编码导入到 utf8 库必然乱码或者命令行客户端默认字符集和文件声明不一致。解决用文本编辑器把 .sql 另存为 UTF-8再在建库语句上钉死 utf8mb4。这里有个额外陷阱很多老 SQL 文件里包含 DROP TABLE直接导入会冲掉已有库导入前先看一眼文件头部别把生产库当成演练场。乱码不要慌改完字符集重导一次别在错误字符集上硬修数据。判断 SQL 文件编码可以用 file 命令或编辑器右下角状态栏直接看。5.3 登录成功又跳回登录页形成死循环现象账号密码都对后台登录成功两秒后又弹回登录表单。原因登录态存在 session 里但 BASE_URL 或 cookie 域没配对也可能 session 目录不可写。解决先把 config 里 BASE_URL 改成实际访问地址再把 php.ini 的 session.save_path 指到可写目录并重启 PHP。另一种隐蔽原因是页面经过两次重定向cookie 没有稳定种到当前域名。开发时统一用 127.0.0.1 访问不要一会 localhost 一会 127.0.0.1。在登录成功的跳转前加一句打印当前 session_id能快速确认 cookie 是否种上。5.4 图片上传成功但显示不出来路径全是反斜杠现象后台能传患者头像和病历图片前端 img 标签 src 却是 file://C:... 之类。原因Windows 开发环境下用 DIRECTORY_SEPARATOR 拼路径返回反斜杠拼进 URL 后浏览器无法解析。解决上传文件存储路径用相对路径存库前端显示时统一加 BASE_URL 前缀拼接目录时用 str_replace(\, /, $path)。记住数据库只存相对路径绝对路径是运行时组装的事。删掉上传目录里残留的测试文件顺手给 uploads 目录设置好写权限Windows 下用 ACL 给当前用户授权Linux 下 chown 到 php-fpm 运行用户。5.5 改了库存或一个字段后台列表没反应现象数据库里 UPDATE 成功了页面列表还是旧值。原因老项目在列表页 SQL 里写死了查询条件和字段名不走表单控件的参数更常见的是浏览器缓存了旧 JS、旧 CSS。解决先强刷浏览器再在代码里搜列表查询那段 SQL确认参数绑定。真要改字段记得连表注释同步改不然三个月后看到字段名等于硬猜。给字段取一个可读名字的习惯能救你很多次。老包列表还经常配一个“缓存”开关如果页面上有生成静态 HTML 的逻辑改完数据后要手动点清除缓存。6. 二次开发进阶把 MD5 密码换成 password_hash给系统加个复诊提醒先处理安全最薄的一环。老包管理员密码几乎全是 MD5 存储在字典面前约等于明文。改造方法是注册和登录两处都换 password_hash / password_verify数据库字段长度扩到 255。登录代码里顺手兼容一次老密码查出来是老的 MD5 串验证通过后立即用 password_hash 重新生成覆盖用户下次登录就自动切到新算法。// 登录校验兼容老 MD5 的写法 if (password_verify($input, $hashFromDb)) { // 新密码走这里 } elseif ($hashFromDb md5($input)) { $newHash password_hash($input, PASSWORD_DEFAULT); $pdo-prepare(UPDATE user SET password? WHERE id?)-execute([$newHash, $uid]); // 放行登录 }复诊提醒的做法也很务实给 patient 表加 last_visit_date处方保存时写当前时间再在后台首页定时拉取超过 30 天没复诊的患者显示在提醒面板里。这条逻辑对中医诊所特别受用老患者是营收大头而原系统没这个能力。SELECT p.name, p.phone, MAX(r.create_time) AS last_visit FROM patient p LEFT JOIN prescription r ON p.id r.patient_id GROUP BY p.id HAVING last_visit DATE_SUB(NOW(), INTERVAL 30 DAY);我拿到这类源码习惯先跑通再动安全再动业务功能每一步留好 SQL 备份。改密码、加字段、加页面前后花两三个小时比从零写一个后台快得多——这也是这类开源包真正值钱的地方让起步的人别重复造轮子让赶交付的人别从空文件开始。希望帮到你。本文还有配套的精品资源点击获取