localhost/moodle 安装指南（含 install.php）
在本地安装 Moodle LMS：访问 http://localhost/moodle 与 localhost/moodle/install.php，配置 moodledata、数据库与常见安装报错排查。
搜索 localhost/moodle、http://localhost/moodle 或 localhost/moodle/install.php 时，通常是在本机安装或打开 Moodle（开源 LMS）。本文给出默认路径、安装步骤与安装向导地址。
默认 URL 一览
| 阶段 | 地址 | 说明 |
|---|---|---|
| 站点首页 / 登录 | http://localhost/moodle | 解压到 htdocs/moodle/ 后的入口 |
| 安装向导 | http://localhost/moodle/install.php | 首次安装或配置未完成时出现 |
| 站点管理 | http://localhost/moodle/admin | 安装完成后的后台 |
| 数据库升级 | http://localhost/moodle/admin/index.php | 版本升级后运行 |
同类写法：localhost moodle、moodle localhost、http //localhost/moodle。
需先有 PHP + 数据库环境，例如 XAMPP、WAMP、MAMP。建库可用 phpMyAdmin。
前置条件
- PHP 8.0+（以 Moodle 版本要求 为准）
- MySQL/MariaDB 或 PostgreSQL
- 扩展：
intl、zip、gd、soap、xmlrpc（若版本仍需要）等——安装器会列出缺失项 - 数据目录
moodledata：Web 服务器可写，且不要放在可通过 URL 直接访问的目录里
安装步骤
- 从 download.moodle.org 下载稳定版
- 解压到
htdocs/moodle/（WAMP 多为www/moodle/） - 在 Web 根目录外创建数据目录，例如：
- Windows：
C:\moodledata - macOS / Linux：
/var/moodledata（权限给www-data或当前 Web 用户）
- Windows：
- 在 phpMyAdmin 创建数据库
moodle_local，字符集utf8mb4 - 浏览器打开 http://localhost/moodle
- 若跳到或提示安装，也可直接打开 http://localhost/moodle/install.php
- 按向导填写 wwwroot、数据目录绝对路径、数据库信息，创建管理员账号
安装向导关键字段
| 项 | 示例 |
|---|---|
| Web 地址（wwwroot） | http://localhost/moodle |
| 数据目录 | C:\moodledata 或 /var/moodledata（绝对路径） |
| 数据库主机 | localhost |
| 数据库名 | moodle_local |
常用路径
| 路径 | 说明 |
|---|---|
/moodle | 站点首页 / 登录 |
/moodle/install.php | 安装脚本（首次） |
/moodle/admin | 管理界面 |
/moodle/course | 课程 |
/moodle/mod/ | 活动模块 |
本地开发提示
- 开启调试：站点管理 → 开发 → 调试消息
- 升级代码后访问
/admin/index.php跑数据库升级 - 生产需 cron；本地可手动访问
/admin/cron.php
常见问题
打开 localhost/moodle 出现 404
目录是否叫 moodle；Apache 是否启动；是否误用 MAMP 的 8888 端口。
卡在 install.php / 数据目录不可写
检查 OS 权限；moodledata 不要放在 htdocs 内（避免被下载）。
PHP 扩展缺失
安装页会列出缺失项；在 XAMPP 的 php.ini 中启用对应 extension= 后重启 Apache。
数据库连接失败
确认 MySQL 已启动；账号密码与 phpMyAdmin 中一致。
同类 LMS 还可参考 Chamilo。
小结
Moodle 本地主入口是 http://localhost/moodle；首次安装会用到 /moodle/install.php。准备好 PHP、数据库与独立的 moodledata 后即可完成向导。