★ FEATURED ARTICLE 简介面向学校、培训机构招生报名场景的PHP源码项目提供一套轻量级的学生报名管理系统。功能覆盖报名业务全流程按区域分区管理登记报名号、姓名、性别、出生年月、毕业学校、身份证号、家庭住址、父母姓名、联系电话等字段并支持摄像头拍照留存工作人员可手动分配考场座位号直接打印准考证还能汇总数据并导出为Excel适合需要快速开展线下报名和考场安排的单位使用。压缩包采用zip格式大小2.37MB文件总数与类型明细暂缺包内含程序代码目录和MySQL数据库脚本数据库连接参数可在www/manager/config/database.php中修改默认管理员账号admin、密码123456。目前已有519人学习/下载。源码整体结构清晰适合PHP初学者学习报名系统的模块划分与Excel导出思路也适合机构IT人员直接部署、按实际流程做字段或页面调整。1. 学生报名系统 v2012零依赖的老项目半小时就能跑起来我接过一个某职业学院的内部报名系统对方说这是 2012 年找人写的 PHP 源码需求很简单学生在线填表报名后台能看数据能按专业和时间段筛选最后导出一份 Excel 名单。真正拆开我才发现这类老项目最大的价值不是“界面多么现代化”而是零依赖——没有框架、没有 Composer 包、没有复杂构建流程十几个 PHP 文件加一张 sql 就能完整跑起来。对想快速复用一个报名场景的开发者来说它比很多脚手架都好改改字段直接上数据库加功能直接改单页逻辑不需要先学一套框架约束。下面我从架构到核心代码再到实际部署和二次开发把整个系统讲透。2. 整体架构拆解页面、路由与数据表的三角关系一个 2012 年的原生 PHP 项目通常不会有现在常见的 MVC 分层。你打开目录看到的第一反应是“就这些文件”——这就是当时 Web 开发的真实状态入口写在页面里逻辑按“页面 包含文件”的方式组织能复用就 include不能复用就再写一个函数。2.1 目录结构与请求流转项目源码的目录结构大致如下student-signup-2012/ ├── index.php # 报名首页展示表单 ├── submit.php # 接收表单 POST 请求 ├── verify.php # 校验数据并写入数据库 ├── success.php # 报名成功提示页 ├── includes/ │ ├── config.php # 数据库连接配置 │ ├── db.php # 初始化 $mysqli 连接 │ ├── functions.php # 公共函数过滤、分页、文件导出 │ └── check_admin.php # 后台登录鉴权 ├── admin/ │ ├── login.php # 管理员登录页 │ ├── dashboard.php # 报名数据统计概览 │ ├── list.php # 报名列表 条件筛选 │ └── export.php # 导出 CSV/Excel 文件 ├── assets/ │ ├── style.css # 样式文件 │ └── js/ │ └── validate.js # 前端基础校验 └── sql/ └── signup.sql # 建表语句和初始数据这个目录值得注意的点在于includes下是公共层admin目录则是独立的后台模块和前台报名完全分开。前台页面只管“收集数据”后台页面只管“展示和导出”数据表是唯一纽带。请求流动是学生打开 index.php → 填写并提交到 submit.php → 转给 verify.php 做校验和入库 → 跳转到 success.php管理员走的是另一条线登录 admin/login.php → 跳转 dashboard.php → 进入 list.php 筛选 → export.php 导出。这种设计虽然古老但理解成本极低。如果你要改“报名后自动发一封邮件”直接在 verify.php 末尾加一段代码就行不用去翻控制器和模型之间的调用链。2.2 技术选型说明老项目的技术选型决定了它今天为什么会“这么好跑”。我整理了一张当时的选型表技术层选型理由服务端语言PHP 5.x2012 年前后的虚拟主机普遍自带 PHP不需要额外装运行环境数据存储MySQL 5.xInnoDB报名场景数据量小单表就能扛住几千条并发写入前端HTML 原生 CSS 少量 JS避免 CDN 不稳定导致表单无法加载导出功能PHP 直接生成 CSV不依赖 php-excel 之类第三方库CSV 能被 Excel 直接打开今天回头看这套选择不追求“架构优雅”但求“换台机器就能跑”。对于绝大部分中小型报名场景——一个学校几百人、一家公司做活动收集信息——这个量级根本不需要引入 Redis 或者队列MySQL 单表加索引已经绰绰有余。在开发时我常看到一种误用项目还不到一千条数据就急着上框架、上消息队列结果部署成本比业务本身还高。这份源码反而是个提醒——把合适的技术用在合适的规模上。2.3 数据库设计核心表结构分析整个系统只有两张核心表一张存报名数据一张存管理员账号。最关键的表结构如下CREATE TABLE student_signup ( id INT(10) UNSIGNED NOT NULL AUTO_INCREMENT, stu_no VARCHAR(20) NOT NULL COMMENT 学号/证件号, name VARCHAR(50) NOT NULL COMMENT 姓名, gender TINYINT(1) NOT NULL DEFAULT 1 COMMENT 1男 2女, major VARCHAR(100) NOT NULL COMMENT 报名专业/方向, mobile VARCHAR(11) NOT NULL COMMENT 手机号, email VARCHAR(100) DEFAULT NULL COMMENT 邮箱, remark TEXT COMMENT 备注, status TINYINT(1) NOT NULL DEFAULT 1 COMMENT 1有效 0作废, create_time DATETIME NOT NULL, PRIMARY KEY (id), KEY idx_stu_no (stu_no), KEY idx_major (major) ) ENGINEInnoDB DEFAULT CHARSETutf8; CREATE TABLE admin_user ( id INT(10) UNSIGNED NOT NULL AUTO_INCREMENT, username VARCHAR(30) NOT NULL, password VARCHAR(32) NOT NULL COMMENT MD5 加密存储, last_login DATETIME DEFAULT NULL, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8;这里有几个设计细节值得展开。第一stu_no加上了普通索引idx_stu_no但没有做成唯一索引因为当年的业务允许“同一学号报名多个专业方向”查重逻辑交给程序去判断而不是数据库硬性约束。如果你要改成“一人只能报一次”直接把stu_no改成 UNIQUE KEY 更省事。第二create_time用的是 DATETIME 而不是 TIMESTAMP一方面是老项目习惯另一方面 DATETIME 的显示不依赖时区换算导出到 Excel 时不容易出现“差 8 小时”的诡异问题。还有一点值得借鉴remark用了 TEXT 而不是 VARCHAR因为备注内容是开放输入的长度不可控而 VARCHAR 超过长度直接报错。第三密码字段用 MD5 是当时的历史遗留存 32 位十六进制字符串。我在二次开发时建议升级成password_hash()不过在跑通阶段它不影响功能。3. 核心代码走读一条报名数据从表单到报表的完整链路技术选型看完了现在进入真正关键的代码部分。我会按“提交参数 → 写入数据库 → 后台导出”这条链路来拆把最容易踩坑的细节都标出来。3.1 submit.php表单入口与初层过滤报名流程的入口是submit.php它负责接收前端 POST 过来的数据并做第一层检查。核心代码大致如下?php // submit.php session_start(); require_once __DIR__ . /includes/config.php; require_once __DIR__ . /includes/functions.php; // 基础必填项检查姓名、学号、专业不能为空 if (empty($_POST[name]) || empty($_POST[stu_no]) || empty($_POST[major])) { header(Location: index.php?msg . urlencode(请填写完整报名信息)); exit; } // 校验学号格式这里做统一过滤防止把特殊字符带进 SQL $stuNo trim(preg_replace(/[^a-zA-Z0-9\-]/, , $_POST[stu_no])); if (strlen($stuNo) 4 || strlen($stuNo) 20) { header(Location: index.php?msg . urlencode(学号格式不正确)); exit; } // 简单判断手机号老项目用长度判断不引入复杂正则 $mobile trim($_POST[mobile]); if (!preg_match(/^1[3-9]\d{9}$/, $mobile)) { header(Location: index.php?msg . urlencode(手机号格式不正确)); exit; } // 把清理后的参数存进一个独立的数组后续统一使用 $safeData [ name trim(strip_tags($_POST[name])), stu_no $stuNo, gender intval($_POST[gender]), major trim(strip_tags($_POST[major])), mobile $mobile, ];这段逻辑在今天的 PHP 项目中依然常见只是写法上老了一些。重点在于两个习惯一是用header(Location: ...)做错误回跳而不是直接输出 JSON二是所有进入变量的参数都做了strip_tags和trim。原因是 2012 年 XSS 攻击已经开始流行而 strip_tags 是当时最“暴力”也最直接的过滤方式。$safeData这个数组的设计很实用后续所有写入操作都从这个数组取值避免直接操作$_POST提升了代码可读性。要注意这里只是第一层过滤真正的 SQL 注入防护在下一层。3.2 verify.php防重复提交与 SQL 写入verify.php是整条链路最关键的一步它既要检查重复报名又要真正执行插入操作。我拆出其中最重要的防重复逻辑?php // verify.php —— 真正处理写入的地方 session_start(); require_once __DIR__ . /includes/config.php; require_once __DIR__ . /includes/functions.php; // 防重复提交对比表单携带的 token 与 session 中存储的值 if ($_POST[form_token] ! $_SESSION[form_token]) { header(Location: index.php?msg . urlencode(请勿重复提交)); exit; } // 校验“该学号是否已经报名过同样专业” $stmt $mysqli-prepare( SELECT COUNT(*) FROM student_signup WHERE stu_no ? AND major ? ); $stmt-bind_param(ss, $stuNo, $major); $stmt-execute(); $stmt-bind_result($count); $stmt-fetch(); $stmt-close(); if ($count 0) { header(Location: index.php?msg . urlencode(该学号已报名此专业)); exit; } // 写入数据库 $insertStmt $mysqli-prepare( INSERT INTO student_signup (stu_no, name, gender, major, mobile, email, remark, status, create_time) VALUES (?, ?, ?, ?, ?, ?, ?, 1, NOW()) ); $insertStmt-bind_param( ssissss, $safeData[stu_no], $safeData[name], $safeData[gender], $safeData[major], $safeData[mobile], $email, $remark ); $insertStmt-execute(); $insertStmt-close();这里两个细节值得说透。第一是防重复提交机制老项目用form_token判断——表单页把 token 存在 session 里提交时比较一旦校验通过就更新 session 中的 token 值。这样做的好处是用户快速刷新浏览器重复提交时第二次携带的 token 已经失效直接返回“请勿重复提交”比单纯靠数据库查重更及时。第二是 mysqli 的预处理语句。这是我在整理源码时最想点赞的地方——2012 年的很多 PHP 项目都是字符串拼接 SQL而这套系统用了bind_param占位符从根本上避免了 SQL 注入。bind_param的参数顺序要对应 SQL 里的问号第一个参数ssissss表示七个参数的类型依次是字符串、字符串、整数、字符串、字符串、字符串、字符串。写错一个字母数据入库时就会出现类型错乱这是新手最容易翻车的点。3.3 后台列表与导出实现筛选条件拼装和 CSV 文件生成后台list.php负责展示报名列表同时支持按专业、按状态、按时间段筛选。筛选条件的拼接是这类老项目的典型写法?php // admin/list.php —— 拼接查询条件 $where []; $params []; $types ; if (!empty($_GET[keyword])) { $where[] (name LIKE ? OR stu_no LIKE ?); $params[] %{$_GET[keyword]}%; $params[] %{$_GET[keyword]}%; $types . ss; } if (!empty($_GET[major])) { $where[] major ?; $params[] $_GET[major]; $types . s; } if (!empty($_GET[status])) { $where[] status ?; $params[] intval($_GET[status]); $types . i; } $sql SELECT * FROM student_signup; if ($where) { $sql . WHERE . implode( AND , $where); } $sql . ORDER BY create_time DESC, id DESC;这种动态拼 SQL 的方式在无框架项目里最常用也最容易漏掉一个括号。常见的坑是$where里的数组元素用implode( AND , $where)拼出了完整的 WHERE 子句但第一个条件之前一定不能误加AND否则查出来永远是空列表。调试时先echo $sql看拼出来的语句比什么都快。然后是导出功能export.php老项目通常不装 PHPExcel直接用 CSV 方案。我从代码里摘出了最关键的部分?php // admin/export.php —— 导出 CSV 文件 header(Content-Type: text/csv; charsetutf-8); header(Content-Disposition: attachment; filenamesignup_ . date(Ymd_His) . .csv); // 输出 BOM 头否则用 Excel 打开 CSV 时中文会乱码 echo \xEF\xBB\xBF; $output fopen(php://output, w); fputcsv($output, [学号, 姓名, 性别, 专业, 手机号, 报名时间]); $result $mysqli-query( SELECT stu_no, name, gender, major, mobile, create_time FROM student_signup ORDER BY create_time DESC ); while ($row $result-fetch_assoc()) { $genderText ($row[gender] 1) ? 男 : 女; fputcsv($output, [ $row[stu_no], $row[name], $genderText, $row[major], $row[mobile], $row[create_time] ]); } fclose($output); exit;这里最关键的一行是echo \xEF\xBB\xBF。CSV 本质是纯文本Excel 默认按系统编码打开没有 BOM 的话 UTF-8 中文会直接变乱码。这个 BOM 头是很多开发者找半天才发现的“玄学”原因后面章节我会再展开踩坑记录。使用fopen(php://output, w)配合fputcsv的好处是数据边读边写内存占用恒定几千条数据也不会卡死。4. 本地运行指南在兼容环境下把系统跑起来这部分写给想立刻复现的人。整个运行过程十五分钟可以完成难点全在“PHP 版本”这一个地方。4.1 环境准备版本选择是关键原版代码基于 PHP 5.x 编写最稳妥的运行环境是 PHP 5.4 到 5.6 搭配 MySQL 5.5 或 5.6。如果你机器上只有 PHP 7.x 或 8.x建议使用集成环境工具切到 PHP 5.6 版本再跑能省掉后面一堆兼容性修改。我建议的本地环境组合是 Apache PHP 5.6 MySQL 5.6这在任何一款 Windows 集成环境里都能一键完成。为什么不用 PHP 8因为老代码中可能用到mysql_*函数或者each()、create_function()这些 PHP 7 已经删除的语法直接亮起白屏。先用兼容版本跑通再谈升级。数据库连接配置集中在includes/config.php里内容如下?php // includes/config.php date_default_timezone_set(Asia/Shanghai); define(DB_HOST, 127.0.0.1); define(DB_USER, root); define(DB_PASS, root); define(DB_NAME, student_signup); $mysqli new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME); if ($mysqli-connect_errno) { die(数据库连接失败: . $mysqli-connect_error); } $mysqli-set_charset(utf8);重点确认三处主机地址、数据库账号密码、数据库名。连接失败时页面会直接提示但这个提示不会告诉你原因需要去connect_errno抓错误码。通常 1045 就是账号密码错了2002 是端口或者服务没起来。4.2 部署步骤从解压到出现第一条报名记录部署本身不复杂但每个环节都有容易忽略的细节。我浓缩成以下几步将源码整个目录拷贝到集成环境的网站根目录下例如D:/phpstudy_pro/WWW/student-signup-2012。在集成环境的数据库中新建一个student_signup数据库字符集选utf8_general_ci。导入sql/signup.sql里面自带建表语句和默认管理员数据。修改includes/config.php里的数据库密码改成你本地的实际密码。浏览器访问http://localhost/student-signup-2012/index.php填写一条测试数据并提交。访问http://localhost/student-signup-2012/admin/login.php用默认账号登录后台查看测试数据是否出现在列表里。前两步如果没做对后面的流程全卡住。尤其是字符集一定要选utf8_general_ci如果选成latin1_swedish_ci数据写入后再导出的内容可能是乱码。命令行提交验证更直接可以在终端用 curl 模拟一次报名curl -s -X POST http://localhost/student-signup-2012/verify.php \ -d stu_no2024001name张三gender1major计算机应用mobile13800001111emailzhangsantest.comform_tokentest正常情况会收到 302 跳转响应location 指向success.php。如果返回 500去看 Apache/PHP 的 error_log多数是 SQL 语句问题或字段不匹配。这一步能帮你跳过浏览器前端校验直接验证后端逻辑是否通顺。4.3 默认管理员账号与后台验证sql/signup.sql里一般会预置一个默认管理员常见组合是admin/admin123。初始化的 SQL 大致是这样INSERT INTO admin_user (username, password) VALUES (admin, MD5(admin123));登录成功后你会看到后台统计面板通常显示三个数字总报名人数、今天新增人数、按专业分类统计。如果数字对不上先怀疑统计 SQL 的 WHERE 条件写错再去查status1的数据是否被误更新。老项目的默认账号是最大的安全隐患跑通后第一件事就是改密码。建议直接在 phpMyAdmin 里执行UPDATE admin_user SET password MD5(你的新密码) WHERE username admin;5. 踩坑与排查乱码、白屏和高版本 PHP 的兼容性把老项目跑到能用的状态途中一定会碰到几个问题。我把最常见的四类整理在这里每条都是实际血泪经验。5.1 现象报名页能打开提交后返回 500 错误原因定向最直接的原因是 PHP 版本太高。2012 年的代码里如果用了mysql_connect()在 PHP 7 以上直接报函数不存在。这类错误不算语法错误不会在页面显示只会在日志里留一行Call to undefined function mysql_connect()。解决方式有两个第一将集成环境的 PHP 切换到 5.6 版本老代码原样运行第二将代码里所有mysql_*函数替换成mysqli。替换时要把mysql_connect($host, $user, $pass)改成new mysqli($host, $user, $pass, $db)并调整后续的查询写法// 旧写法仅适用于 PHP 5.x $conn mysql_connect(DB_HOST, DB_USER, DB_PASS); mysql_select_db(DB_NAME, $conn); $result mysql_query(SELECT * FROM student_signup, $conn); // 新写法PHP 5.3 都可使用 $mysqli new mysqli(DB_HOST, DB_USER, DB_PASS, DB_NAME); $result $mysqli-query(SELECT * FROM student_signup);我自己的习惯是能切版本就先切版本跑通再考虑迁移减少变量。那些“换到新版本顺便重构”的计划往往卡在无限调试中。5.2 现象导出的 Excel 打开后中文全是乱码原因CSV 文件没有加 BOM 头。Excel 在 Windows 下默认按 ANSI 编码读取 CSV如果文件是 UTF-8 编码但没有 BOM 标记Excel 就把它当成 ANSI 解析中文全部变成“鏁??”一类符号。解决方式很简单在输出任何数据之前先打印 BOM再写表头和数据。注意fputcsv之前必须先把 BOM 放进输出流header(Content-Type: text/csv; charsetutf-8); header(Content-Disposition: attachment; filenamesignup.csv); // 必须放在 fputcsv 之前 echo \xEF\xBB\xBF;如果嫌 CSV 乱码太烦也可以改输出为 HTML 表格并借助 Excel 的格式识别能力。这是我后来采用的做法把数据拼成一个带XML头声明的 HTML 表格文件后缀改.xlsExcel 也能直接打开中文不会乱兼容性甚至更好。5.3 现象系统自动记录的时间与本地时间相差 8 小时原因PHP 默认时区是 UTC而数据库写入用的是NOW()取的是 MySQL 服务器时区。如果两者都偏 UTC记录就会比北京时间慢 8 小时而且导出时间也是错位的。解决方式是双管齐下PHP 与 MySQL 两边都设时区。PHP 侧在config.php开头加入date_default_timezone_set(Asia/Shanghai);MySQL 侧在每次连接成功后执行一次时区设置$mysqli-query(SET time_zone 08:00);如果只改一边可能出现“PHP 显示正常了但数据库存进去的还是 UTC”的割裂状态排查耗时不少改成两边同步设时区后彻底正常。5.4 现象后台登录后每跳转一个页面就要求重新登录原因这是 session 目录权限问题不是密码问题。PHP 默认把 session 文件写到系统临时目录在 Windows 的某些集成环境下该目录没有写权限session 文件创建失败自然连不上原来的会话。解决方式是在config.php里显式指定 session 存储目录或者在集成环境面板中检查session.save_path的设置。我通常建一个_session目录并配置如下ini_set(session.save_path, __DIR__ . /../_session); session_start();同时检查浏览器是否禁用了 Cookie。如果 Cookie 被禁session ID 传不回来也会表现为“反复要求登录”。这不是什么黑匣子问题把运行日志打开扫一眼很快就看到警告信息。5.5 现象第二次打开报名页时session 里的 token 不生效原因表单页的 token 生成逻辑可能出现了交叉。如果index.php和verify.php都调用了session_start()但includes/functions.php里的 token 生成函数只在特定条件下执行第二次打开时 session 里的旧 token 还没更新就会误判成“重复提交”。解决方式是在生成 token 时确保每次页面渲染都重新生成并在提交成功后更新// 页面加载时生成新 token $_SESSION[form_token] md5(uniqid(mt_rand(), true)); // 提交成功后刷新 token if ($_POST[form_token] $_SESSION[form_token]) { $_SESSION[form_token] md5(uniqid(mt_rand(), true)); }关键点在于“提交成功后立刻刷新”否则用户点了返回再重新提交会一直提示重复提交体验很差。6. 二次开发实战把写死的字段改成配置驱动源码跑通只是起点真正的价值在于“按自己的业务改”。对一个报名系统来说最高频的改动是“我要加字段”——比如加一个“身份证号”加一个“紧急联系人”。如果直接改数据库和页面每改一次就要动三处表结构、前台表单、后台列表。更优雅的做法是把字段定义抽成配置让系统自己渲染表单。我建议先设计一个字段配置文件比如config/fields.json{ required_fields: [name, stu_no, major, mobile], fields: { name: { label: 姓名, type: text }, stu_no: { label: 学号, type: text }, major: { label: 报名专业, type: select, options: [计算机应用, 电子商务, 会计] }, mobile: { label: 手机号, type: text } } }表单页不再写死每个 input而是循环渲染?php // index.php 中动态渲染表单 $config json_decode(file_get_contents(config/fields.json), true); foreach ($config[fields] as $key $field) { $required in_array($key, $config[required_fields]) ? required : ; echo label{$field[label]}/label; if ($field[type] select) { echo select name\$key\ $required; foreach ($field[options] as $option) { echo option value\$option\$option/option; } echo /select; } else { echo input type\text\ name\$key\ $required; } }对应的校验逻辑也改成读配置?php $config json_decode(file_get_contents(config/fields.json), true); $errors []; foreach ($config[required_fields] as $key) { if (empty($_POST[$key])) { $errors[] $config[fields][$key][label] . 不能为空; } } if (!empty($errors)) { echo implode(br, $errors); exit; }这样改完之后新增字段只需要做两件事在fields.json加一段配置在数据表执行一条ALTER TABLE。页面、校验、导出全部自动适配二次开发的效率能提升一倍。我验证这个方法时写了一个命令行脚本模拟批量报名直接确认动态配置没有遗漏for i in $(seq 1 100); do curl -s -X POST http://localhost/student-signup-2012/verify.php \ -d stu_no20240${i}name测试用户${i}major计算机应用mobile1380000${i} \ -o /dev/null -w %{http_code}\n done看返回码是否全是 302再进后台核对统计数字改造前后的数据一致性一目了然。如果你还想升级密码存储方案把admin_user.password的 MD5 改为password_hash()验证也是值得做的一步。这套系统的核心价值不在界面而在于它提供了一条清晰的“单机 PHP 业务闭环”样本表单收集、数据校验、后台管理、文件导出每个环节都直白可改。我后来接手任何老项目第一件事就是先跑通一个最小流程给旧代码留下“后悔药”的余地——在数据库改动前先备份原表并记录下最初的配置文件。从那以后我每次给这类系统加字段都会强制走一遍“配置驱动”的流程而不是急着去改 HTML 模板。希望这些拆解能帮你少走点弯路把这份 v2012 的源码变成自己顺手的一套报名工具。本文还有配套的精品资源点击获取
阅读完成 · 觉得有帮助？
