企业官网建设流程全解析

简介：这是一套基于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 版本要求。

我一般会按这个顺序确认环境：

PHP 版本这块有个血泪经验：如果项目用的是 ThinkPHP 6.x，PHP 千万别低于 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 'root'@'localhost' 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、传空字符串，看返回是不是符合预期。我见过太多系统页面看着正常，接口一测全是洞。从那以后我每次改完核心逻辑，都强制走一遍接口边界测试，这个习惯帮我省了至少三次线上事故。希望这套东西能帮到你，少走点弯路。

本文还有配套的精品资源，点击获取