简介这是一套基于ThinkPHP框架开发的教育在线网完整源码面向想搭建在线教育平台或学习PHP Web开发的开发者与站长。系统包含会员中心、PC端与WAP手机自适应页面并集成在线教学与考试功能可用于数控培训等垂直领域的课程展示、用户管理与学习进度追踪。压缩包共约2000个文件大小130.83MB以442个php业务脚本、162个html页面、111个js与57个css构成前后端主体另有677个gif、336个jpg、237个png等图片素材及46个txt说明文档并附带sql数据库文件与更新说明便于二次开发与部署。目前已有1095人学习下载。源码结构完整涵盖会员注册登录、课程购买、考试系统等模块适合研究ThinkPHP项目架构、响应式设计与在线教育业务实现也可作为搭建同类培训平台的参考基础。1. 一套教育在线网源码为什么值得花时间拆开看拿到一套教育在线网完整源码第一反应往往不是兴奋而是犹豫——这东西到底能不能跑起来会员中心、PC 版、WAP 手机自适应、在线教学考试系统这几个模块是拼凑的还是真打通的。我见过太多所谓“完整源码”解压之后发现后台登录页都进不去考试模块只有一张静态表。所以这篇笔记不聊概念直接按一个一线工程师的视角把 ThinkPHP 内核的教育在线网从环境搭建、会员体系、双端适配到考试系统落地一层层拆开讲清楚。适合正在选型在线教育系统的开发者、需要二次开发的技术负责人以及想拿一套可运行项目练手的人。核心问题只有一个这套东西怎么跑通跑通之后哪些地方会翻车。2. 环境搭建与 ThinkPHP 内核初始化从解压到首页能打开2.1 先确认版本与目录结构别急着改代码ThinkPHP 内核的教育系统版本差异直接决定后续所有写法。TP5 和 TP6 在路由、中间件、容器绑定上完全是两套逻辑拿到源码第一步不是配数据库而是确认框架版本。常见做法是看根目录下think文件里的常量定义或者直接看composer.json里topthink/framework的约束。一个典型的教育在线网目录结构大致是这样├── application/ # 应用目录TP5或 app/TP6 │ ├── admin/ # 后台模块 │ ├── home/ # PC 前台 │ ├── wap/ # 手机端 │ └── api/ # 接口层 ├── public/ # 入口文件与静态资源 │ ├── index.php │ ├── static/ │ └── uploads/ ├── config/ # 配置文件 ├── extend/ # 扩展类库 ├── runtime/ # 运行时缓存 └── vendor/ # Composer 依赖如果application和app同时存在说明这套源码经历过版本迁移大概率是 TP5 升 TP6 没升干净这种项目要格外小心后面路由和模型关联容易出玄学问题。2.2 用命令把依赖和数据库跑起来确认版本后按下面步骤操作。假设是 TP6 环境PHP 要求 7.4 以上MySQL 5.7 或 8.0。# 1. 安装 Composer 依赖注意不要用 --no-dev教育系统常依赖 dev 包做调试 composer install # 2. 复制环境配置文件 cp .env.example .env # 3. 编辑 .env填入数据库信息 # APP_DEBUG true # [DATABASE] # TYPE mysql # HOSTNAME 127.0.0.1 # DATABASE edu_online # USERNAME root # PASSWORD your_password # HOSTPORT 3306 # CHARSET utf8mb4 # PREFIX edu_ # 4. 导入数据库注意先建库 mysql -uroot -p -e CREATE DATABASE edu_online DEFAULT CHARSET utf8mb4; mysql -uroot -p edu_online database/edu_online.sql # 5. 启动内置服务器测试 php think run --host 0.0.0.0 --port 8000这里有几个参数必须说清楚。PREFIX表前缀要和 SQL 文件里的实际前缀一致很多源码包里 SQL 用的是tp_但.env里写的是edu_结果就是首页能开、一登录就报“表不存在”。APP_DEBUG在调试阶段一定开生产环境必须关否则异常页会暴露数据库账号。php think run只适合本地验证正式部署要指向public目录做伪静态。2.3 首页能打开但样式全丢先查资源路径首页 HTML 出来了CSS 和 JS 全 404这是新手最常遇到的“假成功”。原因通常有两个一是public/static下的资源被.gitignore过滤掉了源码包里根本没有二是模板里用了__STATIC__这类常量但配置里的view_replace_str没定义。检查config/view.php或config/template.php// TP6 在 config/view.php 中配置 return [ tpl_replace_string [ __STATIC__ /static, __UPLOAD__ /uploads, ], ];如果资源确实缺失不要急着去网上找同款先看模板里引用的文件名很多教育系统用的是自己打包的压缩版缺了就得从备份或 CDN 补。这一步过了才算真正“首页能打开”。3. 会员中心与权限体系登录、角色、学习记录怎么串起来3.1 会员表设计决定了后续所有扩展教育在线网的会员中心不是简单的用户表它至少涉及四张核心表member会员主表、member_group会员组、member_auth权限规则、member_log学习/登录日志。很多源码为了省事把会员组和权限写死在代码里这种后期加一个“VIP 专属课程”就要改代码非常痛苦。一个可扩展的设计是会员组表里存rules字段用逗号分隔权限 ID登录时把权限写入 Session 或 Token控制器基类做统一校验。// application/common/controller/Base.php namespace app\common\controller; use think\Controller; use think\facade\Session; class Base extends Controller { protected function initialize() { parent::initialize(); $member Session::get(member); if (!$member) { $this-redirect(/member/login); } // 把会员组权限挂到实例上子控制器直接 $this-rules 用 $this-rules explode(,, $member[group_rules]); } // 通用权限检查考试、下载、看视频都调它 protected function checkAuth($ruleId) { if (!in_array($ruleId, $this-rules)) { $this-error(当前会员组无权访问); } } }这段代码的关键在initialize()里做了两件事登录态拦截和权限预加载。参数$ruleId对应member_auth表的主键考试提交、课程播放前调用checkAuth()即可。注意 Session 方案在 PC 和 WAP 混用时会有跨端问题如果 WAP 是独立域名建议改用 Token 存 Redis。3.2 学习记录与考试资格的联动会员中心里最容易被忽略的是学习记录表member_study。它记录会员看了哪个课程、看到第几秒、是否完成。考试系统判断“能不能考”时往往要查这张表。常见逻辑是课程完成度达到 100% 才解锁考试。-- 查询某会员某课程的完成状态 SELECT m.member_id, m.course_id, m.progress, c.exam_required FROM edu_member_study m LEFT JOIN edu_course c ON c.id m.course_id WHERE m.member_id 1001 AND m.course_id 5;如果progress字段是 0-100 的整数判断就简单但有些源码用is_finish布尔值遇到“看完但没点完成按钮”的情况就会卡住。我一般会加一个定时任务把progress 95的自动置为完成避免会员反复找客服。3.3 会员登录的三种方式和 Token 刷新PC 版通常用 SessionWAP 手机自适应版为了体验会用 Token。如果一套源码同时支持两端登录接口要能区分来源。// application/api/controller/Login.php public function doLogin() { $data input(post.); $member model(Member)-where(username, $data[username])-find(); if (!$member || md5($data[password] . $member[salt]) ! $member[password]) { return json([code 0, msg 账号或密码错误]); } // 根据来源生成不同凭证 if ($data[from] wap) { $token md5($member[id] . time() . rand(1000, 9999)); cache(token_ . $token, $member[id], 7200); // 2小时有效 return json([code 1, token $token]); } else { Session::set(member, $member-toArray()); return json([code 1, msg 登录成功]); } }参数from是前端传的标识wap走 Token其他走 Session。Token 存缓存并设 7200 秒过期比 JWT 简单适合中小型教育站。注意md5加盐只是常见做法如果源码里用的是password_hash不要混用否则老用户全部登录失败。4. PC 版与 WAP 手机自适应一套模板怎么同时伺候两端4.1 自适应不是 CSS 媒体查询就完事很多源码号称“WAP 手机自适应”实际只是 PC 模板加了几条media。真正的双端适配要在路由层就分流PC 访问home模块手机访问wap模块模板各自独立但共用模型和逻辑层。ThinkPHP 里可以用中间件做设备检测// application/middleware/DeviceCheck.php namespace app\middleware; use think\facade\Request; class DeviceCheck { public function handle($request, \Closure $next) { $userAgent Request::header(user-agent); $isMobile preg_match(/(android|iphone|ipad|mobile)/i, $userAgent); // 把设备类型注入请求控制器里直接 $request-isMobile 用 $request-isMobile $isMobile; return $next($request); } }注册中间件后在控制器里根据$request-isMobile决定跳转wap还是home。这样做的好处是 PC 和 WAP 的模板完全解耦改手机端不会影响电脑端。缺点是 URL 会变SEO 要做 canonical 处理。4.2 模板变量与静态资源路径的双端差异WAP 模板里图片尺寸、字体大小、按钮间距都和 PC 不同如果共用一套 CSS 变量维护成本很高。我一般会在 WAP 模板头部单独引入wap.css并覆盖关键类。!-- application/wap/view/index/index.html -- !DOCTYPE html html head meta charsetutf-8 meta nameviewport contentwidthdevice-width, initial-scale1, maximum-scale1, user-scalableno link relstylesheet href__STATIC__/wap/css/base.css link relstylesheet href__STATIC__/wap/css/index.css /head body div classcourse-list {volist namecourses idvo} div classcourse-item img src{$vo.thumb} alt{$vo.title} h3{$vo.title}/h3 span classprice{$vo.price}/span /div {/volist} /div /body /htmlviewport那行必须加否则手机上字小得看不清。__STATIC__常量在 WAP 模块下要指向/static/wap如果和 PC 共用会加载到错误样式。常见坑是 WAP 模板里用了 PC 的 JS 插件结果在手机上滑动卡顿排查时先看 Network 面板里加载了哪些脚本。4.3 双端登录态同步的取巧做法PC 登录了手机打开还要再登一次体验很差。如果两端同域名Session 天然共享如果 WAP 是独立子域名就要做跨域 Token 同步。简单做法是 PC 登录后生成一个一次性sync_code存缓存WAP 页面带sync_code请求接口换取 Token。// PC 登录成功后 $syncCode md5($member[id] . sync . time()); cache(sync_ . $syncCode, $member[id], 300); // 5分钟有效 $this-assign(sync_code, $syncCode); // WAP 端接口 public function syncLogin() { $code input(get.sync_code); $memberId cache(sync_ . $code); if (!$memberId) { return json([code 0, msg 同步码已过期]); } cache(sync_ . $code, null); // 一次性使用 $token md5($memberId . time() . rand(1000, 9999)); cache(token_ . $token, $memberId, 7200); return json([code 1, token $token]); }这个方案不涉及任何外部服务纯缓存实现适合中小项目。注意sync_code必须一次性否则被截获后可以反复换 Token。5. 在线教学考试系统组卷、答题、判分与防作弊的落地细节5.1 题库表与组卷策略考试系统的核心是题库。一个能用的题库至少要有question题目、question_option选项、exam_paper试卷、exam_question试卷题目关联四张表。组卷分随机和固定两种随机组卷要按题型和难度抽题。-- 随机抽取 10 道单选题难度 1-3 SELECT id, title, type, difficulty FROM edu_question WHERE type 1 AND difficulty BETWEEN 1 AND 3 ORDER BY RAND() LIMIT 10;ORDER BY RAND()在题量上万时会很慢常见优化是先用WHERE id (SELECT FLOOR(RAND() * (SELECT MAX(id) FROM edu_question))) LIMIT 10再补足数量。如果源码里直接用了RAND()题量大了考试页面会转圈很久这是典型性能坑。5.2 答题提交与自动判分答题提交要处理单选、多选、判断、填空。多选最容易出错因为选项顺序和用户勾选顺序不一致。// application/api/controller/Exam.php public function submit() { $paperId input(post.paper_id); $answers input(post.answers/a); // 格式[question_id A,B] $questions model(ExamQuestion)-where(paper_id, $paperId)-select(); $score 0; $detail []; foreach ($questions as $q) { $userAns isset($answers[$q[question_id]]) ? $answers[$q[question_id]] : ; $rightAns $q[answer]; // 多选拆分排序后比较避免顺序不同判错 if ($q[type] 2) { $userArr explode(,, $userAns); $rightArr explode(,, $rightAns); sort($userArr); sort($rightArr); $isRight $userArr $rightArr; } else { $isRight trim($userAns) trim($rightAns); } if ($isRight) { $score $q[score]; } $detail[] [qid $q[question_id], right $isRight]; } // 写入成绩表 model(ExamRecord)-save([ member_id Session::get(member.id), paper_id $paperId, score $score, detail json_encode($detail), create_time time(), ]); return json([code 1, score $score]); }关键在sort()那两行多选答案必须排序后比较否则用户选B,A和标准答案A,B会被判错这种 bug 上线后投诉最多。detail字段存 JSON方便后续做错题本。5.3 防作弊的轻量手段在线考试防作弊不可能做到绝对但可以拦住大部分。常见做法考试页面禁用右键和复制、切屏超过 3 次自动交卷、题目乱序、选项乱序。// public/static/exam/js/guard.js let switchCount 0; document.addEventListener(visibilitychange, function () { if (document.hidden) { switchCount; if (switchCount 3) { alert(切屏次数过多自动交卷); document.getElementById(examForm).submit(); } } }); // 禁用右键 document.oncontextmenu function () { return false; };这段 JS 放在考试模板底部即可。switchCount阈值设 3 是经验值设 1 太严设 5 太松。注意手机端visibilitychange在息屏时也会触发要加一个判断document.hidden且页面确实在考试中。6. 避坑与排查这套源码最容易翻车的 5 个地方6.1 登录后跳回登录页Session 存不进去现象输入正确账号密码提示成功但刷新又回登录页。原因通常是runtime目录没有写权限Session 文件写不进去或者 TP6 的 Session 默认关闭config/session.php里enable false。解决给runtime目录 755 权限确认 Session 开启并检查session.save_path是否可写。6.2 考试提交后分数为 0但答案明明是对的现象所有题都答了提交后 0 分。原因多半是answers数组的键名和question_id对不上前端传的是索引后端按 ID 取。解决在提交前打印input(post.answers/a)确认键名是题目 ID如果是索引要在前端提交时改成answers[question_id]格式。6.3 WAP 页面在手机上显示 PC 版现象手机打开还是电脑版布局。原因设备检测中间件没注册或者user-agent判断正则漏了某些机型。解决在app/middleware.php里注册DeviceCheck正则加上|micromessenger|覆盖微信内置浏览器。6.4 上传课程封面报“找不到驱动”现象后台上传图片提示驱动错误。原因config/filesystem.php里默认驱动是local但源码可能改成了oss或qiniu却没装对应 SDK。解决改回local或者composer require对应云存储包。本地测试阶段一律用local。6.5 数据库导入一半报错表结构不完整现象导入 SQL 时中途报错部分表没建。原因SQL 文件里有SET FOREIGN_KEY_CHECKS0但没恢复或者字符集不匹配。解决在 SQL 文件开头加SET NAMES utf8mb4;导入命令加--default-character-setutf8mb4并确保 MySQL 版本和 SQL 导出版本一致。7. 二次开发前值得先做的一件事把考试判分逻辑抽成独立服务这套源码跑通之后真正要投入二次开发我建议第一个动的不是界面而是把考试判分从控制器里抽出来。控制器里写判分逻辑改一次题型就要改一次控制器测试也难做。抽成一个独立的ExamService类控制器只负责收参数和返回 JSON。// application/common/service/ExamService.php namespace app\common\service; class ExamService { // 判一道题返回得分 public function judgeOne($question, $userAnswer) { $type $question[type]; $right $question[answer]; if ($type 2) { // 多选 $u explode(,, $userAnswer); $r explode(,, $right); sort($u); sort($r); return $u $r ? $question[score] : 0; } if ($type 3) { // 填空忽略大小写和首尾空格 return strtolower(trim($userAnswer)) strtolower(trim($right)) ? $question[score] : 0; } return trim($userAnswer) trim($right) ? $question[score] : 0; } // 判整张卷子 public function judgePaper($paperId, $answers, $memberId) { $questions model(ExamQuestion)-where(paper_id, $paperId)-select(); $total 0; $detail []; foreach ($questions as $q) { $ua isset($answers[$q[question_id]]) ? $answers[$q[question_id]] : ; $s $this-judgeOne($q, $ua); $total $s; $detail[] [qid $q[question_id], score $s]; } model(ExamRecord)-save([ member_id $memberId, paper_id $paperId, score $total, detail json_encode($detail), create_time time(), ]); return [score $total, detail $detail]; } }抽出来之后单元测试可以直接new ExamService()然后传假数据不用启动 HTTP 服务。填空题的strtolower处理是血泪经验用户填“PHP”和“php”应该都算对但有些源码严格区分大小写导致大量误判。多选排序比较也是同理。验证方法很简单造 10 道题其中 3 道多选、2 道填空手动构造答案数组跑judgePaper看总分和detail是否和预期一致。如果多选顺序打乱后分数不变说明排序逻辑生效了。最后一个习惯每次改完判分逻辑先把ExamRecord表备份一份再跑一遍历史数据对比。我吃过亏一次改填空题判分规则把之前已经及格的记录重新判成不及格会员直接炸锅。后来就养成了改判分前先备份、改完先跑回归的习惯。希望帮到你。本文还有配套的精品资源点击获取
