简介这是一套基于ThinkPHP框架开发的学生宿舍公寓管理系统毕业设计源码面向计算机类专业在校生、教师及初级开发者适用于毕业设计、课程设计、项目实训与入门级Web开发实践。资源共367个文件以180个PHP后端逻辑文件为核心辅以98个JavaScript交互脚本、19个CSS样式文件及14个HTML页面模板完整覆盖用户管理、房间分配、报修处理、费用统计等核心业务模块前端采用Bootstrap、Font Awesome及自定义主题样式兼顾响应式布局与基础UI规范。压缩包仅2.22MB轻量易部署所有功能均经实测运行通过。目前已有121人学习下载配套README说明清晰代码结构分层合理注释充分既可开箱即用也便于二次开发拓展功能或适配其他校园管理场景。1. 这不是套模板用 ThinkPHP 搭建真实可运行的学生宿舍公寓管理系统专为毕业设计场景优化很多同学拿到“基于ThinkPHP学生宿舍公寓管理系统”这个毕设题目时第一反应是去 GitHub 或某站搜一个 ZIP 包解压就交——结果部署报错、数据库连不上、权限控制形同虚设答辩被问一句“你改过哪行核心代码”当场卡壳。实际上这个标题背后是一套典型的中小型业务系统落地路径它不追求高并发或微服务但必须体现分层结构意识、数据一致性保障、角色权限闭环、以及符合高校宿舍管理逻辑的真实字段设计。它适合计算机/软件工程专业本科毕设尤其适配 PHP 开发能力中等、数据库设计已掌握 ER 图、但缺乏完整项目交付经验的同学。关键不在“用 ThinkPHP”而在于如何让 ThinkPHP 成为你理解 MVC 分离、关联模型、表单验证、RBAC 权限控制的脚手架而不是遮掩技术短板的包装纸。本文全程基于 ThinkPHP 官方稳定分支以 ThinkPHP 6.1 为主兼容 PHP 7.4–8.2所有命令、配置、SQL 和控制器逻辑均可在本地 WAMP/MAMP/XAMPP 环境中 5 分钟内复现不依赖任何第三方魔改框架或“免配置一键包”。2. 为什么选 ThinkPHP 6.x 而非 3.2 或 5.x版本选型与环境准备的硬约束2.1 ThinkPHP 6.x 是当前毕业设计最稳妥的选择网络热词中频繁出现“thinkphp 3.2 版本兼容 php8”这恰恰说明旧版已成雷区。ThinkPHP 3.2 基于 PHP 5.3 设计强制要求mysql扩展PHP 7.0 已废弃且无命名空间、无 Composer 自动加载机制在 PHP 8.0 环境下会直接触发Fatal error: Uncaught Error: Call to undefined function mysql_connect()。而 ThinkPHP 6.x当前主流为 6.1.x采用 PSR-4 自动加载、原生支持 PDO、内置多应用模式、路由分组清晰更重要的是——其官方文档完整、社区问答活跃、错误提示明确对调试友好度远超旧版。毕业设计不是生产环境压测稳定性、可读性、可解释性才是核心指标。2.2 本地开发环境最小化搭建Windows/macOS/Linux 通用提示不要用 XAMPP 内置的旧版 PHP。务必单独安装 PHP 8.0推荐 8.1并启用pdo_mysql,mbstring,curl,json,xml扩展。可通过php -m | grep pdo验证。使用 Composer 创建项目命令需在终端中执行# 全局安装 Composer若未安装 curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer # Linux/macOS # Windows 用户下载 composer-setup.exe 并运行 # 创建 ThinkPHP 6.1 项目指定稳定版本避免 dev 分支不稳定 composer create-project topthink/think6.1.0 student-dorm-system --ignore-platform-reqs # 进入项目目录并启动内置服务器端口 8000 cd student-dorm-system php think run执行后访问http://127.0.0.1:8000应看到 ThinkPHP 默认欢迎页。若提示The requested URL was not found on this server检查public/.htaccess是否存在Apache或 Nginx 配置是否指向public/目录若提示Class think\App not found说明 Composer 未正确加载 autoload执行composer dump-autoload。2.3 数据库初始化从 ER 图到真实 SQL 的三步转化毕业设计中“数据库er图用哪种方法”高频出现本质是混淆了设计工具与落地执行。我们跳过 PowerDesigner 等重型工具用最简方式生成可执行 SQL核心实体识别紧扣“学生宿舍公寓管理”业务student学号、姓名、院系、班级、联系电话dormitory楼号、房间号、床位数、当前入住数、状态【空闲/满员/维修】dorm_assignment分配记录学生ID、宿舍ID、入住日期、退宿日期、是否续住admin_user管理员账号、密码哈希、角色【超级管理员/楼长/辅导员】repair_record报修记录宿舍ID、报修人、问题描述、处理状态、处理人、完成时间关系确认避免常见错误一个学生只能住一个床位 →dorm_assignment.student_id是外键且UNIQUE一个宿舍可多人入住 →dorm_assignment.dormitory_id允许重复报修由学生发起但由楼长处理 →repair_record.student_id和repair_record.handler_id分属不同角色生成可执行 SQLMySQL 5.7-- 创建数据库字符集必须为 utf8mb4避免微信昵称等 emoji 存储失败 CREATE DATABASE IF NOT EXISTS dorm_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE dorm_db; -- 学生表 CREATE TABLE student ( id int UNSIGNED NOT NULL AUTO_INCREMENT, student_id char(12) NOT NULL COMMENT 学号如20220001001, name varchar(20) NOT NULL, department varchar(50) DEFAULT NULL, class varchar(30) DEFAULT NULL, phone char(11) DEFAULT NULL, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_id (student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 宿舍表 CREATE TABLE dormitory ( id int UNSIGNED NOT NULL AUTO_INCREMENT, building_no varchar(10) NOT NULL COMMENT 楼号如A栋、3号楼, room_no varchar(10) NOT NULL COMMENT 房间号如301、B205, bed_count tinyint UNSIGNED NOT NULL DEFAULT 4, occupied_count tinyint UNSIGNED NOT NULL DEFAULT 0, status enum(vacant,full,under_maintenance) NOT NULL DEFAULT vacant, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_building_room (building_no,room_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 分配表核心业务表 CREATE TABLE dorm_assignment ( id int UNSIGNED NOT NULL AUTO_INCREMENT, student_id int UNSIGNED NOT NULL, dormitory_id int UNSIGNED NOT NULL, check_in_date date NOT NULL, check_out_date date DEFAULT NULL COMMENT 为空表示尚未退宿, is_renewed tinyint(1) NOT NULL DEFAULT 0 COMMENT 是否续住, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_id (student_id), -- 保证一人一寝 KEY idx_dormitory_id (dormitory_id), CONSTRAINT fk_assignment_student FOREIGN KEY (student_id) REFERENCES student (id) ON DELETE CASCADE, CONSTRAINT fk_assignment_dormitory FOREIGN KEY (dormitory_id) REFERENCES dormitory (id) ON DELETE RESTRICT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意ON DELETE CASCADE用于学生删除时自动清理其分配记录而宿舍删除设为RESTRICT防止误删导致数据孤儿。这是毕业设计中体现“数据完整性意识”的关键细节。3. 核心功能模块实现从控制器到视图的完整链路3.1 宿舍分配模块解决“一人一寝”与“床位动态统计”的双重约束分配逻辑不能仅靠前端下拉框选择必须在服务层校验。ThinkPHP 6 的验证器Validate和模型事件Model Event是最佳组合。首先定义app/validate/DormAssignment.php验证器?php declare (strict_types 1); namespace app\validate; use think\Validate; class DormAssignment extends Validate { protected $rule [ student_id require|number|exists:student,id, dormitory_id require|number|exists:dormitory,id, check_in_date require|date|after:yesterday, ]; protected $message [ student_id.require 请选择学生, student_id.exists 该学生不存在, dormitory_id.exists 该宿舍不存在, check_in_date.after 入住日期不能早于今天, ]; // 自定义场景分配时需检查宿舍是否满员 protected $scene [ assign [student_id, dormitory_id, check_in_date], ]; }然后在app/controller/Admin/DormAssignmentController.php中实现分配逻辑?php declare (strict_types 1); namespace app\controller\Admin; use app\BaseController; use app\model\DormAssignment as AssignmentModel; use app\model\Dormitory; use app\model\Student; use app\validate\DormAssignment as AssignmentValidate; class DormAssignmentController extends BaseController { public function assign() { if ($this-request-isPost()) { $data $this-request-post(); // 使用验证器场景 $validate new AssignmentValidate(); if (!$validate-scene(assign)-check($data)) { return json([code 0, msg $validate-getError()]); } // 关键事务内检查并更新床位数 $result \think\facade\Db::transaction(function () use ($data) { // 1. 查询目标宿舍当前占用数 $dorm Dormitory::find($data[dormitory_id]); if (!$dorm || $dorm-status ! vacant) { throw new \Exception(该宿舍不可分配); } if ($dorm-occupied_count $dorm-bed_count) { throw new \Exception(该宿舍床位已满); } // 2. 创建分配记录 $assignment new AssignmentModel(); $assignment-student_id $data[student_id]; $assignment-dormitory_id $data[dormitory_id]; $assignment-check_in_date $data[check_in_date]; $assignment-save(); // 3. 更新宿舍占用数原子操作 $dorm-occupied_count 1; $dorm-status $dorm-occupied_count $dorm-bed_count ? full : vacant; $dorm-save(); return $assignment-id; }); if ($result) { return json([code 1, msg 分配成功]); } else { return json([code 0, msg 分配失败请重试]); } } // GET 请求渲染分配页面预加载学生和宿舍列表 $students Student::field(id,student_id,name,department,class)-select(); $dormitories Dormitory::where(status, vacant)-select(); return view(assign, compact(students, dormitories)); } }逻辑说明Db::transaction确保“创建分配记录”与“更新宿舍占用数”要么全部成功要么全部回滚。若不加事务极端情况下可能出现分配成功但床位数未更新导致超员。参数说明$data[student_id]来自前端表单经验证器确保其真实存在$dorm-status ! vacant排除维修中宿舍$dorm-occupied_count $dorm-bed_count是业务硬约束比单纯查COUNT(*)更高效。3.2 权限控制模块用 RBAC 实现“楼长只能管自己楼”的真实隔离毕业设计常忽略权限粒度“管理员”一刀切。ThinkPHP 6 原生不带 RBAC但通过中间件 数据库查询可轻量实现。创建权限中间件app/middleware/RoleCheck.php?php declare (strict_types 1); namespace app\middleware; use app\model\AdminUser; use think\Request; use think\Response; class RoleCheck { public function handle(Request $request, \Closure $next) { $adminId session(admin_id); if (!$adminId) { return redirect(/admin/login); } $admin AdminUser::find($adminId); if (!$admin) { session(null); // 清除无效 session return redirect(/admin/login); } // 超级管理员跳过检查 if ($admin-role super_admin) { return $next($request); } // 楼长只能访问自己负责的楼号假设 admin_user 表有 building_managed 字段 if ($admin-role building_manager $admin-building_managed) { $currentRoute $request-path(); // 规则/admin/dormitory/list?buildingA栋 → 允许/admin/student/list → 拒绝 if (strpos($currentRoute, /admin/dormitory/) 0) { $buildingParam $request-param(building, ); if ($buildingParam $buildingParam ! $admin-building_managed) { return Response::create(无权访问该楼栋数据, html, 403); } } } return $next($request); } }在app/middleware.php中注册return [ // 全局中间件 \app\middleware\RoleCheck::class, ];参数说明$admin-building_managed存储楼长负责的楼号如“A栋”通过 URL 参数?buildingA栋传递中间件实时校验。这种方式无需复杂权限表却能精准控制数据可见性是毕业设计中“够用且可讲清”的典型方案。4. 关联删除与数据一致性ThinkPHP 中避免“删宿舍学生还在住”的陷阱4.1 外键约束 vs 模型事件两种方案的适用边界网络热词中“thinkphp 关联删除”常被误解为“一条命令删全表”。实际需区分场景物理删除DELETE必须依赖数据库外键ON DELETE CASCADE如前文dorm_assignment.student_id的约束。这是最可靠的数据一致性保障DB 层强制执行。逻辑删除UPDATE status0ThinkPHP 模型提供deleteTime软删除适用于学生退学但需保留历史记录的场景。但宿舍表dormitory的删除策略不同宿舍物理删除时必须阻止已分配学生的宿舍被删即ON DELETE RESTRICT而非级联删除分配记录——因为分配记录本身是业务事实删除宿舍不等于抹去历史入住行为。4.2 在控制器中实现安全删除宿舍的完整流程app/controller/Admin/DormitoryController.php中的destroy方法public function destroy($id) { $dorm Dormitory::find($id); if (!$dorm) { return json([code 0, msg 宿舍不存在]); } // 检查是否有学生正在入住非退宿状态 $activeAssignments AssignmentModel::where(dormitory_id, $id) -whereNull(check_out_date) // check_out_date 为空 尚未退宿 -count(); if ($activeAssignments 0) { return json([code 0, msg 无法删除该宿舍有 {$activeAssignments} 名学生正在入住]); } // 检查是否有未处理报修 $pendingRepairs RepairRecord::where(dormitory_id, $id) -where(status, pending) -count(); if ($pendingRepairs 0) { return json([code 0, msg 无法删除该宿舍有 {$pendingRepairs} 条待处理报修]); } // 执行删除此时可安全删除 if ($dorm-delete()) { return json([code 1, msg 宿舍删除成功]); } else { return json([code 0, msg 删除失败]); } }关键点whereNull(check_out_date)是判断“当前入住”的核心条件比WHERE statusliving更符合业务语义状态字段易被篡改NULL 值不可伪造。此逻辑在控制器中显式编写比依赖模型钩子更直观便于答辩时讲解“为什么这里要查两次”。4.3 修复已存在的数据不一致用 SQL 快速清理脏数据若前期开发中已产生“宿舍被删但分配记录残留”的脏数据可用以下 SQL 修复-- 查找所有 dormitory_id 不存在于 dormitory 表的分配记录 SELECT * FROM dorm_assignment WHERE dormitory_id NOT IN (SELECT id FROM dormitory); -- 安全删除先备份 DELETE FROM dorm_assignment WHERE dormitory_id NOT IN (SELECT id FROM dormitory); -- 同步更新宿舍表 occupied_count修复因程序异常导致的计数偏差 UPDATE dormitory d JOIN ( SELECT dormitory_id, COUNT(*) as cnt FROM dorm_assignment WHERE check_out_date IS NULL GROUP BY dormitory_id ) a ON d.id a.dormitory_id SET d.occupied_count a.cnt;提示执行前务必备份数据库。COUNT(*)子查询比循环查每条记录效率高两个数量级适合毕业设计中快速收尾。5. 毕业设计答辩必答技巧三个让老师眼前一亮的技术细节5.1 在登录页展示“当前系统负载”用 ThinkPHP 命令行快速实现答辩时老师常问“你怎么知道系统性能”——与其空谈“用了Redis缓存”不如展示一个真实指标。ThinkPHP 内置think命令可获取内存与请求信息在app/view/admin/login.html底部添加div classfooter-info small 系统状态?php $mem memory_get_usage() / 1024 / 1024; $reqTime round(microtime(true) - $_SERVER[REQUEST_TIME_FLOAT], 3); echo 内存使用 {$mem:.2f}MB | 请求耗时 {$reqTime}s; ? /small /div逻辑说明memory_get_usage()返回当前脚本内存占用$_SERVER[REQUEST_TIME_FLOAT]是请求开始时间戳二者相减得真实响应时间。无需额外扩展5 行代码即可体现“性能可观测性”且完全符合毕业设计深度。5.2 导出宿舍分配表时自动标注“续住学生”用 ExcelWriter 实现差异化样式学生续住是宿舍管理关键指标但普通导出难以突出。使用phpoffice/phpspreadsheetComposer 安装composer require phpoffice/phpspreadsheet在app/controller/Admin/ExportController.php中use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Writer\Xlsx; use PhpOffice\PhpSpreadsheet\Style\Font; public function exportAssignments() { $assignments AssignmentModel::with([student, dormitory]) -whereNotNull(check_out_date) -select(); $spreadsheet new Spreadsheet(); $sheet $spreadsheet-getActiveSheet(); $sheet-setCellValue(A1, 学号)-setCellValue(B1, 姓名)-setCellValue(C1, 宿舍)-setCellValue(D1, 入住日期)-setCellValue(E1, 退宿日期)-setCellValue(F1, 是否续住); $row 2; foreach ($assignments as $item) { $sheet-setCellValue(A{$row}, $item-student-student_id); $sheet-setCellValue(B{$row}, $item-student-name); $sheet-setCellValue(C{$row}, {$item-dormitory-building_no}{$item-dormitory-room_no}); $sheet-setCellValue(D{$row}, $item-check_in_date); $sheet-setCellValue(E{$row}, $item-check_out_date); $sheet-setCellValue(F{$row}, $item-is_renewed ? 是 : 否); // 续住学生整行标红 if ($item-is_renewed) { $styleArray [ font [color [rgb FF0000]], ]; $sheet-getStyle(A{$row}:F{$row})-applyFromArray($styleArray); } $row; } $writer new Xlsx($spreadsheet); $filename 宿舍分配导出_ . date(YmdHis) . .xlsx; header(Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); header(Content-Disposition: attachment;filename . $filename . ); header(Cache-Control: max-age0); $writer-save(php://output); }效果导出 Excel 中续住学生行文字变红无需老师手动筛选。这展示了“业务需求驱动技术选型”的思维比单纯说“用了PHPExcel”更有说服力。5.3 用 Git 提交信息体现开发过程三条命令让答辩材料更扎实毕业设计材料常被质疑“是否独立完成”。将开发痕迹固化在 Git 中# 初始化仓库项目根目录 git init git add . git commit -m feat: 初始化 ThinkPHP 6.1 项目配置基础数据库连接 # 实现宿舍分配功能后 git add app/controller/Admin/DormAssignmentController.php app/validate/DormAssignment.php git commit -m feat(dorm): 实现宿舍分配核心逻辑含事务与床位校验 # 添加权限控制后 git add app/middleware/RoleCheck.php app/middleware.php git commit -m feat(auth): 增加楼长数据隔离中间件支持 building 参数校验提示答辩 PPT 中可截图git log --oneline展示 3–5 条有意义的提交记录。老师一眼可知开发节奏与模块划分比“已完成全部功能”更有可信度。本文还有配套的精品资源点击获取
ThinkPHP 6.x 学生宿舍管理系统毕设实战指南
简介这是一套基于ThinkPHP框架开发的学生宿舍公寓管理系统毕业设计源码面向计算机类专业在校生、教师及初级开发者适用于毕业设计、课程设计、项目实训与入门级Web开发实践。资源共367个文件以180个PHP后端逻辑文件为核心辅以98个JavaScript交互脚本、19个CSS样式文件及14个HTML页面模板完整覆盖用户管理、房间分配、报修处理、费用统计等核心业务模块前端采用Bootstrap、Font Awesome及自定义主题样式兼顾响应式布局与基础UI规范。压缩包仅2.22MB轻量易部署所有功能均经实测运行通过。目前已有121人学习下载配套README说明清晰代码结构分层合理注释充分既可开箱即用也便于二次开发拓展功能或适配其他校园管理场景。1. 这不是套模板用 ThinkPHP 搭建真实可运行的学生宿舍公寓管理系统专为毕业设计场景优化很多同学拿到“基于ThinkPHP学生宿舍公寓管理系统”这个毕设题目时第一反应是去 GitHub 或某站搜一个 ZIP 包解压就交——结果部署报错、数据库连不上、权限控制形同虚设答辩被问一句“你改过哪行核心代码”当场卡壳。实际上这个标题背后是一套典型的中小型业务系统落地路径它不追求高并发或微服务但必须体现分层结构意识、数据一致性保障、角色权限闭环、以及符合高校宿舍管理逻辑的真实字段设计。它适合计算机/软件工程专业本科毕设尤其适配 PHP 开发能力中等、数据库设计已掌握 ER 图、但缺乏完整项目交付经验的同学。关键不在“用 ThinkPHP”而在于如何让 ThinkPHP 成为你理解 MVC 分离、关联模型、表单验证、RBAC 权限控制的脚手架而不是遮掩技术短板的包装纸。本文全程基于 ThinkPHP 官方稳定分支以 ThinkPHP 6.1 为主兼容 PHP 7.4–8.2所有命令、配置、SQL 和控制器逻辑均可在本地 WAMP/MAMP/XAMPP 环境中 5 分钟内复现不依赖任何第三方魔改框架或“免配置一键包”。2. 为什么选 ThinkPHP 6.x 而非 3.2 或 5.x版本选型与环境准备的硬约束2.1 ThinkPHP 6.x 是当前毕业设计最稳妥的选择网络热词中频繁出现“thinkphp 3.2 版本兼容 php8”这恰恰说明旧版已成雷区。ThinkPHP 3.2 基于 PHP 5.3 设计强制要求mysql扩展PHP 7.0 已废弃且无命名空间、无 Composer 自动加载机制在 PHP 8.0 环境下会直接触发Fatal error: Uncaught Error: Call to undefined function mysql_connect()。而 ThinkPHP 6.x当前主流为 6.1.x采用 PSR-4 自动加载、原生支持 PDO、内置多应用模式、路由分组清晰更重要的是——其官方文档完整、社区问答活跃、错误提示明确对调试友好度远超旧版。毕业设计不是生产环境压测稳定性、可读性、可解释性才是核心指标。2.2 本地开发环境最小化搭建Windows/macOS/Linux 通用提示不要用 XAMPP 内置的旧版 PHP。务必单独安装 PHP 8.0推荐 8.1并启用pdo_mysql,mbstring,curl,json,xml扩展。可通过php -m | grep pdo验证。使用 Composer 创建项目命令需在终端中执行# 全局安装 Composer若未安装 curl -sS https://getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer # Linux/macOS # Windows 用户下载 composer-setup.exe 并运行 # 创建 ThinkPHP 6.1 项目指定稳定版本避免 dev 分支不稳定 composer create-project topthink/think6.1.0 student-dorm-system --ignore-platform-reqs # 进入项目目录并启动内置服务器端口 8000 cd student-dorm-system php think run执行后访问http://127.0.0.1:8000应看到 ThinkPHP 默认欢迎页。若提示The requested URL was not found on this server检查public/.htaccess是否存在Apache或 Nginx 配置是否指向public/目录若提示Class think\App not found说明 Composer 未正确加载 autoload执行composer dump-autoload。2.3 数据库初始化从 ER 图到真实 SQL 的三步转化毕业设计中“数据库er图用哪种方法”高频出现本质是混淆了设计工具与落地执行。我们跳过 PowerDesigner 等重型工具用最简方式生成可执行 SQL核心实体识别紧扣“学生宿舍公寓管理”业务student学号、姓名、院系、班级、联系电话dormitory楼号、房间号、床位数、当前入住数、状态【空闲/满员/维修】dorm_assignment分配记录学生ID、宿舍ID、入住日期、退宿日期、是否续住admin_user管理员账号、密码哈希、角色【超级管理员/楼长/辅导员】repair_record报修记录宿舍ID、报修人、问题描述、处理状态、处理人、完成时间关系确认避免常见错误一个学生只能住一个床位 →dorm_assignment.student_id是外键且UNIQUE一个宿舍可多人入住 →dorm_assignment.dormitory_id允许重复报修由学生发起但由楼长处理 →repair_record.student_id和repair_record.handler_id分属不同角色生成可执行 SQLMySQL 5.7-- 创建数据库字符集必须为 utf8mb4避免微信昵称等 emoji 存储失败 CREATE DATABASE IF NOT EXISTS dorm_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; USE dorm_db; -- 学生表 CREATE TABLE student ( id int UNSIGNED NOT NULL AUTO_INCREMENT, student_id char(12) NOT NULL COMMENT 学号如20220001001, name varchar(20) NOT NULL, department varchar(50) DEFAULT NULL, class varchar(30) DEFAULT NULL, phone char(11) DEFAULT NULL, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_id (student_id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 宿舍表 CREATE TABLE dormitory ( id int UNSIGNED NOT NULL AUTO_INCREMENT, building_no varchar(10) NOT NULL COMMENT 楼号如A栋、3号楼, room_no varchar(10) NOT NULL COMMENT 房间号如301、B205, bed_count tinyint UNSIGNED NOT NULL DEFAULT 4, occupied_count tinyint UNSIGNED NOT NULL DEFAULT 0, status enum(vacant,full,under_maintenance) NOT NULL DEFAULT vacant, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_building_room (building_no,room_no) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4; -- 分配表核心业务表 CREATE TABLE dorm_assignment ( id int UNSIGNED NOT NULL AUTO_INCREMENT, student_id int UNSIGNED NOT NULL, dormitory_id int UNSIGNED NOT NULL, check_in_date date NOT NULL, check_out_date date DEFAULT NULL COMMENT 为空表示尚未退宿, is_renewed tinyint(1) NOT NULL DEFAULT 0 COMMENT 是否续住, created_at datetime DEFAULT CURRENT_TIMESTAMP, PRIMARY KEY (id), UNIQUE KEY uk_student_id (student_id), -- 保证一人一寝 KEY idx_dormitory_id (dormitory_id), CONSTRAINT fk_assignment_student FOREIGN KEY (student_id) REFERENCES student (id) ON DELETE CASCADE, CONSTRAINT fk_assignment_dormitory FOREIGN KEY (dormitory_id) REFERENCES dormitory (id) ON DELETE RESTRICT ) ENGINEInnoDB DEFAULT CHARSETutf8mb4;注意ON DELETE CASCADE用于学生删除时自动清理其分配记录而宿舍删除设为RESTRICT防止误删导致数据孤儿。这是毕业设计中体现“数据完整性意识”的关键细节。3. 核心功能模块实现从控制器到视图的完整链路3.1 宿舍分配模块解决“一人一寝”与“床位动态统计”的双重约束分配逻辑不能仅靠前端下拉框选择必须在服务层校验。ThinkPHP 6 的验证器Validate和模型事件Model Event是最佳组合。首先定义app/validate/DormAssignment.php验证器?php declare (strict_types 1); namespace app\validate; use think\Validate; class DormAssignment extends Validate { protected $rule [ student_id require|number|exists:student,id, dormitory_id require|number|exists:dormitory,id, check_in_date require|date|after:yesterday, ]; protected $message [ student_id.require 请选择学生, student_id.exists 该学生不存在, dormitory_id.exists 该宿舍不存在, check_in_date.after 入住日期不能早于今天, ]; // 自定义场景分配时需检查宿舍是否满员 protected $scene [ assign [student_id, dormitory_id, check_in_date], ]; }然后在app/controller/Admin/DormAssignmentController.php中实现分配逻辑?php declare (strict_types 1); namespace app\controller\Admin; use app\BaseController; use app\model\DormAssignment as AssignmentModel; use app\model\Dormitory; use app\model\Student; use app\validate\DormAssignment as AssignmentValidate; class DormAssignmentController extends BaseController { public function assign() { if ($this-request-isPost()) { $data $this-request-post(); // 使用验证器场景 $validate new AssignmentValidate(); if (!$validate-scene(assign)-check($data)) { return json([code 0, msg $validate-getError()]); } // 关键事务内检查并更新床位数 $result \think\facade\Db::transaction(function () use ($data) { // 1. 查询目标宿舍当前占用数 $dorm Dormitory::find($data[dormitory_id]); if (!$dorm || $dorm-status ! vacant) { throw new \Exception(该宿舍不可分配); } if ($dorm-occupied_count $dorm-bed_count) { throw new \Exception(该宿舍床位已满); } // 2. 创建分配记录 $assignment new AssignmentModel(); $assignment-student_id $data[student_id]; $assignment-dormitory_id $data[dormitory_id]; $assignment-check_in_date $data[check_in_date]; $assignment-save(); // 3. 更新宿舍占用数原子操作 $dorm-occupied_count 1; $dorm-status $dorm-occupied_count $dorm-bed_count ? full : vacant; $dorm-save(); return $assignment-id; }); if ($result) { return json([code 1, msg 分配成功]); } else { return json([code 0, msg 分配失败请重试]); } } // GET 请求渲染分配页面预加载学生和宿舍列表 $students Student::field(id,student_id,name,department,class)-select(); $dormitories Dormitory::where(status, vacant)-select(); return view(assign, compact(students, dormitories)); } }逻辑说明Db::transaction确保“创建分配记录”与“更新宿舍占用数”要么全部成功要么全部回滚。若不加事务极端情况下可能出现分配成功但床位数未更新导致超员。参数说明$data[student_id]来自前端表单经验证器确保其真实存在$dorm-status ! vacant排除维修中宿舍$dorm-occupied_count $dorm-bed_count是业务硬约束比单纯查COUNT(*)更高效。3.2 权限控制模块用 RBAC 实现“楼长只能管自己楼”的真实隔离毕业设计常忽略权限粒度“管理员”一刀切。ThinkPHP 6 原生不带 RBAC但通过中间件 数据库查询可轻量实现。创建权限中间件app/middleware/RoleCheck.php?php declare (strict_types 1); namespace app\middleware; use app\model\AdminUser; use think\Request; use think\Response; class RoleCheck { public function handle(Request $request, \Closure $next) { $adminId session(admin_id); if (!$adminId) { return redirect(/admin/login); } $admin AdminUser::find($adminId); if (!$admin) { session(null); // 清除无效 session return redirect(/admin/login); } // 超级管理员跳过检查 if ($admin-role super_admin) { return $next($request); } // 楼长只能访问自己负责的楼号假设 admin_user 表有 building_managed 字段 if ($admin-role building_manager $admin-building_managed) { $currentRoute $request-path(); // 规则/admin/dormitory/list?buildingA栋 → 允许/admin/student/list → 拒绝 if (strpos($currentRoute, /admin/dormitory/) 0) { $buildingParam $request-param(building, ); if ($buildingParam $buildingParam ! $admin-building_managed) { return Response::create(无权访问该楼栋数据, html, 403); } } } return $next($request); } }在app/middleware.php中注册return [ // 全局中间件 \app\middleware\RoleCheck::class, ];参数说明$admin-building_managed存储楼长负责的楼号如“A栋”通过 URL 参数?buildingA栋传递中间件实时校验。这种方式无需复杂权限表却能精准控制数据可见性是毕业设计中“够用且可讲清”的典型方案。4. 关联删除与数据一致性ThinkPHP 中避免“删宿舍学生还在住”的陷阱4.1 外键约束 vs 模型事件两种方案的适用边界网络热词中“thinkphp 关联删除”常被误解为“一条命令删全表”。实际需区分场景物理删除DELETE必须依赖数据库外键ON DELETE CASCADE如前文dorm_assignment.student_id的约束。这是最可靠的数据一致性保障DB 层强制执行。逻辑删除UPDATE status0ThinkPHP 模型提供deleteTime软删除适用于学生退学但需保留历史记录的场景。但宿舍表dormitory的删除策略不同宿舍物理删除时必须阻止已分配学生的宿舍被删即ON DELETE RESTRICT而非级联删除分配记录——因为分配记录本身是业务事实删除宿舍不等于抹去历史入住行为。4.2 在控制器中实现安全删除宿舍的完整流程app/controller/Admin/DormitoryController.php中的destroy方法public function destroy($id) { $dorm Dormitory::find($id); if (!$dorm) { return json([code 0, msg 宿舍不存在]); } // 检查是否有学生正在入住非退宿状态 $activeAssignments AssignmentModel::where(dormitory_id, $id) -whereNull(check_out_date) // check_out_date 为空 尚未退宿 -count(); if ($activeAssignments 0) { return json([code 0, msg 无法删除该宿舍有 {$activeAssignments} 名学生正在入住]); } // 检查是否有未处理报修 $pendingRepairs RepairRecord::where(dormitory_id, $id) -where(status, pending) -count(); if ($pendingRepairs 0) { return json([code 0, msg 无法删除该宿舍有 {$pendingRepairs} 条待处理报修]); } // 执行删除此时可安全删除 if ($dorm-delete()) { return json([code 1, msg 宿舍删除成功]); } else { return json([code 0, msg 删除失败]); } }关键点whereNull(check_out_date)是判断“当前入住”的核心条件比WHERE statusliving更符合业务语义状态字段易被篡改NULL 值不可伪造。此逻辑在控制器中显式编写比依赖模型钩子更直观便于答辩时讲解“为什么这里要查两次”。4.3 修复已存在的数据不一致用 SQL 快速清理脏数据若前期开发中已产生“宿舍被删但分配记录残留”的脏数据可用以下 SQL 修复-- 查找所有 dormitory_id 不存在于 dormitory 表的分配记录 SELECT * FROM dorm_assignment WHERE dormitory_id NOT IN (SELECT id FROM dormitory); -- 安全删除先备份 DELETE FROM dorm_assignment WHERE dormitory_id NOT IN (SELECT id FROM dormitory); -- 同步更新宿舍表 occupied_count修复因程序异常导致的计数偏差 UPDATE dormitory d JOIN ( SELECT dormitory_id, COUNT(*) as cnt FROM dorm_assignment WHERE check_out_date IS NULL GROUP BY dormitory_id ) a ON d.id a.dormitory_id SET d.occupied_count a.cnt;提示执行前务必备份数据库。COUNT(*)子查询比循环查每条记录效率高两个数量级适合毕业设计中快速收尾。5. 毕业设计答辩必答技巧三个让老师眼前一亮的技术细节5.1 在登录页展示“当前系统负载”用 ThinkPHP 命令行快速实现答辩时老师常问“你怎么知道系统性能”——与其空谈“用了Redis缓存”不如展示一个真实指标。ThinkPHP 内置think命令可获取内存与请求信息在app/view/admin/login.html底部添加div classfooter-info small 系统状态?php $mem memory_get_usage() / 1024 / 1024; $reqTime round(microtime(true) - $_SERVER[REQUEST_TIME_FLOAT], 3); echo 内存使用 {$mem:.2f}MB | 请求耗时 {$reqTime}s; ? /small /div逻辑说明memory_get_usage()返回当前脚本内存占用$_SERVER[REQUEST_TIME_FLOAT]是请求开始时间戳二者相减得真实响应时间。无需额外扩展5 行代码即可体现“性能可观测性”且完全符合毕业设计深度。5.2 导出宿舍分配表时自动标注“续住学生”用 ExcelWriter 实现差异化样式学生续住是宿舍管理关键指标但普通导出难以突出。使用phpoffice/phpspreadsheetComposer 安装composer require phpoffice/phpspreadsheet在app/controller/Admin/ExportController.php中use PhpOffice\PhpSpreadsheet\Spreadsheet; use PhpOffice\PhpSpreadsheet\Writer\Xlsx; use PhpOffice\PhpSpreadsheet\Style\Font; public function exportAssignments() { $assignments AssignmentModel::with([student, dormitory]) -whereNotNull(check_out_date) -select(); $spreadsheet new Spreadsheet(); $sheet $spreadsheet-getActiveSheet(); $sheet-setCellValue(A1, 学号)-setCellValue(B1, 姓名)-setCellValue(C1, 宿舍)-setCellValue(D1, 入住日期)-setCellValue(E1, 退宿日期)-setCellValue(F1, 是否续住); $row 2; foreach ($assignments as $item) { $sheet-setCellValue(A{$row}, $item-student-student_id); $sheet-setCellValue(B{$row}, $item-student-name); $sheet-setCellValue(C{$row}, {$item-dormitory-building_no}{$item-dormitory-room_no}); $sheet-setCellValue(D{$row}, $item-check_in_date); $sheet-setCellValue(E{$row}, $item-check_out_date); $sheet-setCellValue(F{$row}, $item-is_renewed ? 是 : 否); // 续住学生整行标红 if ($item-is_renewed) { $styleArray [ font [color [rgb FF0000]], ]; $sheet-getStyle(A{$row}:F{$row})-applyFromArray($styleArray); } $row; } $writer new Xlsx($spreadsheet); $filename 宿舍分配导出_ . date(YmdHis) . .xlsx; header(Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet); header(Content-Disposition: attachment;filename . $filename . ); header(Cache-Control: max-age0); $writer-save(php://output); }效果导出 Excel 中续住学生行文字变红无需老师手动筛选。这展示了“业务需求驱动技术选型”的思维比单纯说“用了PHPExcel”更有说服力。5.3 用 Git 提交信息体现开发过程三条命令让答辩材料更扎实毕业设计材料常被质疑“是否独立完成”。将开发痕迹固化在 Git 中# 初始化仓库项目根目录 git init git add . git commit -m feat: 初始化 ThinkPHP 6.1 项目配置基础数据库连接 # 实现宿舍分配功能后 git add app/controller/Admin/DormAssignmentController.php app/validate/DormAssignment.php git commit -m feat(dorm): 实现宿舍分配核心逻辑含事务与床位校验 # 添加权限控制后 git add app/middleware/RoleCheck.php app/middleware.php git commit -m feat(auth): 增加楼长数据隔离中间件支持 building 参数校验提示答辩 PPT 中可截图git log --oneline展示 3–5 条有意义的提交记录。老师一眼可知开发节奏与模块划分比“已完成全部功能”更有可信度。本文还有配套的精品资源点击获取
