1 Moodle的版本【versions】和分支【branches】

了解Moodle版本控制方案將有助于您使用我們的存儲(chǔ)庫(kù)【repositories】獲取代碼（例如升級(jí)）。在tracker.moodle.org中報(bào)告錯(cuò)誤時(shí)，了解正確的版本也非常有用。

2 主要【major】版本和次要【minor】版本

Moodle版本號(hào)由三個(gè)以點(diǎn)分隔的數(shù)字組成，例如1.9.11或2.0.2。前兩個(gè)數(shù)字，如1.9或2.0，代表主要版本【major version】。第三個(gè)數(shù)字區(qū)分了同一個(gè)主要版本中的次要版本【minor version】。發(fā)布新的主要版本時(shí)，次要版本設(shè)置為0。例如，Moodle 2.0.1是Moodle 2.0.0的第一次小更新。
通常，Moodle HQ團(tuán)隊(duì)維護(hù)Moodle的兩個(gè)最新主要版本（該規(guī)則的一個(gè)顯著例外是Moodle 1.9，它的支持時(shí)間更長(zhǎng)）。

3 版本【versions】和分支【branches】

Moodle開(kāi)發(fā)人員使用源代碼管理（SCM）系統(tǒng)“Git”來(lái)跟蹤代碼中的更改。與許多SCM一樣，Git中代碼的變化歷史通過(guò)所謂的分支來(lái)表示?？梢詫⒎种б暈樵创a更改的標(biāo)記序列。
Moodle的每個(gè)主要版本都有一個(gè)分支。所有Moodle 1.9版本都來(lái)自Moodle_19_STABLE分支，所有Moodle 2.0版本都來(lái)自Moodle_20_STABLE分支。還有一個(gè)名為master的主要開(kāi)發(fā)分支，負(fù)責(zé)保存下一個(gè)未來(lái)版本的更改。

4 發(fā)布版【releases】

自2.0版以來(lái)，Moodle計(jì)劃每六個(gè)月左右發(fā)布一次新的主要版本。
次要版本每?jī)蓚€(gè)月發(fā)布一次，包括修復(fù)的bug和安全問(wèn)題。
在兩次發(fā)布之間，Moodle HQ團(tuán)隊(duì)發(fā)布最新穩(wěn)定版本的修訂。這些修訂每周發(fā)布，通常在周四發(fā)布。稱為每周構(gòu)建。通過(guò)版本號(hào)中的小增量和類(lèi)似20200723這樣的構(gòu)建日期（發(fā)布每周構(gòu)建的日期，格式為YYYYMMDD）來(lái)識(shí)別。這些每周構(gòu)建的版本號(hào)有一個(gè)加號(hào)后綴，例如，3.9.1+ 表示基于次要發(fā)布版3.9.1的每周構(gòu)建。

4 源代碼成熟度級(jí)別【maturity levels】

在其生命周期中，Moodle代碼分支經(jīng)歷了幾個(gè)成熟度級(jí)別。
一開(kāi)始，分支被認(rèn)為處于alpha狀態(tài)。在此期間，新功能將添加到分支。API和數(shù)據(jù)庫(kù)結(jié)構(gòu)可能會(huì)根據(jù)需要更改。這些版本主要面向開(kāi)發(fā)人員，因?yàn)闆](méi)有任何保證（例如，該版本可能不能安裝或不能執(zhí)行升級(jí)）。
當(dāng)決定不向分支添加新功能（即所謂的功能凍結(jié)）時(shí)，就達(dá)到了beta成熟度級(jí)別。開(kāi)發(fā)人員專(zhuān)注于測(cè)試、修復(fù)bug和穩(wěn)定分支。
在一段時(shí)間的測(cè)試中，當(dāng)所有已知的關(guān)鍵和妨礙程序正常運(yùn)行的bug都已修復(fù)，并且沒(méi)有新的錯(cuò)誤報(bào)告時(shí)，可以發(fā)布分支的preview版本，或稱為“發(fā)布候選版本【release candidate】”。發(fā)布第一個(gè)候選版本（RC1）后，將達(dá)到候選版本成熟度級(jí)別。在此期間，可以發(fā)布多個(gè)RC版本，例如2.1RC1、2.1RC2、2.1RC3等。
最后，新的主要版本發(fā)布，分支達(dá)到穩(wěn)定的成熟度水平。從現(xiàn)在起，這個(gè)分支的數(shù)據(jù)庫(kù)結(jié)構(gòu)和API不會(huì)改變。將創(chuàng)建相應(yīng)的MOODLE_xx_STABLE，并根據(jù)它創(chuàng)建次要版本和每周構(gòu)建。

5 版本號(hào)

每個(gè)插件的versions.php文件可以指定插件工作所需的Moodle的最低版本。

$plugin->version = 2011080200;
$plugin->requires = 2011070101;

6 如何在moodle內(nèi)核【core】中增加版本號(hào)

在Moodle內(nèi)核【core】中，當(dāng)我們從主干【master】分支時(shí)，我們也會(huì)分支版本號(hào)。這意味著穩(wěn)定分支中的任何版本號(hào)都不應(yīng)高于主干【master】分支（或更高版本穩(wěn)定分支）上的版本號(hào)。
版本號(hào)結(jié)構(gòu)為YYYYMMDDRR.XX。
YYYYMMDD是創(chuàng)建分支的日期。如果在主干【master】上，沒(méi)有發(fā)生分支，則應(yīng)將其設(shè)置為當(dāng)前日期。否則（在非主干分支中）不應(yīng)更改（保持原樣，即創(chuàng)建分支時(shí)的日期）。
RR是發(fā)布遞增版本號(hào)。這是在一個(gè)分支上的代碼變化的增量計(jì)數(shù)器、或者在主干【master】的日期計(jì)數(shù)器。
XX是微增版本號(hào)。當(dāng)我們意識(shí)到在一個(gè)穩(wěn)定的分支上（在RR增量中）可能有超過(guò)99個(gè)升級(jí)步驟時(shí)，我們引入了“分?jǐn)?shù)增量”。它往往只在主版本號(hào)文件中使用。

6.1穩(wěn)定分支的規(guī)則

如果存在“微增量”（.XX）。開(kāi)發(fā)人員只應(yīng)增加“微增量” ‘XX’
集成團(tuán)隊(duì)保留使用“RR”在發(fā)布點(diǎn)之間進(jìn)行分支的權(quán)利。
如果“微增量”（.XX）不存在，請(qǐng)?jiān)黾覴R。

6.2主干分支規(guī)則

必須在當(dāng)前日期的基礎(chǔ)上遞增全部版本號(hào)。
因此，2013年2月6日，版本號(hào)設(shè)置為：2013020600.00

6.3我們?yōu)槭裁匆种О姹?/h3>

想象一下以下場(chǎng)景：
1）Moodle 2.4發(fā)布，mod_forum版本2012120300。
2）僅在master中，王二的更新會(huì)在升級(jí)步驟【upgrade step】中刪除一個(gè)數(shù)據(jù)庫(kù)字段，并將moodle版本設(shè)置為201301010
3）在2.4.1和master中，張三修復(fù)了權(quán)限定義中的一個(gè)問(wèn)題，并將兩個(gè)分支中的版本設(shè)置為2013010200。（注意：這里將導(dǎo)致錯(cuò)誤，我們錯(cuò)誤地更改了整個(gè)未來(lái)2.4.x版本的分支日期?。?br>4）Moodle 2.5發(fā)布，mod_forum版本2013060100
5）Moodle 2.5發(fā)布后，李四將她的Moodle從Moodle 2.4.1更新為2.5。
由于張三在第3）步中的把2.4.x版本改為2013010200，這導(dǎo)致著第2）步中王二的的升級(jí)步驟將永遠(yuǎn)無(wú)法運(yùn)行。

6.4我知道STABLE和master之間沒(méi)有變化，我可以將版本號(hào)設(shè)置為相同嗎？

不是核心插件，抱歉，不能設(shè)置為相同。有太多的開(kāi)發(fā)人員在使用同一個(gè)代碼，如果我們避免為core這樣做的話，它可以防止事故的發(fā)生。

當(dāng)你創(chuàng)建一個(gè)普通的moodle頁(yè)面并包含config.php時(shí)，默認(rèn)情況下，在php運(yùn)行大量moodle引導(dǎo)代碼后，將擁設(shè)置好一個(gè)名為$SESSION全局變量。這是一個(gè)安全的啟動(dòng)假設(shè)，但在編寫(xiě)更高性能的代碼時(shí)，最好盡可能減少或消除會(huì)話鎖。

1 調(diào)試會(huì)話鎖問(wèn)題

如果你發(fā)現(xiàn)訪問(wèn)某個(gè)頁(yè)面時(shí)特別慢，在對(duì)做了分析之后，發(fā)現(xiàn)正在等待一個(gè)鎖釋放，那么這可能是一件很容易修復(fù)的事情，可以提高你的整體性能。

$CFG->debugsessionlock=5；//以秒為單位的時(shí)間

當(dāng)一個(gè)會(huì)話被鎖定N秒以上時(shí)，將進(jìn)行一次調(diào)試調(diào)用，詳細(xì)說(shuō)明哪個(gè)頁(yè)面在正在鎖定。

2 會(huì)話解鎖【unlocking】

\core\session\manager::write_close()；

3 頁(yè)面中的只讀會(huì)話【read only session】

要使只讀會(huì)話起作用，必須啟用只讀會(huì)話，并且需要您的代碼來(lái)支持它。

如果你提前知道你永遠(yuǎn)不會(huì)改變會(huì)話，但你仍然需要能夠讀會(huì)話，那么你可以將你的頁(yè)面聲明為只讀會(huì)話。這意味著您的頁(yè)面永遠(yuǎn)不會(huì)在另一個(gè)http請(qǐng)求中阻止會(huì)話。

define('READ_ONLY_SESSION', true);

4 web服務(wù)中的只讀會(huì)話

在web服務(wù)中也是如此。聲明web服務(wù)時(shí)，可以指定它不需要會(huì)話鎖：

5 完全不用會(huì)話

如果您的代碼完全不需要訪問(wèn)$SESSION，那么可以聲明：

define('NO_MOODLE_COOKIES', true);

6 不需要配置

define('ABORT_AFTER_CONFIG', true);

一、主要改進(jìn)

• 導(dǎo)航【Navigation】

1 我的課程：從網(wǎng)站頂部的“我的課程”選項(xiàng)卡可以方便訪問(wèn)“我的課程”。沒(méi)有可用課程的時(shí)候，可以方便的在我的課程頁(yè)面創(chuàng)建一門(mén)新課程?？梢园盐业恼n程頁(yè)設(shè)置為缺省主頁(yè)。

2 儀表板【Dashboard】和時(shí)間線【Timeline】：通過(guò)儀表板頁(yè)面上的時(shí)間線版塊經(jīng)過(guò)改進(jìn)，在截止日期前保留目標(biāo)事件。

3 課程目錄索引【Course Index】：在課程頁(yè)面的左側(cè)可以顯示課程的目錄索引（教學(xué)資源和教學(xué)活動(dòng)）。

4 活動(dòng)完成【Activity Completion】跟蹤：課程目錄索引中顯示各條目的完成狀態(tài)。

• 課程編輯

1 編輯模式：切換編輯模式，并訪問(wèn)新的版塊【block】抽屜【drawer】以添加或查看版塊。

2 輕松添加內(nèi)容：只需一次單擊即可添加活動(dòng)【Activities】和資源【Resources】。

3 上下文導(dǎo)航【Contextual navigation】：課程和活動(dòng)的選項(xiàng)卡【Tab】菜單。

4 拖放操作移動(dòng)內(nèi)容：在課程索引區(qū)和中央內(nèi)容區(qū)可以拖放操作移動(dòng)內(nèi)容。

• 題庫(kù)改進(jìn)

1 題庫(kù)插件：顯示或隱藏注釋和用法。

2 改進(jìn)題目管理：另存為草稿或正式提交；與同事一起工作時(shí)，查看版本歷史記錄并使用自定義字段。

• 課程

1 Atto編輯器：提升可訪問(wèn)性【accessibility】。

2 及格才能完成：完成條件可以設(shè)置為成績(jī)及格。

3 新的活動(dòng)圖標(biāo)。

4 內(nèi)容更新：當(dāng)課程內(nèi)容有新增或修改時(shí)，通知學(xué)員。

5 作業(yè)的時(shí)間：指定作業(yè)時(shí)間，鼓勵(lì)學(xué)員在指定時(shí)間內(nèi)提交作業(yè)。

6 Big Blue Button：使用Big Blue Button的免費(fèi)試用版上直播課。

• 管理

1 網(wǎng)站管理預(yù)設(shè)【presets】：輕松為用戶提供高效率的、全套功能的預(yù)設(shè)配置。

2 報(bào)表構(gòu)建：建立自定義報(bào)表并向指定的用戶【users】、角色【roles】、群組【cohorts】分享。

3 用戶導(dǎo)覽【User Tours】：可以包括圖片。

4 登錄頁(yè)面：可以設(shè)置背景圖片。

5 支持LTI 1.3 Advantage。

6 強(qiáng)制性的站點(diǎn)支持郵箱。

二、升級(jí)要求

1 Moodle 3.6及以上版本

2 PHP 7.3.0及以上版本

3 推薦PHP擴(kuò)展sodium

4 推薦PHP擴(kuò)展exif

5 推薦PHP設(shè)置max_input_vars 設(shè)置為>= 5000

6 數(shù)據(jù)庫(kù)最低版本要求

  PostgreSQL       10

  MySQL             5.7

  MariaDB           10.2.29

  Microsoft SQL Server       2017

  Oracle Database       11.2

7 瀏覽器支持：Chrome、Firefox、Safari、Edge

   Moodle 4.0及以上版本不再支持Internet Explorer 11。

   Safari 7及以下版本與Moodle 4.0及以上版本存在已知的兼容性問(wèn)題。

8 移動(dòng)端瀏覽器支持：MobileSafari、Google Chrome

一、主要改進(jìn)

（一）學(xué)生活動(dòng)完成跟蹤【student activity completion】

1 改善學(xué)習(xí)體驗(yàn)：活動(dòng)日期和活動(dòng)完成條件可顯示在課程頁(yè)面上。

2 活動(dòng)日期和完成條件：活動(dòng)日期和活動(dòng)完成條件顯示在活動(dòng)頁(yè)面的頂部。

3 手工標(biāo)記為完成：學(xué)生可以在活動(dòng)頁(yè)面將活動(dòng)標(biāo)記為完成。

4 新的顯示設(shè)置：新的顯示設(shè)置允許教師在課程頁(yè)面上隱藏或顯示活動(dòng)日期和完成條件。

（二）可訪問(wèn)性工具包【Accessibility toolkit】

1 免費(fèi)的入門(mén)工具包：可訪問(wèn)性工具包（來(lái)自Brickfield教育實(shí)驗(yàn)室）鑒定課程中的可訪問(wèn)性問(wèn)題。

2 課程可訪問(wèn)性評(píng)估：對(duì)課程內(nèi)容進(jìn)行分析，以便教師能夠識(shí)別和修復(fù)可訪問(wèn)性錯(cuò)誤。

3 錯(cuò)誤熱圖【Heatmap】：熱圖提供了關(guān)注區(qū)域的彩色上下文視圖。

4 一系列報(bào)表和圖表：錯(cuò)誤可以以圖形形式查看，也可以作為帶有可下載報(bào)表的列表查看。

（三）H5P和內(nèi)容庫(kù)【content bank】

1 禁用選定的H5P內(nèi)容類(lèi)型：管理員可以從管理員設(shè)置中禁用選定的H5P內(nèi)容類(lèi)型。

2 將內(nèi)容標(biāo)記為不列示：教師可以通過(guò)將內(nèi)容庫(kù)標(biāo)記為不列示來(lái)隱藏內(nèi)容。

3 查看鏈接的內(nèi)容：內(nèi)容庫(kù)中新增一列顯示項(xiàng)目鏈接的次數(shù)。

4 刪除鏈接內(nèi)容時(shí)發(fā)出警報(bào)：當(dāng)鏈接內(nèi)容即將被刪除時(shí)，將顯示一條警報(bào)。

（四）測(cè)驗(yàn)【quiz】與題型【question types】

1 查看分?jǐn)?shù)修改和及格分?jǐn)?shù)：教師可以查看分?jǐn)?shù)修改，學(xué)生可以直接在測(cè)驗(yàn)頁(yè)面上查看及格分?jǐn)?shù)。

2 保留首選試題設(shè)置：教師下次創(chuàng)建試題時(shí)，將保留對(duì)題型默認(rèn)設(shè)置的更改。

3 論述題字?jǐn)?shù)限制：論述題可以指定最小和最大字?jǐn)?shù)限制。

4 反抄襲支持：如果安裝了抄襲檢查器，可用于論述題。

（五）徽章

1 更好的背包【backpack】管理：管理員可以為用戶設(shè)置背包【backpack】的排列順序。

2 兼容 Open Badges v 2.1：Moodle 3.11兼容Open Badges v 2.1，新的OAuth 2 Open Badges服務(wù)允許用戶連接到符合OB v 2.1標(biāo)準(zhǔn)的背包【backpack】，而無(wú)需在Moodle中輸入憑據(jù)。

（六）用戶檔案【User profile】字段

1 新的社交賬號(hào)字段【Social profile field】：新的社交賬號(hào)字段將替換用戶檔案中的硬編碼字段。

2 可在“顯示用戶身份”中選擇的自定義用戶檔案字段：可以在用戶策略>顯示用戶身份中選擇自定義用戶檔案字段，以便它們顯示在參與者列表中。

（七）其它新特性

1 控制音頻/視頻播放速率：學(xué)生可以控制音頻和視頻文件的播放速度。

2 改進(jìn)的活動(dòng)完成報(bào)表：活動(dòng)完成報(bào)表可以按活動(dòng)和活動(dòng)順序進(jìn)行篩選。

3 搜索語(yǔ)言包：安裝新語(yǔ)言包時(shí)，可以搜索語(yǔ)言列表。

4 新的PDF轉(zhuǎn)PNG轉(zhuǎn)換器：對(duì)于作業(yè)注釋?zhuān)梢圆捎靡粋€(gè)新的轉(zhuǎn)換器Poppler來(lái)代替Ghostscript。 5 課程單元鏈接版塊【Section links block】：標(biāo)題現(xiàn)在可以顯示在課程單元鏈接版塊中。

二、升級(jí)要求

1 Moodle 3.6及以上版本

2 PHP 7.3.0及以上版本

3 推薦PHP擴(kuò)展sodium

4 推薦PHP設(shè)置max_input_vars 設(shè)置為>= 5000

5 數(shù)據(jù)庫(kù)最低版本要求

  PostgreSQL       9.6

  MySQL             5.7

  MariaDB           10.2.29

  Microsoft SQL Server       2017

  Oracle Database       11.2

5 瀏覽器支持：Chrome、Firefox、Safari、Edge

   Moodle 3.10及以上版本不再支持Internet Explorer 11。

   Safari 7及以下版本與Moodle 3.10及以上版本存在已知的兼容性問(wèn)題。

6 移動(dòng)端瀏覽器支持：MobileSafari、Google Chrome

為了幫助您創(chuàng)建符合這些規(guī)范的數(shù)據(jù)表，建議您使用內(nèi)置的數(shù)據(jù)庫(kù)定義（XMLDB）編輯器。

1 每個(gè)表都必須有一個(gè)自動(dòng)遞增的id字段（INT10）作為主鍵。

2 包含每個(gè)模塊【module】實(shí)例【instances】的主表必須與模塊（例如小部件【widget】）具有相同的名稱，并且至少包含以下字段：

id -如上所述

course -模塊實(shí)例所屬課程的id

name -模塊實(shí)例的全名

3與包含“things”信息的模塊相關(guān)聯(lián)的其他表應(yīng)命名為widget_things（注意復(fù)數(shù)形式）。

4一般來(lái)說(shuō)，核心表的表名應(yīng)該使用一個(gè)非復(fù)數(shù)單詞，而兩個(gè)單詞的表名只能是最后一個(gè)單詞采用復(fù)數(shù)，例如course、course_categories。只有保留字【reserved words】例外，例如files。（由于歷史原因，目前有些表名不遵守這種規(guī)范，但這種情況后續(xù)會(huì)改變）

5 表名和列名應(yīng)避免在任何數(shù)據(jù)庫(kù)中使用的保留字【reserved words】。請(qǐng)?jiān)趧?chuàng)建之前檢查它們。表名最多可包含28個(gè)字符，列名最多可包含30個(gè)字符。

6 列名應(yīng)該始終是小寫(xiě)、簡(jiǎn)單和簡(jiǎn)短的，遵循與變量名相同的規(guī)則。

7 在可能的情況下，包含對(duì)另一個(gè)表（例如小部件【widget】）的id字段的引用的列應(yīng)該稱為widgetid。（請(qǐng)注意，此約定是新的，在一些舊表中沒(méi)有遵循）

8布爾字段應(yīng)實(shí)現(xiàn)為包含0或1的小整數(shù)字段（例如INT4），以便以后在必要時(shí)擴(kuò)展值。

9大多數(shù)表都應(yīng)該有一個(gè)timemodified字段（INT10），該字段用PHP的time() 函數(shù)獲得的當(dāng)前時(shí)間戳更新字段值。

10始終為每個(gè)字段定義一個(gè)默認(rèn)值（并使其合理）

11每個(gè)表名都應(yīng)該以數(shù)據(jù)庫(kù)前綴（$CFG->prefix）開(kāi)頭。在很多情況下，這會(huì)自動(dòng)為您解決。此外，在Postgres下，每個(gè)索引的名稱也必須以前綴開(kāi)頭。

12為了保證跨數(shù)據(jù)庫(kù)的兼容性，請(qǐng)遵循以下關(guān)于AS關(guān)鍵字使用的簡(jiǎn)單規(guī)則（當(dāng)然，只有在需要在sql語(yǔ)句中為表、字段指定別名的時(shí)候）：

• 不要對(duì)表的別名使用AS關(guān)鍵字。
• 不要在刪除語(yǔ)句中對(duì)表使用別名（Mysql不喜歡）。
• 對(duì)字段別名使用AS關(guān)鍵字。

13絕對(duì)不要?jiǎng)?chuàng)建唯一鍵【UNIQUE KEYs】約束。而是使用唯一索引【UNIQUE INDEXes.】。將來(lái)，如果官方?jīng)Q定向Moodle添加引用完整性，需要的話會(huì)使用唯一鍵【UNIQUE KEYs】，但現(xiàn)在不會(huì)。請(qǐng)注意，XMLDB編輯器允許您同時(shí)指定XMLDB-only UNIQUE和FOREIGN約束（有利于更好地定義XML），但只會(huì)在底層生成索引。

14僅當(dāng)字段將成為某些（XMLDB-only）外鍵的引用目標(biāo)的時(shí)候，才為這些字段定義XMLDB-only UNIQUE KEYs，否則，定義為簡(jiǎn)單的唯一索引【UNIQUE INDEXes】。

15與版塊【block】相關(guān)聯(lián)的表的名稱必須遵循如下約定：$CFG->prefix + “block_” + name_of_the_block + 其他內(nèi)容。例如，假設(shè)$CFG->prefix是’mdl_’，塊“rss_client”的所有表都必須以’mdl_block_rss_client’開(kāi)頭（可以在末尾添加更多單詞，例如’mdl_block_rss_client_anothertable’ 等等）。

16不要在穩(wěn)定的分支中更改數(shù)據(jù)庫(kù)。如果這樣做，那么當(dāng)用戶從一個(gè)穩(wěn)定版本升級(jí)到下一個(gè)穩(wěn)定版本時(shí)，將發(fā)生重復(fù)更改數(shù)據(jù)庫(kù)，這可能會(huì)導(dǎo)致嚴(yán)重錯(cuò)誤。

17在SQL查詢中引用整型變量時(shí)，不要將值括在引號(hào)中。例如，下面的語(yǔ)句是正確的

get_records_select( 'question', 'category=$catid' )

下面的語(yǔ)句是錯(cuò)誤的：

get_records_select('question', “category='$catid’” ）

它隱藏未定義$catid的bug。（如果加了引號(hào)，當(dāng)$catid沒(méi)有值時(shí)，sql語(yǔ)句也不會(huì)報(bào)錯(cuò)）

18在SQL查詢語(yǔ)句中，不要對(duì)變量的值使用雙引號(hào)（例如SELECT*FROM{user}WHERE username=“someuser” ）。雖然在MySQL中，這樣的SQL語(yǔ)句沒(méi)有問(wèn)題，但這不符合ANSI數(shù)據(jù)庫(kù)標(biāo)準(zhǔn)，比如Postgresql就會(huì)將雙引號(hào)的變量值視為系統(tǒng)標(biāo)識(shí)符（例如字段名）。

19 Moodle不支持?jǐn)?shù)據(jù)庫(kù)“視圖”【view】，不要使用視圖。如果數(shù)據(jù)庫(kù)存在視圖、不符合規(guī)范的表，在數(shù)據(jù)庫(kù)轉(zhuǎn)換、遷移、備份、恢復(fù)、升級(jí)等操作中，可能會(huì)出現(xiàn)錯(cuò)誤。

一、概述

（一）什么是學(xué)習(xí)分析？

學(xué)習(xí)分析是一種算法，用于根據(jù)歷史數(shù)據(jù)和當(dāng)前行為預(yù)測(cè)或檢測(cè)學(xué)習(xí)過(guò)程的未知信息。學(xué)習(xí)分析功能具有四性：

• 描述性【descriptive】（發(fā)生了什么？）
• 預(yù)測(cè)性【predictive】（接下來(lái)會(huì)發(fā)生什么？）
• 診斷性【diagnostic】（為什么會(huì)發(fā)生？）
• 對(duì)策性【prescriptive】（針對(duì)問(wèn)題的處方，以為了改進(jìn)后續(xù)的學(xué)習(xí)）

大多數(shù)商業(yè)解決方案只是描述性的。那些具有預(yù)測(cè)性或前瞻性的方案對(duì)學(xué)習(xí)做出了某些假設(shè)，但這些假設(shè)并不適用于所有人。

（二）分析【analytics】與報(bào)表【report】對(duì)比

Moodle（魔燈）提供了基于日志數(shù)據(jù)的各種內(nèi)置報(bào)表，但它們基本上是描述性的——它們告訴參與者發(fā)生了什么，但不告訴他們?yōu)槭裁?，它們不預(yù)測(cè)結(jié)果或建議參與者如何改善結(jié)果。日志條目雖然非常詳細(xì)，但其本身并不能描述學(xué)習(xí)過(guò)程。他們告訴我們“誰(shuí)”、“什么”和“何時(shí)”，但不告訴我們“為什么”或“情況如何”。為了形成一種參與模式，每個(gè)微觀行動(dòng)都需要更多的背景。
Moodle也有許多提供描述性分析的第三方插件。還有與第三方離站【off-site】報(bào)告解決方案的集成。同樣，它們主要提供描述性分析，依靠人類(lèi)的判斷來(lái)解釋報(bào)告并生成預(yù)測(cè)和對(duì)策【prescriptions】。
過(guò)去，學(xué)習(xí)分析系統(tǒng)通常試圖分析過(guò)去的活動(dòng)，以實(shí)時(shí)預(yù)測(cè)未來(lái)的活動(dòng)。通過(guò)Moodle Learning Analytics，我們更加雄心勃勃。我們相信，一個(gè)完整的學(xué)習(xí)分析解決方案不僅能幫助我們預(yù)測(cè)事件，還能讓幫助我們正向提升。

（三）特點(diǎn)

1 支持兩種類(lèi)型的模型：
? 基于機(jī)器學(xué)習(xí)【Machine-learning】的模型，包括預(yù)測(cè)模型【predictive models】
? 使用簡(jiǎn)單規(guī)則檢測(cè)關(guān)注情況的“靜態(tài)”模型【”Static” models to detect situations of concern using simple rules】

2 三種內(nèi)置模型：
? 有輟學(xué)風(fēng)險(xiǎn)的學(xué)生【Students at risk of dropping out】
? 即將舉行的活動(dòng)到期【Upcoming activities due】
? 沒(méi)有教學(xué)行為【No Teaching】

3 一套基于探究性團(tuán)體【Community of Inquiry】的學(xué)生參與度指標(biāo)【engagement indicators】。

4 內(nèi)置工具，用于根據(jù)站點(diǎn)數(shù)據(jù)評(píng)估模型

5 使用事件【events】進(jìn)行主動(dòng)通知【Proactive notifications】

6 建議的行動(dòng)【Actions】列表隨每個(gè)模型的洞察通知【Insight notifications】一起提供。例如，在“有輟學(xué)風(fēng)險(xiǎn)的學(xué)生”模型中，教師可以輕松地向該模型識(shí)別的學(xué)生發(fā)送消息，或者跳轉(zhuǎn)到該學(xué)生的活動(dòng)報(bào)表【Activity report】，以獲取有關(guān)課程中學(xué)生活動(dòng)的更多詳細(xì)信息。

7 提供API，為第三方Moodle插件構(gòu)建指標(biāo)和預(yù)測(cè)模型

8 機(jī)器學(xué)習(xí)后端插件類(lèi)型 – 支持PHP和Python，可以擴(kuò)展以實(shí)現(xiàn)其他機(jī)器學(xué)習(xí)后端

9 基于可重用的目標(biāo)【targets】、指標(biāo)【indicators】和其他組件【components】，該系統(tǒng)可以輕松地通過(guò)新的定制模型進(jìn)行擴(kuò)展。

（四）局限性

1 機(jī)器學(xué)習(xí)模型，比如有輟學(xué)風(fēng)險(xiǎn)的學(xué)生，必須在有數(shù)據(jù)的網(wǎng)站上接受訓(xùn)練。這些模型無(wú)法在訓(xùn)練完成之前在一個(gè)站點(diǎn)上進(jìn)行預(yù)測(cè)。

2 模型的設(shè)計(jì)和選擇必須與學(xué)校的教學(xué)目標(biāo)優(yōu)先級(jí)相匹配。

二、設(shè)置

Moodle的學(xué)習(xí)分析系統(tǒng)在使用前需要進(jìn)行一些初始配置。

三、使用學(xué)習(xí)分析功能

Moodle Learning Analytics API是一個(gè)開(kāi)放系統(tǒng)，可以成為各種模型的基礎(chǔ)。模型可以包含指標(biāo)【indicators】（也稱為預(yù)測(cè)器【predictors】）、目標(biāo)【targets】（我們?cè)噲D預(yù)測(cè)的結(jié)果）、洞察【insights】（預(yù)測(cè)本身）、通知【notifications】（洞察結(jié)果發(fā)送的消息）和行動(dòng)【actions】（提供給消息接收者，這些可以反過(guò)來(lái)成為指標(biāo)）。
默認(rèn)情況下，大多數(shù)學(xué)習(xí)分析模型都未啟用。應(yīng)在考慮模型所要支持的目標(biāo)后，根據(jù)目標(biāo)需要啟用相關(guān)模型。

四、管理模型

一旦模型被啟用和訓(xùn)練，就會(huì)產(chǎn)生洞察【insights】。還應(yīng)監(jiān)控模型的性能和準(zhǔn)確性。

性能【performance】是指允許Moodle（魔燈）使用一定數(shù)量的硬件支持盡可能多的用戶。
當(dāng)然，你總是可以購(gòu)買(mǎi)更大的服務(wù)器。可伸縮性【scalability】意味著，如果你購(gòu)買(mǎi)的服務(wù)器的功能是原來(lái)的兩倍，那么它可以處理兩倍的負(fù)載。

編寫(xiě)可擴(kuò)展和執(zhí)行的代碼

每個(gè)頁(yè)面應(yīng)該只使用固定數(shù)量的數(shù)據(jù)庫(kù)查詢

• 如果在循環(huán)中看到數(shù)據(jù)庫(kù)訪問(wèn)操作，一定要保持警惕。如果數(shù)據(jù)庫(kù)訪問(wèn)隱藏在函數(shù)中，有時(shí)很難發(fā)現(xiàn)這一點(diǎn)。
• 使用聯(lián)接【JOINs】和子查詢（get_records_sql、get_recordset_sql等）而不是循環(huán)執(zhí)行多個(gè)查詢。
• 或者找到一個(gè)Moodle API函數(shù)，盡可能高效地獲取您想要的數(shù)據(jù)。（例如，get_users_by_capability）。
• 了解如何編寫(xiě)適用于所有受支持?jǐn)?shù)據(jù)庫(kù)的SQL，參考官方的《數(shù)據(jù)庫(kù)指南》【Database guidelines】文檔。

限制每個(gè)頁(yè)面在生成時(shí)所需的內(nèi)存大小

• 大型報(bào)表應(yīng)該按固定大小的頁(yè)面進(jìn)行分頁(yè)。
• 當(dāng)您無(wú)法使用SQL在數(shù)據(jù)庫(kù)中完成所有業(yè)務(wù)操作時(shí)，處理來(lái)自數(shù)據(jù)庫(kù)的大量數(shù)據(jù)，應(yīng)該使用記錄集，并使用recordset_walk迭代器(moodle/lib/classes/dml/recordset_walk.php)，避免將所有結(jié)果加載到大型PHP數(shù)組中消耗內(nèi)存。

警惕外部調(diào)用【external call】

與數(shù)據(jù)庫(kù)查詢一樣，還有其他操作比只執(zhí)行PHP代碼慢得多。例如：

• 運(yùn)行shell腳本；
• 進(jìn)行web服務(wù)調(diào)用；
• 處理文件（程度較輕）。

無(wú)論何時(shí)做這些事情，都要注意性能問(wèn)題。

限制會(huì)話鎖【session locks】的范圍

如果您不需要會(huì)話鎖，或者只需要在頁(yè)面的一部分使用它，請(qǐng)解鎖會(huì)話。

如何提高代碼的性能

在開(kāi)發(fā)過(guò)程中評(píng)估性能

• 啟用顯示性能信息【Performance info】（包括數(shù)據(jù)庫(kù)查詢操作計(jì)數(shù)）。管理員登錄后，在 網(wǎng)站管理->開(kāi)發(fā)->調(diào)試 中勾選perfdebug配置項(xiàng)。勾選性能信息設(shè)置項(xiàng)，將在標(biāo)準(zhǔn)主題【theme】（以及其他一些主題）的頁(yè)腳中顯示如下性能信息：頁(yè)面加載時(shí)間、用于生成頁(yè)面的內(nèi)存量、cpu使用率、負(fù)載、記錄緩存的命中/未命中率。如果需要對(duì)數(shù)據(jù)庫(kù)查詢操作計(jì)數(shù)，還需要在config.php中加入如下代碼：

// Capture performance profiling data 
define('MDL_PERF', true);
// Capture additional data from DB
define('MDL_PERFDB', true);
// Print to log (error_log(),for passive profiling of production servers)
define('MDL_PERFTOLOG', true);
// Print to footer (works with the default theme)
define('MDL_PERFTOFOOT', true);

小技巧：如果希望只對(duì)站點(diǎn)管理員顯示性能信息，可以在適當(dāng)?shù)奈恢茫ū热绮季猪?yè)面的頂部），加入如下代碼：

if (is_siteadmin()) {
    $CFG->perfdebug = 8;
}

• 使用JMeter（https://jmeter.apache.org/）等工具對(duì)新代碼做壓力測(cè)試。
• 使用https://github.com/moodlehq/moodle-performance-comparison （moodle 2.5及以上版本）比較Moodle的性能。您還可以使用測(cè)試站點(diǎn)生成器【Test site generator】或測(cè)試課程生成器【Test course generator】（Moodle 2.5及以上版本）。

在運(yùn)行中評(píng)估性能

如果你使用postgres，有一個(gè)腳本可以解析日志并輸出最慢的10個(gè)數(shù)據(jù)庫(kù)查詢，隨時(shí)可以插入cronjob并每天給你發(fā)電子郵件。腳本可以在這里找到：

http://git.catalyst.net.nz/gw?p=pgtools.git;a=blob_plain;f=scripts/pg-log-process.pl;hb=refs/heads/pg-log-process-multidb

需要對(duì)postgres進(jìn)行一些配置，使其以正確的格式記錄內(nèi)容。

MySQL數(shù)據(jù)庫(kù)有?個(gè)配置選項(xiàng)可以幫助我們及時(shí)捕獲慢SQL語(yǔ)句：

# 開(kāi)啟日志記錄慢查詢
slow_query_log = ON
# 閾值，記錄執(zhí)行時(shí)間超過(guò)2秒的慢查詢
long_query_time = 2
# 指定日志文件
slow_query_log_file = path/to/log/file/slowquery.log
# 記錄不使用索引查詢，即使查詢效率不慢
log_queries_not_using_indexes = ON
# 記錄數(shù)據(jù)庫(kù)管理SQL中慢sql
log-slow-admin-statements = ON

Moodle（魔燈）網(wǎng)站能支持多大負(fù)荷

從統(tǒng)計(jì)數(shù)據(jù)來(lái)看，目前世界上最大的Moodle（魔燈）站點(diǎn)

• 多達(dá)100萬(wàn)用戶
• 多達(dá)5萬(wàn)門(mén)課程
• 每門(mén)課程多達(dá)5000名用戶
• 多達(dá)50個(gè)角色
• 多達(dá)100個(gè)課程類(lèi)別，嵌套深度約為10級(jí)。
• 課程中多達(dá)XXX項(xiàng)活動(dòng)。
• 更多內(nèi)容。。。

在規(guī)劃和測(cè)試代碼時(shí)，這些是您應(yīng)該考慮的數(shù)字。然而，不要認(rèn)為Moodle（魔燈）網(wǎng)站永遠(yuǎn)不會(huì)比這更大。
即使不能在開(kāi)發(fā)服務(wù)器上測(cè)試這么大的站點(diǎn)，也應(yīng)該使用生成器腳本，這樣就可以在一個(gè)不小的Moodle（魔燈）站點(diǎn)上測(cè)試代碼。

一、主要改進(jìn)

（一）通用

1 下載課程內(nèi)容：點(diǎn)擊“下載課程內(nèi)容”按鈕可以下載課程內(nèi)容（如果被允許的話）。

2 選擇你的徽章背包【backpack】：發(fā)生徽章【badge】到你選擇的徽章背包。

3 測(cè)試時(shí)的滾動(dòng)計(jì)時(shí)器：使用新的測(cè)驗(yàn)滾動(dòng)計(jì)時(shí)器，輕松查看剩余時(shí)間。

4 文件夾【folder】顯示：文件夾資源【folder resourse】中的圖像和HTML文件可以直接在瀏覽器中查看，而無(wú)需下載。

（二）對(duì)教師

1 內(nèi)容庫(kù)【content bank】改進(jìn)：可以下載和（或）替換內(nèi)容庫(kù)中的H5P文件。

2 下載課程內(nèi)容：可以設(shè)置是否允許學(xué)生下載課程內(nèi)容。

3 付費(fèi)課程：提供付費(fèi)課程功能，支持多種付費(fèi)方式。

4 測(cè)驗(yàn)完成：可以基于試答的次數(shù)設(shè)置完成條件。

（三）對(duì)管理員

1 下載課程內(nèi)容：可以設(shè)置是否啟用允許學(xué)生下載課程內(nèi)容的功能。

2 定制H5P風(fēng)格：在主題中定制H5P風(fēng)格。

3 支付網(wǎng)關(guān)：設(shè)置由于付費(fèi)課程的支付網(wǎng)關(guān)。

4 語(yǔ)言定制：導(dǎo)入、導(dǎo)出定制的語(yǔ)言字符串。

5 更好的任務(wù)管理：新的“任務(wù)運(yùn)行”屏幕顯示當(dāng)前正在執(zhí)行的任務(wù)。

6 LTI改進(jìn)：LTI改進(jìn)包括動(dòng)態(tài)注冊(cè)和內(nèi)容的多項(xiàng)選擇。

二、升級(jí)要求

1 Moodle 3.5及以上版本

2 PHP 7.2.0及以上版本

3 需要PHP擴(kuò)展mbstring

4 數(shù)據(jù)庫(kù)最低版本要求

  PostgreSQL       9.6

  MySQL             5.7

  MariaDB           10.2.29

  Microsoft SQL Server       2012

  Oracle Database       11.2

5 瀏覽器支持：Chrome、Firefox、Safari、Edge

   Moodle 3.10不再支持Internet Explorer 11。

   Safari 7及以下版本與Moodle 3.10存在已知的兼容性問(wèn)題。

6 移動(dòng)端瀏覽器支持：MobileSafari、Google Chrome

一、您需要給您的學(xué)生開(kāi)設(shè)在線課程（spoc），開(kāi)展線上教學(xué)，甚至混合課程教學(xué)實(shí)踐。

• 您希望通過(guò)試用找到適合自己的產(chǎn)品；
• 暫時(shí)只有少量課程需要上線，希望有免費(fèi)使用的機(jī)會(huì)。

二、您是moodle（魔燈）的使用者。

• 希望能將moodle（魔燈）平穩(wěn)升級(jí)到符合國(guó)內(nèi)教學(xué)需求和使用習(xí)慣的在線課程平臺(tái)（spoc），并使已有的課程、數(shù)據(jù)、定制插件功能得以保留；
• 有明確的功能改進(jìn)需求，需要二次開(kāi)發(fā)；
• 需要外包運(yùn)維、支持、課件（特別是互動(dòng)課件）開(kāi)發(fā)服務(wù)。

三、您需要給學(xué)生開(kāi)展實(shí)訓(xùn)教學(xué)。

• 您需要建設(shè)專(zhuān)業(yè)實(shí)訓(xùn)室（會(huì)展、物流、老年服務(wù)與管理專(zhuān)業(yè)），希望獲得實(shí)訓(xùn)室建設(shè)方案以供參考；
• 您需要開(kāi)發(fā)線上模擬實(shí)訓(xùn)項(xiàng)目，特別是能嵌入到線上課程平臺(tái)的實(shí)訓(xùn)項(xiàng)目。

我們的聯(lián)系方式：

• 電話：0571-85134926
• 郵箱：support@cnee.com.cn
• Q Q：100720903

一、主要改進(jìn)

（一）通用

1 集成H5P。

2 課程參與人【Participants】篩選【filter】：有助于更有效的搜索和篩選課程參與人。

3 圖書(shū)【Book】導(dǎo)航：對(duì)圖書(shū)內(nèi)容提供更清晰的導(dǎo)航，避免以前版本的混亂。

4 可訪問(wèn)性【Accessibility】：改進(jìn)Atto編輯器。

5可一鍵快速移動(dòng)到屏幕頂部。

6 可批量刪除私人文件。

（二）對(duì)教師

1 H5P內(nèi)容庫(kù)：在一個(gè)新的內(nèi)容庫(kù)保存、上傳、創(chuàng)建和配置H5P。

2 H5P報(bào)表：?jiǎn)⒂脤?duì)成績(jī)、學(xué)習(xí)實(shí)踐過(guò)程【attempt】的跟蹤。

3 活動(dòng)選擇器：在改進(jìn)的“活動(dòng)選擇器”中輕松定位、查看標(biāo)星項(xiàng)目、查看推薦項(xiàng)目。

4 安全考試瀏覽器：正式集成安全考試瀏覽器【Safe Exam Browser】，可在quiz中配置SEB以滿足考試要求。

5 課程頁(yè)面，提供一個(gè)“打開(kāi)編輯功能”按鈕。

6 活動(dòng)完成：移動(dòng)活動(dòng)時(shí)，無(wú)需擔(dān)心會(huì)丟失基于“上一個(gè)”設(shè)置一個(gè)新的完成條件的活動(dòng)完成設(shè)置。

7 從新的網(wǎng)站moodle.net搜索和導(dǎo)入內(nèi)容。

（三）對(duì)管理員

1 H5P設(shè)置：集成H5P功能的設(shè)置。

2 安全考試瀏覽器設(shè)置：正式集成安全考試瀏覽器【Safe Exam Browser】

3 推薦活動(dòng)設(shè)置。

4 活動(dòng)選擇器【Activities Chooser】：設(shè)置在活動(dòng)選擇器彈框中顯示哪些選項(xiàng)卡【Tabs】。

5 許可證：從新的管理設(shè)置中添加新許可證。

6 用戶導(dǎo)覽：在啟用用戶導(dǎo)覽時(shí)指定訪問(wèn)日期。

7 課程復(fù)制：利用新MUA-funded功能快速?gòu)?fù)制課程。

8 集成新的moodle.net。

9 徽章：集成新的背包支持Open Badge 2.1。

10 讓你的用戶通過(guò)你網(wǎng)站上的反饋鏈接幫助我們改進(jìn)Moodle。

二、升級(jí)要求

1 Moodle 3.5及以上版本

2 PHP 7.2.0及以上版本

3 需要PHP擴(kuò)展mbstring

4 數(shù)據(jù)庫(kù)最低版本要求

  PostgreSQL       9.5

  MySQL             5.6

  MariaDB           10.2.29

  Microsoft SQL Server       2012

  Oracle Database       11.2

5 瀏覽器支持：Chrome、Firefox、Safari、Edge、Internet Explorer

   Moodle 3.9.x（LTS）將是最后一個(gè)支持Internet Explorer 11的版本。Moodle 3.10將不支持Internet Explorer 11。

   Safari 7及以下版本、Internet explorer 10及以下版本與Moodle 3.9存在已知的兼容性問(wèn)題。

6 移動(dòng)端瀏覽器支持：MobileSafari、Google Chrome