简介这是一套基于ThinkPHP框架搭建的简单教学管理系统源码面向PHP初学者、Web开发入门者及需要课程设计参考的学生帮助理解MVC架构下的教务管理实现。压缩包共2000个文件约11.04MB以1105个php源码为核心配合384个html模板、197个js脚本、54个css样式及192个png、187个gif等图片资源另含60个md说明文档、49个xml与48个yml配置文件覆盖路由、控制器、模型、视图等完整目录结构。系统围绕教师、学生、课程、成绩等实体设计数据库表涉及路由配置、控制器与模型交互、模板引擎渲染、RBAC权限管理、RESTful API接口、异常处理与日志记录、SQL注入与XSS防护等知识点适合对照源码梳理Web开发流程。目前已有1581人学习下载可作为二次开发与功能扩展的实践起点。1. 教学管理系统用 ThinkPHP 搭从选型到跑通我踩过的那些坑很多做教务工具的朋友都遇到过这种局面需求不复杂无非是学生、课程、成绩、公告这几张表但真要从零手写一套后台光是登录鉴权、权限菜单、分页查询就能耗掉一周。这时候选一个成熟的后端框架比什么都重要。ThinkPHP 在国内中小型管理系统里出镜率一直很高原因很实在——中文文档全、MVC 结构清晰、上手门槛低配合 MySQL 做一套教学管理系统基本就是“够用且不折腾”的组合。这份资源就是一套基于 ThinkPHP 开发的简单教学管理系统覆盖了教务场景里最核心的几块用户角色、课程管理、成绩录入、公告发布。它适合两类人一类是刚接触 ThinkPHP、想拿一个完整项目练手的开发者另一类是手里有小型教务需求、想快速改出一套能用的系统的从业者。下面我按“这东西怎么跑起来、代码怎么改、哪里容易翻车”的顺序把整套流程拆开讲。2. 环境搭建与项目初始化把 ThinkPHP 跑起来的第一公里2.1 运行环境与依赖版本确认拿到一个 ThinkPHP 项目第一件事不是急着改代码而是先把运行环境对齐。ThinkPHP 不同大版本之间差异很大5.x 和 6.x 的目录结构、命名空间、中间件写法都不一样版本对不上报错能让你怀疑人生。常见做法是先看项目根目录下的composer.json里面会写清楚依赖的框架版本和 PHP 版本要求。我一般会按这个顺序确认环境组件推荐版本说明PHP7.4 / 8.06.x 建议 7.4 以上8.0 兼容性更好MySQL5.7 / 8.0注意 8.0 默认认证插件变化Composer2.x用于拉取依赖Web 服务器Nginx / Apache需要配置伪静态PHP 版本这块有个血泪经验如果项目用的是 ThinkPHP 6.xPHP 千万别低于 7.2.5否则连框架入口文件都加载不了。而 MySQL 8.0 的caching_sha2_password认证方式会让老版本 PHP 的 mysqli 扩展连不上报“Authentication plugin cannot be loaded”这种玄学错误。遇到这种情况要么把数据库用户改成mysql_native_password要么升级 PHP 的数据库扩展。2.2 依赖安装与数据库导入环境确认完进入项目目录执行依赖安装。这一步看着简单但国内网络环境下 composer 拉包经常卡住建议先配好镜像源。# 进入项目根目录 cd teaching-admin # 配置 composer 国内镜像如果拉包慢 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ # 安装项目依赖 composer install # 如果项目没有 vendor 目录且 composer.lock 存在用 install # 如果是全新拉取且没有 lock 文件用 composer update安装完成后需要配置数据库连接。ThinkPHP 的数据库配置通常在config/database.php或.env文件里。推荐用.env管理避免把敏感信息写进代码提交到仓库。# .env 文件示例 APP_DEBUG true [DATABASE] TYPE mysql HOSTNAME 127.0.0.1 DATABASE teaching_system USERNAME root PASSWORD your_password HOSTPORT 3306 CHARSET utf8mb4 DEBUG true参数说明TYPE指定数据库驱动CHARSET一定要用utf8mb4否则学生姓名里的生僻字或者公告里的特殊符号会变成乱码。APP_DEBUG在开发阶段设为 true能看到详细报错上线后必须改成 false不然错误堆栈直接暴露给用户这是个安全隐患。数据库导入用命令行或者图形工具都行# 创建数据库 mysql -u root -p -e CREATE DATABASE teaching_system DEFAULT CHARSET utf8mb4; # 导入 SQL 文件 mysql -u root -p teaching_system database/teaching_system.sql导入之后建议先SHOW TABLES;看一眼表结构是否完整。教学管理系统一般会有user、course、score、notice、role这几张核心表。如果 SQL 文件里带了初始管理员账号记得第一时间改密码。2.3 伪静态配置与入口访问ThinkPHP 默认走单一入口所有请求都经过public/index.php。如果伪静态没配好访问任何路由都会 404这是新手最容易卡住的地方。Nginx 配置参考server { listen 80; server_name local.teaching.local; root /var/www/teaching-admin/public; index index.php index.html; location / { # 核心把不存在的文件请求转发给入口文件 if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }这里有个细节root必须指向public目录而不是项目根目录。很多人直接把 root 指到项目根结果.env、composer.json这些敏感文件全都能被浏览器直接下载这是个严重的安全漏洞。配好之后访问http://local.teaching.local能看到登录页就说明环境通了。3. 核心模块拆解用户、课程、成绩三张表的增删改查3.1 用户角色与登录鉴权实现教学管理系统的用户通常分三种角色管理员、教师、学生。不同角色看到的菜单和能操作的数据完全不同。ThinkPHP 里做鉴权常见做法是用中间件拦截请求配合 session 或 token 判断身份。先看登录逻辑的核心代码// app/controller/Auth.php public function login() { $username input(post.username); $password input(post.password); // 参数校验 if (empty($username) || empty($password)) { return json([code 400, msg 用户名或密码不能为空]); } // 查询用户 $user Db::name(user)-where(username, $username)-find(); if (!$user) { return json([code 401, msg 用户不存在]); } // 密码校验假设数据库存的是 password_hash 加密后的值 if (!password_verify($password, $user[password])) { return json([code 401, msg 密码错误]); } // 写入 session session(user_id, $user[id]); session(role, $user[role]); return json([code 200, msg 登录成功]); }逻辑说明先做空值校验再查用户最后用password_verify比对密码。这里千万不要用 md5 存密码教学系统里学生数据涉及隐私md5 早就被彩虹表攻破了。参数方面input(post.xxx)是 ThinkPHP 的助手函数等价于从请求体里取值比原生$_POST多了过滤和默认值处理。鉴权中间件// app/middleware/AuthCheck.php public function handle($request, \Closure $next) { $userId session(user_id); if (!$userId) { return redirect(/login); } // 角色权限判断比如只有管理员能进用户管理 $role session(role); $path $request-pathinfo(); if (strpos($path, admin/) 0 $role ! admin) { return json([code 403, msg 无权限访问]); } return $next($request); }中间件注册在app/middleware.php里可以全局注册也可以在路由分组里单独挂载。我一般会把需要登录的路由统一放到一个分组下中间件只挂这个分组避免登录页本身也被拦截。3.2 课程管理模块的增删改查课程管理是教学系统的骨架字段一般包括课程名、课程代码、授课教师、学分、上课时间。ThinkPHP 的模型和查询构造器能把 CRUD 写得很简洁。// app/controller/Course.php public function list() { $page input(get.page, 1); $limit input(get.limit, 10); $keyword input(get.keyword, ); $query Db::name(course); if ($keyword) { $query-where(name, like, % . $keyword . %); } $total $query-count(); $list $query-page($page, $limit)-order(id, desc)-select(); return json([code 0, msg , count $total, data $list]); } public function add() { $data [ name input(post.name), code input(post.code), teacher_id input(post.teacher_id), credit input(post.credit, 0), created_at date(Y-m-d H:i:s), ]; // 课程代码唯一性校验 $exists Db::name(course)-where(code, $data[code])-find(); if ($exists) { return json([code 400, msg 课程代码已存在]); } $id Db::name(course)-insertGetId($data); return json([code 200, msg 添加成功, id $id]); }参数说明page和limit是分页参数前端表格组件一般会传这两个值。insertGetId返回自增主键方便前端拿到新记录的 id 做后续操作。课程代码做唯一性校验是必须的否则同一门课被录入两次成绩统计就会出错。删除操作要特别注意关联数据。如果一门课已经有学生选了直接删课程会导致成绩表里出现孤儿记录。常见做法是软删除或者先检查关联再决定是否允许删除。public function delete() { $id input(post.id); // 检查是否有成绩关联 $hasScore Db::name(score)-where(course_id, $id)-count(); if ($hasScore 0) { return json([code 400, msg 该课程已有成绩记录不能删除]); } Db::name(course)-delete($id); return json([code 200, msg 删除成功]); }3.3 成绩录入与统计查询成绩模块是教学系统里业务逻辑最重的一块。录入时要校验学生是否选了这门课、分数是否在合理范围统计时要算平均分、及格率、最高最低分。// app/controller/Score.php public function add() { $studentId input(post.student_id); $courseId input(post.course_id); $score input(post.score); // 分数范围校验 if ($score 0 || $score 100) { return json([code 400, msg 分数必须在 0-100 之间]); } // 检查是否已录入 $exists Db::name(score) -where(student_id, $studentId) -where(course_id, $courseId) -find(); if ($exists) { return json([code 400, msg 该学生此课程成绩已录入]); } Db::name(score)-insert([ student_id $studentId, course_id $courseId, score $score, created_at date(Y-m-d H:i:s), ]); return json([code 200, msg 录入成功]); } public function stats() { $courseId input(get.course_id); $stats Db::name(score) -where(course_id, $courseId) -field(AVG(score) as avg_score, MAX(score) as max_score, MIN(score) as min_score, COUNT(*) as total) -find(); // 及格率计算 $passCount Db::name(score) -where(course_id, $courseId) -where(score, , 60) -count(); $stats[pass_rate] $stats[total] 0 ? round($passCount / $stats[total] * 100, 2) . % : 0%; return json([code 0, data $stats]); }逻辑说明录入前先查重避免同一学生同一课程出现多条成绩。统计接口用 SQL 聚合函数一次性算出平均分、最高分、最低分和总数比在 PHP 里循环计算效率高得多。及格率单独查一次是因为聚合函数里没法直接做条件计数用where(score, , 60)再 count 更直观。4. 避坑与排查这套系统最容易翻车的五个地方4.1 数据库连接报“Access denied”或“Unknown database”现象配置完.env后访问页面直接抛出数据库连接异常提示拒绝访问或数据库不存在。原因三种可能——用户名密码写错、数据库没创建、MySQL 8.0 认证插件不兼容。前两种是低级错误但很常见第三种是环境问题。解决先用命令行mysql -u root -p手动登录验证账号密码再SHOW DATABASES;确认库存在如果是 8.0 认证问题执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;然后刷新权限。4.2 路由 404所有页面都打不开现象环境配好了数据库也通了但访问任何地址都是 404连登录页都出不来。原因伪静态规则没生效或者root目录指错了。ThinkPHP 的入口在public/index.php如果 web 服务器 root 指向项目根目录请求根本到不了入口文件。解决检查 Nginx/Apache 的 root 配置确保指向public目录确认rewrite规则已加载Apache 需要确认mod_rewrite模块开启且.htaccess文件存在。4.3 中文乱码学生姓名变问号现象录入学生信息后列表里中文显示为???或者乱码方块。原因数据库、表、连接三层字符集不一致。常见的是数据库建库时用了latin1或者连接配置里charset写成了utf8而不是utf8mb4。解决建库时指定DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci.env里CHARSET utf8mb4已有表用ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4;转换。三层都对齐才能彻底解决。4.4 登录后 session 丢失刷新页面就退出现象登录成功跳转到首页但一刷新就回到登录页session 像是没存住。原因session 存储路径不可写或者多台服务器做了负载均衡但 session 没共享。单机环境下最常见的是runtime目录权限不对PHP 写不进 session 文件。解决检查runtime目录权限chmod -R 755 runtime并确保 web 用户可写如果是多机部署把 session 驱动改成 Redis 或数据库别用默认文件存储。4.5 成绩统计结果对不上平均分偏差大现象统计出来的平均分和手工算的对不上或者及格率超过 100%。原因成绩表里有重复记录或者统计时没按课程过滤把其他课程的成绩也算进去了。还有一种情况是分数字段类型是 varchar排序和计算时按字符串处理。解决先查SELECT course_id, student_id, COUNT(*) FROM score GROUP BY course_id, student_id HAVING COUNT(*) 1;找出重复数据确认统计 SQL 的 where 条件完整把 score 字段类型改成decimal(5,2)或int别用字符串存分数。5. 二次开发与扩展把这套系统改成你自己的样子跑通之后大多数人不会满足于“能用”而是想按自己的业务改。这套系统最值得动手扩展的地方有三个权限粒度、数据导出、操作日志。权限粒度方面原生只做了角色级判断实际教务场景里往往需要精确到“某个老师只能改自己教的课的成绩”。做法是在中间件里拿到当前用户 id查询课程表的teacher_id字段做比对// 在成绩修改前校验归属 $course Db::name(course)-where(id, $courseId)-find(); if ($course[teacher_id] ! session(user_id) session(role) ! admin) { return json([code 403, msg 只能修改自己课程的成绩]); }数据导出是教务系统的高频需求成绩录完总要导出 Excel 存档。ThinkPHP 生态里有 phpoffice/phpspreadsheet 这类库composer 装完就能用。核心思路是把查询结果逐行写进工作表注意设置单元格格式为文本否则学号前面的零会被吃掉。操作日志这块我一般会在中间件里统一记录写操作谁、什么时间、对哪张表、做了什么。表结构很简单operator_id、action、table_name、record_id、created_at五个字段就够。别小看这个出了数据纠纷时日志就是唯一的后悔药。最后说一个验证方法改完任何模块别只在页面上点两下就完事。用 Postman 或者 curl 直接打接口把边界值都过一遍——分数传 -1、传 101、传空字符串看返回是不是符合预期。我见过太多系统页面看着正常接口一测全是洞。从那以后我每次改完核心逻辑都强制走一遍接口边界测试这个习惯帮我省了至少三次线上事故。希望这套东西能帮到你少走点弯路。本文还有配套的精品资源点击获取
简介这是一套基于ThinkPHP框架搭建的简单教学管理系统源码面向PHP初学者、Web开发入门者及需要课程设计参考的学生帮助理解MVC架构下的教务管理实现。压缩包共2000个文件约11.04MB以1105个php源码为核心配合384个html模板、197个js脚本、54个css样式及192个png、187个gif等图片资源另含60个md说明文档、49个xml与48个yml配置文件覆盖路由、控制器、模型、视图等完整目录结构。系统围绕教师、学生、课程、成绩等实体设计数据库表涉及路由配置、控制器与模型交互、模板引擎渲染、RBAC权限管理、RESTful API接口、异常处理与日志记录、SQL注入与XSS防护等知识点适合对照源码梳理Web开发流程。目前已有1581人学习下载可作为二次开发与功能扩展的实践起点。1. 教学管理系统用 ThinkPHP 搭从选型到跑通我踩过的那些坑很多做教务工具的朋友都遇到过这种局面需求不复杂无非是学生、课程、成绩、公告这几张表但真要从零手写一套后台光是登录鉴权、权限菜单、分页查询就能耗掉一周。这时候选一个成熟的后端框架比什么都重要。ThinkPHP 在国内中小型管理系统里出镜率一直很高原因很实在——中文文档全、MVC 结构清晰、上手门槛低配合 MySQL 做一套教学管理系统基本就是“够用且不折腾”的组合。这份资源就是一套基于 ThinkPHP 开发的简单教学管理系统覆盖了教务场景里最核心的几块用户角色、课程管理、成绩录入、公告发布。它适合两类人一类是刚接触 ThinkPHP、想拿一个完整项目练手的开发者另一类是手里有小型教务需求、想快速改出一套能用的系统的从业者。下面我按“这东西怎么跑起来、代码怎么改、哪里容易翻车”的顺序把整套流程拆开讲。2. 环境搭建与项目初始化把 ThinkPHP 跑起来的第一公里2.1 运行环境与依赖版本确认拿到一个 ThinkPHP 项目第一件事不是急着改代码而是先把运行环境对齐。ThinkPHP 不同大版本之间差异很大5.x 和 6.x 的目录结构、命名空间、中间件写法都不一样版本对不上报错能让你怀疑人生。常见做法是先看项目根目录下的composer.json里面会写清楚依赖的框架版本和 PHP 版本要求。我一般会按这个顺序确认环境组件推荐版本说明PHP7.4 / 8.06.x 建议 7.4 以上8.0 兼容性更好MySQL5.7 / 8.0注意 8.0 默认认证插件变化Composer2.x用于拉取依赖Web 服务器Nginx / Apache需要配置伪静态PHP 版本这块有个血泪经验如果项目用的是 ThinkPHP 6.xPHP 千万别低于 7.2.5否则连框架入口文件都加载不了。而 MySQL 8.0 的caching_sha2_password认证方式会让老版本 PHP 的 mysqli 扩展连不上报“Authentication plugin cannot be loaded”这种玄学错误。遇到这种情况要么把数据库用户改成mysql_native_password要么升级 PHP 的数据库扩展。2.2 依赖安装与数据库导入环境确认完进入项目目录执行依赖安装。这一步看着简单但国内网络环境下 composer 拉包经常卡住建议先配好镜像源。# 进入项目根目录 cd teaching-admin # 配置 composer 国内镜像如果拉包慢 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ # 安装项目依赖 composer install # 如果项目没有 vendor 目录且 composer.lock 存在用 install # 如果是全新拉取且没有 lock 文件用 composer update安装完成后需要配置数据库连接。ThinkPHP 的数据库配置通常在config/database.php或.env文件里。推荐用.env管理避免把敏感信息写进代码提交到仓库。# .env 文件示例 APP_DEBUG true [DATABASE] TYPE mysql HOSTNAME 127.0.0.1 DATABASE teaching_system USERNAME root PASSWORD your_password HOSTPORT 3306 CHARSET utf8mb4 DEBUG true参数说明TYPE指定数据库驱动CHARSET一定要用utf8mb4否则学生姓名里的生僻字或者公告里的特殊符号会变成乱码。APP_DEBUG在开发阶段设为 true能看到详细报错上线后必须改成 false不然错误堆栈直接暴露给用户这是个安全隐患。数据库导入用命令行或者图形工具都行# 创建数据库 mysql -u root -p -e CREATE DATABASE teaching_system DEFAULT CHARSET utf8mb4; # 导入 SQL 文件 mysql -u root -p teaching_system database/teaching_system.sql导入之后建议先SHOW TABLES;看一眼表结构是否完整。教学管理系统一般会有user、course、score、notice、role这几张核心表。如果 SQL 文件里带了初始管理员账号记得第一时间改密码。2.3 伪静态配置与入口访问ThinkPHP 默认走单一入口所有请求都经过public/index.php。如果伪静态没配好访问任何路由都会 404这是新手最容易卡住的地方。Nginx 配置参考server { listen 80; server_name local.teaching.local; root /var/www/teaching-admin/public; index index.php index.html; location / { # 核心把不存在的文件请求转发给入口文件 if (!-e $request_filename) { rewrite ^(.*)$ /index.php?s$1 last; } } location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; fastcgi_index index.php; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; } }这里有个细节root必须指向public目录而不是项目根目录。很多人直接把 root 指到项目根结果.env、composer.json这些敏感文件全都能被浏览器直接下载这是个严重的安全漏洞。配好之后访问http://local.teaching.local能看到登录页就说明环境通了。3. 核心模块拆解用户、课程、成绩三张表的增删改查3.1 用户角色与登录鉴权实现教学管理系统的用户通常分三种角色管理员、教师、学生。不同角色看到的菜单和能操作的数据完全不同。ThinkPHP 里做鉴权常见做法是用中间件拦截请求配合 session 或 token 判断身份。先看登录逻辑的核心代码// app/controller/Auth.php public function login() { $username input(post.username); $password input(post.password); // 参数校验 if (empty($username) || empty($password)) { return json([code 400, msg 用户名或密码不能为空]); } // 查询用户 $user Db::name(user)-where(username, $username)-find(); if (!$user) { return json([code 401, msg 用户不存在]); } // 密码校验假设数据库存的是 password_hash 加密后的值 if (!password_verify($password, $user[password])) { return json([code 401, msg 密码错误]); } // 写入 session session(user_id, $user[id]); session(role, $user[role]); return json([code 200, msg 登录成功]); }逻辑说明先做空值校验再查用户最后用password_verify比对密码。这里千万不要用 md5 存密码教学系统里学生数据涉及隐私md5 早就被彩虹表攻破了。参数方面input(post.xxx)是 ThinkPHP 的助手函数等价于从请求体里取值比原生$_POST多了过滤和默认值处理。鉴权中间件// app/middleware/AuthCheck.php public function handle($request, \Closure $next) { $userId session(user_id); if (!$userId) { return redirect(/login); } // 角色权限判断比如只有管理员能进用户管理 $role session(role); $path $request-pathinfo(); if (strpos($path, admin/) 0 $role ! admin) { return json([code 403, msg 无权限访问]); } return $next($request); }中间件注册在app/middleware.php里可以全局注册也可以在路由分组里单独挂载。我一般会把需要登录的路由统一放到一个分组下中间件只挂这个分组避免登录页本身也被拦截。3.2 课程管理模块的增删改查课程管理是教学系统的骨架字段一般包括课程名、课程代码、授课教师、学分、上课时间。ThinkPHP 的模型和查询构造器能把 CRUD 写得很简洁。// app/controller/Course.php public function list() { $page input(get.page, 1); $limit input(get.limit, 10); $keyword input(get.keyword, ); $query Db::name(course); if ($keyword) { $query-where(name, like, % . $keyword . %); } $total $query-count(); $list $query-page($page, $limit)-order(id, desc)-select(); return json([code 0, msg , count $total, data $list]); } public function add() { $data [ name input(post.name), code input(post.code), teacher_id input(post.teacher_id), credit input(post.credit, 0), created_at date(Y-m-d H:i:s), ]; // 课程代码唯一性校验 $exists Db::name(course)-where(code, $data[code])-find(); if ($exists) { return json([code 400, msg 课程代码已存在]); } $id Db::name(course)-insertGetId($data); return json([code 200, msg 添加成功, id $id]); }参数说明page和limit是分页参数前端表格组件一般会传这两个值。insertGetId返回自增主键方便前端拿到新记录的 id 做后续操作。课程代码做唯一性校验是必须的否则同一门课被录入两次成绩统计就会出错。删除操作要特别注意关联数据。如果一门课已经有学生选了直接删课程会导致成绩表里出现孤儿记录。常见做法是软删除或者先检查关联再决定是否允许删除。public function delete() { $id input(post.id); // 检查是否有成绩关联 $hasScore Db::name(score)-where(course_id, $id)-count(); if ($hasScore 0) { return json([code 400, msg 该课程已有成绩记录不能删除]); } Db::name(course)-delete($id); return json([code 200, msg 删除成功]); }3.3 成绩录入与统计查询成绩模块是教学系统里业务逻辑最重的一块。录入时要校验学生是否选了这门课、分数是否在合理范围统计时要算平均分、及格率、最高最低分。// app/controller/Score.php public function add() { $studentId input(post.student_id); $courseId input(post.course_id); $score input(post.score); // 分数范围校验 if ($score 0 || $score 100) { return json([code 400, msg 分数必须在 0-100 之间]); } // 检查是否已录入 $exists Db::name(score) -where(student_id, $studentId) -where(course_id, $courseId) -find(); if ($exists) { return json([code 400, msg 该学生此课程成绩已录入]); } Db::name(score)-insert([ student_id $studentId, course_id $courseId, score $score, created_at date(Y-m-d H:i:s), ]); return json([code 200, msg 录入成功]); } public function stats() { $courseId input(get.course_id); $stats Db::name(score) -where(course_id, $courseId) -field(AVG(score) as avg_score, MAX(score) as max_score, MIN(score) as min_score, COUNT(*) as total) -find(); // 及格率计算 $passCount Db::name(score) -where(course_id, $courseId) -where(score, , 60) -count(); $stats[pass_rate] $stats[total] 0 ? round($passCount / $stats[total] * 100, 2) . % : 0%; return json([code 0, data $stats]); }逻辑说明录入前先查重避免同一学生同一课程出现多条成绩。统计接口用 SQL 聚合函数一次性算出平均分、最高分、最低分和总数比在 PHP 里循环计算效率高得多。及格率单独查一次是因为聚合函数里没法直接做条件计数用where(score, , 60)再 count 更直观。4. 避坑与排查这套系统最容易翻车的五个地方4.1 数据库连接报“Access denied”或“Unknown database”现象配置完.env后访问页面直接抛出数据库连接异常提示拒绝访问或数据库不存在。原因三种可能——用户名密码写错、数据库没创建、MySQL 8.0 认证插件不兼容。前两种是低级错误但很常见第三种是环境问题。解决先用命令行mysql -u root -p手动登录验证账号密码再SHOW DATABASES;确认库存在如果是 8.0 认证问题执行ALTER USER rootlocalhost IDENTIFIED WITH mysql_native_password BY 你的密码;然后刷新权限。4.2 路由 404所有页面都打不开现象环境配好了数据库也通了但访问任何地址都是 404连登录页都出不来。原因伪静态规则没生效或者root目录指错了。ThinkPHP 的入口在public/index.php如果 web 服务器 root 指向项目根目录请求根本到不了入口文件。解决检查 Nginx/Apache 的 root 配置确保指向public目录确认rewrite规则已加载Apache 需要确认mod_rewrite模块开启且.htaccess文件存在。4.3 中文乱码学生姓名变问号现象录入学生信息后列表里中文显示为???或者乱码方块。原因数据库、表、连接三层字符集不一致。常见的是数据库建库时用了latin1或者连接配置里charset写成了utf8而不是utf8mb4。解决建库时指定DEFAULT CHARSET utf8mb4 COLLATE utf8mb4_unicode_ci.env里CHARSET utf8mb4已有表用ALTER TABLE 表名 CONVERT TO CHARACTER SET utf8mb4;转换。三层都对齐才能彻底解决。4.4 登录后 session 丢失刷新页面就退出现象登录成功跳转到首页但一刷新就回到登录页session 像是没存住。原因session 存储路径不可写或者多台服务器做了负载均衡但 session 没共享。单机环境下最常见的是runtime目录权限不对PHP 写不进 session 文件。解决检查runtime目录权限chmod -R 755 runtime并确保 web 用户可写如果是多机部署把 session 驱动改成 Redis 或数据库别用默认文件存储。4.5 成绩统计结果对不上平均分偏差大现象统计出来的平均分和手工算的对不上或者及格率超过 100%。原因成绩表里有重复记录或者统计时没按课程过滤把其他课程的成绩也算进去了。还有一种情况是分数字段类型是 varchar排序和计算时按字符串处理。解决先查SELECT course_id, student_id, COUNT(*) FROM score GROUP BY course_id, student_id HAVING COUNT(*) 1;找出重复数据确认统计 SQL 的 where 条件完整把 score 字段类型改成decimal(5,2)或int别用字符串存分数。5. 二次开发与扩展把这套系统改成你自己的样子跑通之后大多数人不会满足于“能用”而是想按自己的业务改。这套系统最值得动手扩展的地方有三个权限粒度、数据导出、操作日志。权限粒度方面原生只做了角色级判断实际教务场景里往往需要精确到“某个老师只能改自己教的课的成绩”。做法是在中间件里拿到当前用户 id查询课程表的teacher_id字段做比对// 在成绩修改前校验归属 $course Db::name(course)-where(id, $courseId)-find(); if ($course[teacher_id] ! session(user_id) session(role) ! admin) { return json([code 403, msg 只能修改自己课程的成绩]); }数据导出是教务系统的高频需求成绩录完总要导出 Excel 存档。ThinkPHP 生态里有 phpoffice/phpspreadsheet 这类库composer 装完就能用。核心思路是把查询结果逐行写进工作表注意设置单元格格式为文本否则学号前面的零会被吃掉。操作日志这块我一般会在中间件里统一记录写操作谁、什么时间、对哪张表、做了什么。表结构很简单operator_id、action、table_name、record_id、created_at五个字段就够。别小看这个出了数据纠纷时日志就是唯一的后悔药。最后说一个验证方法改完任何模块别只在页面上点两下就完事。用 Postman 或者 curl 直接打接口把边界值都过一遍——分数传 -1、传 101、传空字符串看返回是不是符合预期。我见过太多系统页面看着正常接口一测全是洞。从那以后我每次改完核心逻辑都强制走一遍接口边界测试这个习惯帮我省了至少三次线上事故。希望这套东西能帮到你少走点弯路。本文还有配套的精品资源点击获取
平方复杂度无法被常规优化消除｜TaoToken 统一 Key 通道实测)
