簡介這是一套基于ThinkPHP框架搭建的簡單教學(xué)管理系統(tǒng)源碼面向PHP初學(xué)者、Web開發(fā)入門者及需要課程設(shè)計參考的學(xué)生幫助理解MVC架構(gòu)下的教務(wù)管理實現(xiàn)。壓縮包共2000個文件約11.04MB以1105個php文件為核心業(yè)務(wù)代碼384個html與197個js構(gòu)成前端頁面與交互另有192個png、187個gif等圖片資源以及60個md說明文檔、54個css樣式、49個xml與48個yml配置、41個json數(shù)據(jù)文件并包含少量sql、tpl模板與測試相關(guān)文件結(jié)構(gòu)完整便于按模塊查閱。系統(tǒng)覆蓋教師、學(xué)生、課程、成績等實體設(shè)計涉及路由配置、控制器與模型交互、模板引擎、RBAC權(quán)限管理、RESTful API接口、異常處理與日志記錄、SQL注入及XSS防護等知識點。目前已有1581人學(xué)習下載適合通過閱讀源碼掌握ThinkPHP項目組織方式并在此基礎(chǔ)上進行二次開發(fā)與功能擴展。1. 從一份教務(wù)排課表說起這個教學(xué)管理系統(tǒng)到底能干什么每學(xué)期開學(xué)前兩周教務(wù)老師最頭疼的就是排課。課程、教師、班級、教室四個維度互相拉扯用 Excel 手工排改一處動全身。我拿到這份基于 ThinkPHP 開發(fā)的教學(xué)管理系統(tǒng)源碼時第一反應(yīng)就是看它怎么處理這個場景。它把學(xué)生、教師、課程、班級、成績、排課這幾塊業(yè)務(wù)串成了一條完整鏈路后臺用 ThinkPHP 的 MVC 分層組織前臺是常規(guī)的服務(wù)端渲染頁面。適合誰用一是想拿一個真實業(yè)務(wù)練手 ThinkPHP 的開發(fā)者二是學(xué)校或培訓(xùn)機構(gòu)里需要一套輕量教務(wù)工具的技術(shù)人員。它不追求大而全勝在結(jié)構(gòu)清晰、業(yè)務(wù)閉環(huán)完整拿來二次開發(fā)的門檻很低。2. 技術(shù)選型與目錄結(jié)構(gòu)ThinkPHP 的 MVC 是怎么落地的2.1 為什么是 ThinkPHP 而不是別的框架教學(xué)管理系統(tǒng)這類項目有個特點業(yè)務(wù)邏輯不復(fù)雜但表單多、CRUD 密集、權(quán)限層級分明。用 ThinkPHP 來做最直接的好處是它的模型層和驗證器能省掉大量重復(fù)代碼。比如學(xué)生信息的增刪改查用 ThinkPHP 的模型關(guān)聯(lián)和自動驗證一個控制器方法加一個模型定義就能跑通不用像裸寫 PHP 那樣每個字段都手動過濾。從項目結(jié)構(gòu)看它走的是 ThinkPHP 標準的單應(yīng)用模式不是多應(yīng)用入口文件在public/index.php應(yīng)用目錄application/下按模塊劃分控制器和模型。這種結(jié)構(gòu)對新手友好因為路由規(guī)則簡單模塊/控制器/方法三段式訪問調(diào)試的時候直接改 URL 就能定位到代碼。常見做法是把學(xué)生、教師、課程分別放在不同的控制器里比如StudentController、TeacherController、CourseController每個控制器負責自己那塊業(yè)務(wù)的增刪改查和列表展示。模型層則對應(yīng)StudentModel、TeacherModel等通過belongsTo和hasMany建立關(guān)聯(lián)。比如查一個學(xué)生的成績通過StudentModel關(guān)聯(lián)ScoreModel再關(guān)聯(lián)到CourseModel一條鏈就把數(shù)據(jù)取出來了。2.2 目錄結(jié)構(gòu)逐個拆開看拿到源碼后我習慣先掃一遍目錄確認哪些是框架自帶的哪些是業(yè)務(wù)代碼。這份項目的目錄大致是這樣application/ ├── admin/ # 后臺模塊 │ ├── controller/ # 控制器 │ │ ├── IndexController.php │ │ ├── StudentController.php │ │ ├── TeacherController.php │ │ ├── CourseController.php │ │ └── ScoreController.php │ ├── model/ # 模型 │ │ ├── StudentModel.php │ │ ├── TeacherModel.php │ │ ├── CourseModel.php │ │ └── ScoreModel.php │ └── view/ # 模板 │ ├── student/ │ ├── teacher/ │ └── course/ ├── index/ # 前臺模塊學(xué)生/教師登錄后看到的頁面 │ ├── controller/ │ ├── model/ │ └── view/ ├── common/ # 公共模塊 │ ├── controller/ │ └── model/ config/ # 配置文件 public/ # 入口文件和靜態(tài)資源 route/ # 路由定義admin模塊是后臺管理端教務(wù)人員在這里維護基礎(chǔ)數(shù)據(jù)。index模塊是前臺學(xué)生和教師登錄后查看自己的課表、成績。common放一些公共的基類控制器和工具方法比如權(quán)限驗證、分頁封裝。這里有個細節(jié)值得注意ThinkPHP 的模塊劃分不是強制按角色分的但這份項目按admin和index拆開說明它在設(shè)計時就把管理端和用戶端做了隔離。好處是權(quán)限控制更清晰后臺的路由可以統(tǒng)一加中間件做登錄校驗前臺則走另一套邏輯。2.3 數(shù)據(jù)庫表設(shè)計的關(guān)鍵字段教學(xué)管理系統(tǒng)的核心表就那么幾張但字段設(shè)計直接影響后續(xù)查詢效率。我看了下它的表結(jié)構(gòu)幾個關(guān)鍵點學(xué)生表student里除了基本的姓名、學(xué)號、性別還有一個class_id字段關(guān)聯(lián)班級表。教師表teacher有title職稱和department所屬院系。課程表course有credit學(xué)分、hours學(xué)時、teacher_id關(guān)聯(lián)授課教師。成績表score是典型的中間表存student_id、course_id、score三個核心字段外加學(xué)期標識。排課表schedule的設(shè)計稍微復(fù)雜一點它需要同時存class_id、course_id、teacher_id、classroom_id、weekday、section第幾節(jié)。這幾個字段組合起來才能唯一確定一節(jié)課的時間和地點。提示如果你要二次開發(fā)建議先在schedule表上加一個聯(lián)合唯一索引防止同一時間同一教室被排兩門課。這個坑我在測試的時候踩過排課沖突不會報錯但數(shù)據(jù)會亂。3. 核心模塊拆解從登錄鑒權(quán)到成績錄入的完整鏈路3.1 登錄鑒權(quán)Session 還是 Token這份項目用的是 ThinkPHP 自帶的 Session 機制做登錄態(tài)保持。后臺管理員登錄后用戶信息寫入 Session后續(xù)請求通過一個基類控制器BaseController的_initialize()方法做校驗。如果 Session 里沒有用戶信息直接跳轉(zhuǎn)到登錄頁。// application/admin/controller/BaseController.php namespace app\admin\controller; use think\Controller; use think\Session; class BaseController extends Controller { protected function _initialize() { parent::_initialize(); // 檢查 Session 中是否存在管理員信息 $adminInfo Session::get(admin_info); if (empty($adminInfo)) { // 未登錄則跳轉(zhuǎn)到登錄頁 $this-redirect(admin/index/login); exit; } // 將管理員信息分配到模板方便視圖層使用 $this-assign(admin_info, $adminInfo); } }這段代碼的邏輯很直白所有后臺控制器繼承BaseController初始化時自動檢查登錄態(tài)。Session::get(admin_info)取不到就跳登錄頁。參數(shù)方面admin_info是一個數(shù)組存了管理員的id、username、role等字段。這種做法的優(yōu)點是簡單不用額外配 JWT 或 OAuth。缺點是 Session 依賴服務(wù)器存儲如果要做分布式部署得把 Session 換成 Redis 或數(shù)據(jù)庫驅(qū)動。ThinkPHP 的配置文件config/session.php里可以改type參數(shù)改成redis就行。3.2 學(xué)生管理一個典型的 CRUD 控制器學(xué)生管理模塊是理解整個項目代碼風格的入口。它的控制器方法基本遵循「列表 → 添加 → 編輯 → 刪除」四件套。// application/admin/controller/StudentController.php namespace app\admin\controller; use app\admin\model\StudentModel; use think\Request; class StudentController extends BaseController { // 學(xué)生列表支持按姓名和學(xué)號搜索 public function index() { $keyword input(keyword, ); $where []; if ($keyword) { // 模糊搜索姓名或?qū)W號 $where[name|student_no] [like, % . $keyword . %]; } $list StudentModel::where($where) -order(id, desc) -paginate(10); // 每頁10條 $this-assign(list, $list); $this-assign(keyword, $keyword); return $this-fetch(); } // 添加學(xué)生 public function add() { if (request()-isPost()) { $data input(post.); // 驗證必填字段 $validate validate(Student); if (!$validate-check($data)) { return json([code 0, msg $validate-getError()]); } $result StudentModel::create($data); if ($result) { return json([code 1, msg 添加成功]); } return json([code 0, msg 添加失敗]); } // 獲取班級列表供下拉選擇 $classList \app\admin\model\ClassModel::all(); $this-assign(classList, $classList); return $this-fetch(); } }index()方法里用input(keyword, )取搜索關(guān)鍵詞默認空字符串。$where[name|student_no]是 ThinkPHP 的查詢語法表示name或student_no滿足條件即可like做模糊匹配。paginate(10)自動生成分頁模板里用{$list-render()}輸出分頁鏈接。add()方法分兩步POST 請求時處理表單提交GET 請求時渲染添加頁面。驗證器validate(Student)對應(yīng)application/admin/validate/Student.php文件里面定義規(guī)則比如name必填、student_no唯一。這種把驗證邏輯抽到獨立文件的做法比在控制器里寫一堆if要清爽得多。3.3 成績錄入批量提交與數(shù)據(jù)校驗成績錄入是教學(xué)管理系統(tǒng)里交互最重的模塊。一個班幾十個學(xué)生不可能一條條提交。這份項目用的是表格批量提交前端把每行數(shù)據(jù)組裝成數(shù)組后端循環(huán)寫入。// application/admin/controller/ScoreController.php public function batchAdd() { if (request()-isPost()) { $data input(post.); $courseId $data[course_id]; $scores $data[scores]; // 格式[學(xué)生ID 分數(shù)] $insertData []; foreach ($scores as $studentId $score) { // 跳過未填寫的分數(shù) if ($score ) { continue; } // 校驗分數(shù)范圍 if (!is_numeric($score) || $score 0 || $score 100) { return json([code 0, msg 分數(shù)必須在0-100之間]); } $insertData[] [ student_id $studentId, course_id $courseId, score $score, create_time time() ]; } if (empty($insertData)) { return json([code 0, msg 沒有需要保存的成績]); } // 批量插入 $model new \app\admin\model\ScoreModel(); $result $model-saveAll($insertData); if ($result) { return json([code 1, msg 保存成功]); } return json([code 0, msg 保存失敗]); } }$scores是從前端傳過來的關(guān)聯(lián)數(shù)組鍵是學(xué)生 ID值是分數(shù)。循環(huán)里先跳過空值再做數(shù)值范圍校驗。saveAll()是 ThinkPHP 模型提供的批量插入方法比在循環(huán)里逐條create()效率高。注意這里沒有做重復(fù)提交的判斷如果同一門課重復(fù)錄入會插入多條記錄。二次開發(fā)時建議加一個unique索引或者先刪后插。注意批量插入時如果數(shù)據(jù)量很大比如超過 1000 條saveAll()可能會因為 SQL 語句過長而失敗。常見做法是分批處理每 500 條調(diào)一次saveAll()。3.4 排課模塊沖突檢測的簡單實現(xiàn)排課是教學(xué)管理系統(tǒng)里邏輯最繞的一塊。這份項目的排課邏輯不算復(fù)雜但基本的沖突檢測是有的。// application/admin/controller/ScheduleController.php public function add() { if (request()-isPost()) { $data input(post.); // 檢測同一教室同一時間是否已有課程 $conflict \app\admin\model\ScheduleModel::where([ classroom_id $data[classroom_id], weekday $data[weekday], section $data[section], week $data[week] ])-find(); if ($conflict) { return json([code 0, msg 該教室在此時間段已有課程安排]); } // 檢測同一教師同一時間是否已有課程 $teacherConflict \app\admin\model\ScheduleModel::where([ teacher_id $data[teacher_id], weekday $data[weekday], section $data[section], week $data[week] ])-find(); if ($teacherConflict) { return json([code 0, msg 該教師在此時間段已有課程安排]); } $result \app\admin\model\ScheduleModel::create($data); if ($result) { return json([code 1, msg 排課成功]); } return json([code 0, msg 排課失敗]); } }這段代碼做了兩層檢測先查教室沖突再查教師沖突。查詢條件是classroom_id weekday section week四個字段組合。如果find()返回非空說明有沖突直接返回錯誤信息。參數(shù)說明weekday是星期幾1-7section是第幾節(jié)1-5week是周次1-20。這三個字段加上教室或教師 ID就能唯一確定一個時間槽。這個實現(xiàn)有個局限它只檢測了教室和教師沖突沒有檢測班級沖突。也就是說同一個班在同一時間可能被排了兩門課。二次開發(fā)時可以把班級也加進檢測邏輯或者干脆做一個統(tǒng)一的沖突檢測方法把教室、教師、班級三個維度都覆蓋。4. 避坑與常見問題跑起來之前先看這幾條4.1 數(shù)據(jù)庫連接報錯配置文件沒改現(xiàn)象訪問首頁直接報「數(shù)據(jù)庫連接失敗」或者頁面空白但日志里有 SQL 錯誤。原因源碼里的config/database.php默認用的是開發(fā)環(huán)境的數(shù)據(jù)庫賬號密碼跟你本地的 MySQL 不一致。解決打開config/database.php把hostname、database、username、password改成你本地的配置。如果用的是 MySQL 8.0還要注意charset設(shè)成utf8mb4否則中文會亂碼。4.2 后臺登錄后跳回登錄頁Session 目錄沒權(quán)限現(xiàn)象輸入正確的賬號密碼點擊登錄后頁面閃一下又回到登錄頁沒有任何報錯。原因ThinkPHP 的 Session 默認存在runtime/session/目錄下如果這個目錄沒有寫權(quán)限Session 寫不進去登錄態(tài)就保持不住。解決給runtime/目錄加寫權(quán)限。Linux 下執(zhí)行chmod -R 777 runtime/Windows 下檢查目錄是否被只讀屬性鎖定。另外確認config/session.php里的path配置指向的是可寫目錄。4.3 排課沖突檢測失效字段類型不匹配現(xiàn)象明明已經(jīng)排了課再排同一時間同一教室系統(tǒng)還是提示成功。原因weekday和section字段在數(shù)據(jù)庫里是int類型但前端傳過來的是字符串。ThinkPHP 的查詢構(gòu)造器在某些版本里不會自動做類型轉(zhuǎn)換導(dǎo)致where條件匹配不上。解決在控制器里用intval()強制轉(zhuǎn)換或者把數(shù)據(jù)庫字段改成varchar并在查詢時統(tǒng)一格式。我一般會在input(post.)之后加一層數(shù)據(jù)過濾把所有整型字段轉(zhuǎn)一遍。4.4 成績批量保存超時SQL 語句過長現(xiàn)象一個班 50 個學(xué)生批量保存成績時頁面卡住最后報 500 錯誤。原因saveAll()會把所有數(shù)據(jù)拼成一條INSERT INTO ... VALUES (...), (...), ...的 SQL。數(shù)據(jù)量大的時候SQL 語句長度超過 MySQL 的max_allowed_packet限制。解決分批插入每 100 條調(diào)一次saveAll()?；蛘吒挠胕nsertAll()并手動控制批次大小。另外可以在config/database.php里把params的PDO::ATTR_EMULATE_PREPARES設(shè)為false讓 MySQL 用真正的預(yù)處理語句。4.5 模板樣式丟失靜態(tài)資源路徑不對現(xiàn)象頁面能打開但 CSS 和 JS 全部 404頁面排版全亂。原因源碼里的靜態(tài)資源路徑寫的是絕對路徑比如/static/css/style.css但你的部署環(huán)境可能把項目放在了子目錄下。解決把模板里的靜態(tài)資源路徑改成__STATIC__或__PUBLIC__這種 ThinkPHP 的模板常量它會自動解析成正確的 URL?；蛘咧苯釉赾onfig/template.php里配置tpl_replace_string做路徑替換。5. 二次開發(fā)上手從改一個字段到加一個模塊5.1 先跑通再改最小驗證流程拿到源碼后別急著改代碼。先按這個順序跑一遍第一步建數(shù)據(jù)庫導(dǎo)入 SQL 文件。源碼里一般會帶一個.sql文件用 Navicat 或命令行導(dǎo)入。導(dǎo)入后檢查表結(jié)構(gòu)是否完整特別是student、teacher、course、score、schedule這幾張核心表。第二步改config/database.php的數(shù)據(jù)庫配置。確認hostname、database、username、password四項跟本地一致。第三步配虛擬主機或直接用 PHP 內(nèi)置服務(wù)器。在項目根目錄執(zhí)行php -S localhost:8000 -t public/然后瀏覽器訪問http://localhost:8000。如果用的是 Apache 或 Nginx把網(wǎng)站根目錄指向public/目錄。第四步登錄后臺。默認管理員賬號一般在 SQL 文件里有注釋或者看admin表的第一條記錄。登錄后先別改數(shù)據(jù)點一遍各個菜單確認列表頁、添加頁、編輯頁都能正常打開。5.2 加一個字段以學(xué)生表加「手機號」為例假設(shè)要給學(xué)生的信息里加一個手機號字段需要改三個地方數(shù)據(jù)庫層面給student表加一列ALTER TABLE student ADD COLUMN phone VARCHAR(20) DEFAULT COMMENT 手機號;模型層面StudentModel.php里不需要額外改ThinkPHP 的模型會自動映射表字段。但如果要加驗證規(guī)則得改application/admin/validate/Student.php// application/admin/validate/Student.php namespace app\admin\validate; use think\Validate; class Student extends Validate { protected $rule [ name require|max:20, student_no require|unique:student, phone regex:/^1[3-9]\d{9}$/, // 手機號格式校驗 ]; protected $message [ name.require 姓名不能為空, student_no.unique 學(xué)號已存在, phone.regex 手機號格式不正確, ]; }視圖層面在application/admin/view/student/add.html和edit.html里加一個輸入框div classform-group label手機號/label input typetext namephone value{$info.phone|default} classform-control placeholder請輸入手機號 /div控制器不用改因為input(post.)會自動接收所有表單字段StudentModel::create($data)會自動寫入新字段。這就是 ThinkPHP 模型層的好處字段增減對控制器透明。5.3 加一個模塊以「教室管理」為例教室管理在原項目里可能沒有獨立模塊但排課表里用到了classroom_id。如果要加一個完整的教室管理模塊按這個步驟來先建表CREATE TABLE classroom (id INT PRIMARY KEY AUTO_INCREMENT, name VARCHAR(50), capacity INT, location VARCHAR(100));然后建控制器application/admin/controller/ClassroomController.php繼承BaseController寫index()、add()、edit()、delete()四個方法。代碼結(jié)構(gòu)跟StudentController一模一樣把模型換成ClassroomModel就行。接著建模型application/admin/model/ClassroomModel.php繼承think\Model定義$table屬性指向classroom表。最后建視圖目錄application/admin/view/classroom/放index.html、add.html、edit.html。模板可以直接從student目錄復(fù)制過來改一下字段名和標題。加完之后在后臺菜單里加一個鏈接指向/admin/classroom/index。菜單一般在application/admin/view/public/menu.html或者數(shù)據(jù)庫的menu表里配置。5.4 改造建議幾個值得動手的方向第一個方向是權(quán)限細化。原項目的權(quán)限控制只到「登錄/未登錄」這一層沒有區(qū)分管理員和普通教師。可以加一個role字段在BaseController里根據(jù)角色判斷能訪問哪些控制器。第二個方向是接口化。如果要做前后端分離可以把控制器里的return $this-fetch()改成return json($data)前端用 Vue 或 React 重寫。ThinkPHP 做純接口完全沒問題把視圖層去掉就行。第三個方向是排課算法優(yōu)化。原項目的沖突檢測是逐條查詢排一門課要查兩次數(shù)據(jù)庫。如果課程量大了可以一次性把該時間段的所有排課記錄查出來在內(nèi)存里做沖突判斷減少數(shù)據(jù)庫壓力。改造方向改動范圍難度適合場景權(quán)限細化BaseController 用戶表低多角色使用接口化控制器 前端重寫中前后端分離排課優(yōu)化ScheduleController中課程量大成績統(tǒng)計新增統(tǒng)計控制器低教務(wù)報表5.5 一個我踩過的坑第一次跑這個項目的時候我圖省事直接把源碼解壓到www根目錄然后訪問http://localhost。結(jié)果首頁能打開但所有鏈接都跳到了http://localhost/admin/index/index而實際文件在http://localhost/project/public/admin/index/index。折騰了半小時才反應(yīng)過來ThinkPHP 的入口文件在public/目錄下網(wǎng)站根目錄必須指向public/不能指向項目根目錄。從那以后我每次部署 ThinkPHP 項目都強制走一遍「確認網(wǎng)站根目錄指向 public」這個步驟?？雌饋硎切∈碌率趾苋菀自谶@里翻車。希望幫到你。本文還有配套的精品資源點擊獲取