PHP定时导入班级通信录需通过Linux cron自动执行独立脚本，完成Excel解析（推荐PhpSpreadsheet）、数据校验与MySQL写入，避免Web请求不可靠及路径、权限、环境配置陷阱。
PHP定时导入班级通信录数据，本质是「文件解析 + 数据库写入 + 定时触发」三步闭环
不能靠浏览器手动点一次就完事，得让服务器自动读 Excel/CSV 文件、校验字段、插入或更新 MySQL 表。核心不是“怎么写导入逻辑”，而是“怎么让这个逻辑在没人点的情况下准时跑起来”。
用 Linux cron 调用 PHP 脚本是最稳的定时方式
Web 请求（比如用 AJAX 或 cURL 触发 URL）不可靠：页面没打开、超时、session 限制、Apache/Nginx 进程重启都会中断；而 cron 是系统级守护进程，只要服务器开机就运行。
- 把导入逻辑写成独立 PHP 脚本，例如
/var/www/import_contacts.php，开头加#!/usr/bin/env php并设可执行权限（chmod +x import_contacts.php） - 脚本里用
fopen()或PhpSpreadsheet读取固定路径的 Excel（如/data/uploads/class_contacts.xlsx），别依赖$_FILES - 数据库连接必须用完整配置（host/user/pass/db），不能复用 Web 环境的 PDO 实例或 .env 文件（cron 环境无 $_SERVER['DOCUMENT_ROOT']）
- 加日志：用
error_log("导入完成，新增". $count ."条\n", 3, "/var/log/contact_import.log")，方便排查失败
Excel 解析别硬刚 zip/xml，优先用 PhpSpreadsheet 库
原生 fgetcsv() 只能处理纯 CSV；Excel（.xlsx）是 ZIP 包裹的 XML 结构，手动解压+解析极易出错。PhpSpreadsheet 是事实标准，且支持读取密码保护表（虽班级通信录一般不用）。
- 安装：
composer require phpoffice/phpspreadsheet - 读取示例片段：
$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load("/data/uploads/class_contacts.xlsx"); $worksheet = $spreadsheet->getActiveSheet(); foreach ($worksheet->getRowIterator() as $row) { $cellIterator = $row->getCellIterator(); $cellIterator->setIterateOnlyExistingCells(false); $data = []; foreach ($cellIterator as $cell) { $data[] = $cell->getValue(); } // 校验 $data[0] 是否为学号、$data[1] 是否为姓名等，再 insert into contacts ... } - 注意：避免用
getActiveSheet()->toArray()一次性载入——大文件（>5000 行）会 OOM；逐行迭代更安全
定时任务设置要避开权限和路径陷阱
常见失败不是脚本写错，而是 cron 环境找不到 PHP、读不到文件、连不上数据库。
立即学习“PHP免费学习笔记（深入）”；
- 在 crontab 里显式指定 PHP 路径：
/usr/bin/php /var/www/import_contacts.php（用which php确认） - 所有文件路径必须用绝对路径，
__DIR__在 cron 下可能指向 /root 或 /usr，不是你预期的项目目录 - MySQL 连接若用 localhost，部分环境会走 socket 而非 TCP，改用
127.0.0.1更可靠 - 测试命令先手动运行：
/usr/bin/php /var/www/import_contacts.php，成功后再加到 crontab - 加到 crontab 示例（每天早上 8:15 执行）：
15 8 * * * /usr/bin/php /var/www/import_contacts.php >> /var/log/contact_cron.log 2>&1
实际最难的部分是 Excel 字段映射和脏数据清洗——比如电话号码带空格、学号被 Excel 自动转成科学计数法、姓名列混入空行。这些没法靠定时机制解决，得在 PHP 脚本里做针对性 trim、typecast 和正则过滤。
