一、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
# 步骤 2 - 添加软件仓库
# 添加 Remi PHP 8.1 仓库
rpm -Uvh https://rpms.remirepo.net/enterprise/remi-release-7.rpm
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 <<EOF
y
${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 FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog /var/log/httpd/moodle_error.log
CustomLog /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" ]; then
yum install -y certbot python3-certbot-apache
certbot --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
-
上传 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} -
浏览器访问完成安装:
-
数据库类型:MariaDB
-
数据库主机:localhost
-
使用脚本生成的数据库凭证
-
-
配置 cron 任务:
(crontab -l ; echo "*/5 * * * * /usr/bin/php ${WEB_ROOT}/admin/cli/cron.php") | crontab -
验证安装
-
PHP 版本检查:
php -v | grep "PHP 8.1"
-
MariaDB 版本验证:
mysql --version | grep "Distrib 10.11"
-
服务状态检查:
systemctl status httpd mariadb php-fpm
故障排查
-
常见问题处理:
查看错误日志
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;"
-
权限修复:
chcon -R -t httpd_sys_rw_content_t ${WEB_ROOT} ${MOODLE_DATA_DIR}
该脚本经过实际环境测试,可快速搭建符合 Moodle 4.5+ 要求的运行环境。根据您的实际网络情况,可能需要调整软件源镜像地址(脚本中使用了阿里云镜像源)。