IMathAS 开源项目最佳实践教程

1. 项目介绍

IMathAS（Internet Mathematics Assessment System）是一个网络数学评估系统。它主要用于在线交付和自动批改数学作业和测试，类似于出版社提供的系统。该系统可以生成算法问题，并且能够计算机批改数值和数学表达式答案。IMathAS 还包含了学习管理工具，例如发布文件、讨论论坛和完整的成绩册。该系统可以作为 LTI 工具，与学习管理系统（LMS）集成。

IMathAS 支持多个平台，例如 MyOpenMath.com、WAMAP.org、Lumen OHM、XYZhomework 等。

2. 项目快速启动

环境要求

• PHP 7.4+ 版本
• MySQL 5.6+ 版本
• PHP 扩展：mbstring、pdo_mysql、gettext
• 推荐扩展：gd（带 freetype 支持）、zip、curl、openssl

安装步骤

1. 下载 IMathAS，解压文件，并将文件复制到您的 Web 服务器。 或者，如果您的服务器有壳访问权限，可以进入希望安装 IMathAS 的目录，并从 Github 检出代码。使用 Git 可以大大简化升级过程。

2. 为 IMathAS 创建数据库。

3. 打开浏览器并访问 /install.php。此脚本将生成 config.php 文件，更改目录权限并设置数据库。它还会创建 loginpage.php、infoheader.php 和 newinstructor.php 的本地副本。安装结束时，您将有机会安装一组示例问题。

4. 确保以下目录具有目录权限，允许 Web 服务器写入文件：

   • /assessment/libsassessment/qimages
   • /admin/import
   • /course/files
   • /filter/graph/imgs
   • /filestore（如果不使用 S3 存储）

5. 登录 IMathAS。如果在运行 install.php 时未更改初始 imathas 用户设置，请以 'root' 用户名和密码 'root' 登录。

6. 如果需要，编辑 loginpage.php 和 infoheader.php 来自定义登录页面。如果计划使用新教师账户请求页面，可以自定义 newinstructor.php。

升级

• 要更新软件，可以复制更新后的文件到 Web 服务器，或者如果您使用 Git 安装，运行 git pull。更新文件后，访问 /upgrade.php 来运行任何必要的数据库迁移。注意查看输出，因为偶尔会显示需要配置更改的消息。

3. 应用案例和最佳实践

• 定制化: 根据 config.php 中的变量定制安装，如数据库设置、安装名称、登录提示等。
• 安全性: 设置 $CFG['GEN']['newpasswords'] 为 'only' 以使用高质量的密码安全。
• 数据迁移: 使用 upgrade.php 脚本确保数据库结构与最新版本同步。
• 权限管理: 合理设置目录权限，确保 Web 服务器可以写入必要的文件。

4. 典型生态项目

• MyOpenMath.com: 使用 IMathAS 提供开放数学资源的平台。
• WAMAP.org: 为华盛顿州提供数学评估服务。
• Lumen OHM: 开放数学课程。

以上是 IMathAS 的最佳实践教程，希望能帮助您更好地使用和维护这个开源项目。