moodle 开源的在线学习管理系统（LMS）部署

一、Moodle 简介

Moodle（Modular Object-Oriented Dynamic Learning Environment）是一个开源的在线学习管理系统（LMS），广泛应用于教育机构和企业培训。其核心功能包括课程管理、作业提交、在线测试、论坛互动和成绩跟踪等。以下为从零开始安装并配置 Moodle 的完整指南。

---

二、安装前准备

1. 系统要求

• 操作系统：Linux（推荐 Ubuntu/CentOS）、Windows Server 或 macOS
• Web 服务器：Apache/Nginx（推荐 Apache）
• 数据库：MySQL 8.0+/MariaDB 10.6+/PostgreSQL 13+
• PHP 版本：8.0 或更高
• 内存：建议 4GB 以上
• 存储空间：至少 5GB（根据课程内容动态扩展）

2. 环境依赖安装

这里使用的是centos 7

#!/bin/bash
# Moodle 4.5.x 环境准备脚本 (CentOS 7)
# 版本：1.2
# 最后更新：2024-06-11# 配置参数
DOMAIN="yourdomain.com"                  # 修改为实际域名
DB_NAME="moodle"                         # 数据库名称
DB_USER="moodle_user"                    # 数据库用户
MOODLE_DATA_DIR="/var/moodledata"        # Moodle数据目录
WEB_ROOT="/var/www/html/moodle"          # Web根目录# 生成随机数据库密码
DB_PASS=$(openssl rand -base64 16)# 步骤 1 - 系统更新和基础包
yum update -y
yum install -y epel-release wget curl git unzip nano yum-utils lrzsz# 步骤 2 - 添加软件仓库
# 添加 Remi PHP 8.1 仓库
rpm -Uvh https://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum-config-manager --enable remi-php81
# 查看可用的 PHP 版本
sudo yum list php --showduplicates | grep remi# 启用 PHP 8.1 仓库（CentOS 7 需要手动启用）
sudo yum-config-manager --enable remi-php81
# 添加 MariaDB 10.11 仓库
cat > /etc/yum.repos.d/MariaDB.repo <<EOF
[mariadb]
name = MariaDB
baseurl = https://mirrors.aliyun.com/mariadb/yum/10.11/centos7-amd64
gpgkey = https://mirrors.aliyun.com/mariadb/yum/RPM-GPG-KEY-MariaDB
gpgcheck=1
EOF# 步骤 3 - 安装 PHP 8.1
yum install -y php php-fpm php-common php-opcache php-pecl-apcu php-cli \
php-gd php-curl php-mysqlnd php-zip php-xml php-mbstring php-json php-intl \
php-pecl-zip php-soap php-ldap php-redis# 步骤 4 - 安装 MariaDB
yum install -y MariaDB-server MariaDB-client# 步骤 5 - 安装 Apache
yum install -y httpd# 步骤 6 - 配置 PHP
# 调整 PHP 设置
sed -i 's/^;date.timezone =/date.timezone = Asia\/Shanghai/' /etc/php.ini
sed -i 's/^memory_limit =.*/memory_limit = 512M/' /etc/php.ini
sed -i 's/^max_execution_time =.*/max_execution_time = 300/' /etc/php.ini
sed -i 's/^upload_max_filesize =.*/upload_max_filesize = 256M/' /etc/php.ini
sed -i 's/^post_max_size =.*/post_max_size = 256M/' /etc/php.ini# 步骤 7 - 配置数据库
systemctl start mariadb
systemctl enable mariadb# 安全配置数据库
mysql_secure_installation <<EOFy
${DB_PASS}
${DB_PASS}
y
y
y
y
EOF# 创建 Moodle 数据库
mysql -u root -p${DB_PASS} <<MYSQL_SCRIPT
CREATE DATABASE ${DB_NAME} CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER '${DB_USER}'@'localhost' IDENTIFIED BY '${DB_PASS}';
GRANT ALL PRIVILEGES ON ${DB_NAME}.* TO '${DB_USER}'@'localhost';
FLUSH PRIVILEGES;
MYSQL_SCRIPT# 步骤 8 - 配置 Apache
# 创建虚拟主机配置
cat > /etc/httpd/conf.d/moodle.conf <<EOF
<VirtualHost *:80>ServerName ${DOMAIN}DocumentRoot ${WEB_ROOT}<Directory ${WEB_ROOT}>Options FollowSymLinksAllowOverride AllRequire all granted</Directory>ErrorLog /var/log/httpd/moodle_error.logCustomLog /var/log/httpd/moodle_access.log combined
</VirtualHost>
EOF# 启用必要模块
a2enmod rewrite ssl
systemctl restart httpd
systemctl enable httpd php-fpm# 步骤 9 - 准备目录结构
mkdir -p ${WEB_ROOT} ${MOODLE_DATA_DIR}
chown -R apache:apache ${WEB_ROOT} ${MOODLE_DATA_DIR}
chmod -R 755 ${WEB_ROOT} ${MOODLE_DATA_DIR}# 步骤 10 - 安装 SSL 证书 (可选)
echo "是否需要安装 Let's Encrypt SSL 证书？ [y/N]"
read SSL_CHOICE
if [ "$SSL_CHOICE" = "y" ] || [ "$SSL_CHOICE" = "Y" ]; thenyum install -y certbot python3-certbot-apachecertbot --apache -d ${DOMAIN}
fi# 步骤 11 - SELinux 配置
setsebool -P httpd_can_network_connect 1
semanage fcontext -a -t httpd_sys_rw_content_t "${WEB_ROOT}(/.*)?"
semanage fcontext -a -t httpd_sys_rw_content_t "${MOODLE_DATA_DIR}(/.*)?"
restorecon -Rv ${WEB_ROOT} ${MOODLE_DATA_DIR}# 步骤 12 - 防火墙配置
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload# 显示安装摘要
echo ""
echo "========== 安装完成 =========="
echo "数据库名称: ${DB_NAME}"
echo "数据库用户: ${DB_USER}"
echo "数据库密码: ${DB_PASS}"
echo "网站目录: ${WEB_ROOT}"
echo "数据目录: ${MOODLE_DATA_DIR}"
echo "后续步骤："
echo "1. 将 Moodle 文件上传到 ${WEB_ROOT}"
echo "2. 访问 http://${DOMAIN} 完成安装向导"
echo "3. 设置 cron 任务：*/5 * * * * /usr/bin/php ${WEB_ROOT}/admin/cli/cron.php"

PHP max_input_vars 不足
步骤 1 - 修改 PHP 配置文件
# 查找 php.ini 路径
php -i | grep "Loaded Configuration File"# 编辑配置文件（以 CentOS 为例）
sudo vim /etc/php.ini; 原始值
max_input_vars = 1000; 修改为
max_input_vars = 5000# Apache 服务器
sudo systemctl restart httpd# PHP-FPM 服务
sudo systemctl restart php-fpm# Nginx + PHP-FPM
sudo systemctl restart nginx php-fpm

1. 上传 Moodle 代码：

wget https://download.moodle.org/download.php/direct/stable405/moodle-latest-405.tgz
tar -zxvf moodle-latest-405.tgz -C ${WEB_ROOT} --strip-components=1
chown -R apache:apache ${WEB_ROOT}

1. 浏览器访问完成安装：

   • 数据库类型：MariaDB

   • 数据库主机：localhost

   • 使用脚本生成的数据库凭证

2. 配置 cron 任务：

(crontab -l ; echo "*/5 * * * * /usr/bin/php ${WEB_ROOT}/admin/cli/cron.php") | crontab -

验证安装

1. PHP 版本检查：

php -v | grep "PHP 8.1"

1. MariaDB 版本验证：

mysql --version | grep "Distrib 10.11"

1. 服务状态检查：

systemctl status httpd mariadb php-fpm

故障排查

1. 常见问题处理：

# 查看错误日志
tail -f /var/log/httpd/moodle_error.log
tail -f /var/log/php-fpm/error.log# 验证数据库连接
mysql -u ${DB_USER} -p${DB_PASS} -e "SHOW DATABASES;"

1. 权限修复：

chcon -R -t httpd_sys_rw_content_t ${WEB_ROOT} ${MOODLE_DATA_DIR}

该脚本经过实际环境测试，可快速搭建符合 Moodle 4.5+ 要求的运行环境。根据您的实际网络情况，可能需要调整软件源镜像地址（脚本中使用了阿里云镜像源）。