Windows下XAMPP部署Moodle 5.1的目录结构与Apache配置问题

一、正确目录结构 #

Moodle 5.1强制要求Web服务仅访问public子目录，不能直接暴露核心根目录，本地XAMPP环境下的标准结构如下：

• 假设XAMPP网站根目录为C:\xampp\htdocs
• 将Moodle 5.1压缩包解压到C:\xampp\htdocs\moodle-core（此为Moodle核心根目录，包含public、lib、config.php等所有核心文件）
• 核心根目录下的public文件夹是Web服务的唯一入口，里面包含index.php、login等前端访问文件

二、Apache虚拟主机配置（推荐方案） #

通过虚拟主机让Web服务直接指向public目录，步骤如下：

1. 打开XAMPP控制面板，点击Apache的Config按钮，选择Apache (httpd.conf)
2. 找到#Include conf/extra/httpd-vhosts.conf，删除行首的#以启用虚拟主机配置，保存并关闭文件
3. 再次点击Apache的Config按钮，选择Apache (httpd-vhosts.conf)
4. 在文件末尾添加以下配置：

<VirtualHost *:80>
    ServerName moodle.local
    DocumentRoot "C:/xampp/htdocs/moodle-core/public"
    <Directory "C:/xampp/htdocs/moodle-core/public">
        Options Indexes FollowSymLinks Includes ExecCGI
        AllowOverride All
        Require all granted
    </Directory>
    ErrorLog "logs/moodle.local-error.log"
    CustomLog "logs/moodle.local-access.log" common
</VirtualHost>

5. 修改Windows hosts文件（路径C:\Windows\System32\drivers\etc\hosts），添加一行：

127.0.0.1   moodle.local

6. 重启Apache服务，之后通过http://moodle.local访问Moodle

三、临时测试方案（不推荐用于生产） #

若不想配置虚拟主机，可调整目录结构适配：

• 将Moodle核心根目录下的public文件夹复制到C:\xampp\htdocs\moodle
• 将核心根目录下的config.php、lib等所有非public文件/文件夹，移动到C:\xampp\htdocs\moodle-core（与moodle平级）
• 修改config.php中的根目录配置：$CFG->dirroot = 'C:/xampp/htdocs/moodle-core';

四、错误原因说明 #

• 第一个错误是因为你直接将Moodle核心根目录设为Web根目录，Moodle 5.1为了安全，强制要求仅暴露public目录，避免敏感核心文件被外部访问
• 第二个异常是第一个配置错误导致的连锁问题，当Web服务指向正确的public目录后，该异常会自动消失

内容的提问来源于stack exchange，提问作者Ayush Binjola