查米洛 LMS
1.11.28
Camilo 是一個電子學習平台，也稱為“LMS”，在 GNU/GPLv3+ 許可證下發布。自2010年推出以來，全球已有超過3000萬人使用。對於目前的穩定分支，請在「代碼」標籤中選擇 1.11.x 分支。
Chamilo 2.0 仍在開發中。以下安裝過程僅供參考。要獲得穩定的 Chamilo，請安裝 Chamilo 1.11.x。有關詳細信息，請參閱 1.11.x 分支的 README.md。
我們假設您已經擁有：
作曲家 2.x - https://getcomposer.org/download/
紗線 +4.x - https://yarnpkg.com/getting-started/install
節點 >= v18+ (lts) - https://github.com/nodesource/distributions/blob/master/README.md
在網域中配置虛擬主機，而不是在網域內的子資料夾中。
運行 PHP 8.1+ 的 LAMP/WAMP 伺服器
您將需要 PHP8+ 和 NodeJS v18+ 來執行 Chamilo 2。
sudo apt update
sudo apt -y upgrade
sudo apt -y install ca-certificates curl gnupg software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install apache2 libapache2-mod-php8.1 mariadb-client mariadb-server php-pear php8.1-{dev,gd,curl,intl,mysql,mbstring,zip,xml,cli,apcu,bcmath,soap} git unzip如果您已經安裝了nodejs，請使用node -v檢查版本否則，安裝node 18或更高版本：
請按照此處的說明進行操作：https://deb.nodesource.com/node_20.x/。以下幾行使用這些指令的靜態版本，因此隨著時間的推移可能不太可持續
cd ~ curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg NODE_MAJOR=20 echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_$NODE_MAJOR.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list apt update && apt -y install nodejs
安裝 Nodejs 的其他選項是使用 NVM（節點版本管理器）。您可以按照此處的說明進行安裝。然後，您可以安裝所需的節點版本。最好是 LTS 版本。
sudo nvm install --lts sudo nvm use --lts
安裝 NodeJS 後，您必須啟用 corepack，然後繼續滿足要求
sudo corepack enable cd ~ # follow the instructions at https://getcomposer.org/download/ sudo mv composer.phar /usr/local/bin/composer # optionally, you might want this: sudo apt install libapache2-mod-xsendfile sudo a2enmod rewrite ssl headers expires sudo systemctl restart apache2
當您的系統全部設定完畢後，您可以使用以下命令：
cd /var/www git clone https://github.com/chamilo/chamilo-lms.git chamilo2 cd chamilo2 composer install # not recommended to do this as the root user! # when asked whether you want to execute the recipes or install plugins for some of the components, # you can safely type 'n' (for 'no'). yarn set version stable # delete yarn.lock as it might contain restrictive packages from a different context yarn up yarn install yarn dev # you can safely ignore any "warning" mentioned by yarn dev sudo touch .env sudo chown -R www-data: var/ .env config/
在您的 Web 伺服器設定中，確保允許解釋 .htaccess（ AllowOverride all和Require all granted ），並將DocumentRoot指向public/子目錄。
上述準備就緒後，輸入main/install/index.php並依照 UI 說明進行操作（資料庫、管理員使用者設定等）。
Web 安裝程序結束後，將權限變更回相當安全的狀態：
chown -R root .env config/
如果您已經安裝了它並且只想從 Git 更新它，請執行以下操作：
git pull composer install # Database update php bin/console doctrine:schema:update --force --complete # Clean Symfony cache php bin/console cache:clear # js/css update yarn install yarn dev
pre-alpha 階段的開發人員請注意：doctrine 指令將嘗試將您的資料庫架構更新為全新安裝中預期的資料庫架構。這並不總是完美的，因為 Doctrine 將採取最快的路線來做到這一點。例如，如果您有一個遷移來重新命名一個表（這適用於正在遷移的Chamilo 1 中的系統），Doctrine 可能會認為目標表不存在，而原始表（不應該存在於新的表中）安裝）仍然存在，因此它只會刪除舊表並建立新表，並在此過程中丟失該表中的所有記錄。為了避免這種情況，最好使用以下命令來執行遷移。
php bin/console doctrine:migrations:execute "ChamiloCoreBundleMigrationsSchemaV200Version[date]"
這將尊重遷移邏輯並進行所需的資料處理。
這將更新 public/build 資料夾中的 JS (yarn) 和 PHP (composer) 依賴項。
有時會與現有文件發生衝突，因此為了避免這些衝突，這裡有一些提示：
對於作曲家錯誤，您可以刪除供應商資料夾和composer.lock文件
對於紗線錯誤，您可以刪除yarn.lock .yarn/cache/* node_modules/*
打開Chamilo時，它不加載，那麼你可以刪除var/cache/*
如果您認為基於不完整的遷移或安裝 Chamilo 開發版本後新增的遷移，Chamilo 中的某些設定可能未正確處理，則建置 URL /admin/settings_sync 來嘗試透過更新自動修復該問題基於資料庫狀態的PHP 類。不過，這個問題很少發生。
如果您將其安裝在開發環境中並且感覺應該完全清理它（在更改資料庫後可能是必要的），您可以透過以下方式執行此操作：
刪除.env文件
再次載入 {url}/main/install/index.php 腳本
資料庫應該逐表自動銷毀。在某些極端情況下（以前的版本創建了一個不再需要的表並產生問題），您可能希望透過刪除它來徹底清理它，但這在大多數情況下不是必需的。
如果由於某種原因，您在使用composer或yarn時遇到問題，最好的第一步是完全刪除vendor/資料夾（對於composer）或node_modules/資料夾（對於yarn）。
如果您是開發人員並希望在當前開發分支（尚未穩定）中為 Chamilo 做出貢獻，請按照以下說明進行操作。請記住，開發版本目前尚未完成，許多功能尚未運行。這是因為我們正在開發根元件，需要對程式碼、檔案和資料庫的結構進行大量更改。因此，要獲得工作版本，您可能需要完全卸載並不時重新安裝。你已被警告過。
首先，應用此處描述的流程：在 Chamilo 中管理 CSS 和 JavaScript（特別是，請確保按照給定的連結在電腦上安裝所有必要的元件）。
然後確保您的資料庫支援大前綴（如果您使用 MySQL < 5.7 或 MariaDB < 10.2.2，請參閱此 Stack Overflow 執行緒）。
載入 (your-domain)/main/install/index.php URL 以啟動安裝程式（與先前版本中的安裝程式非常相似）。如果安裝程式是純 HTML 並且沒有以乾淨的佈局顯示，那是因為您沒有仔細遵循這些說明。返回本節的開頭並重試。
如果您想要對資產進行熱重載，請使用指令yarn run encore dev-server 。當您在assets/vue下修改資產時，這將自動刷新您的資產。照常存取您的 chamilo 實例。在後台，這將從 http://localhost:8080 上的自訂伺服器提供資產。不要直接存取此 url，因為 Encore 負責根據需要更改 url 資源。
您可能希望在同一台伺服器上同時支援 PHP 8.1（用於 Chamilo 2）和 PHP 7.4（用於所有其他內容）。在 Ubuntu 上，你可以這樣做：
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.1 libapache2-mod-php7.4 php8.1-{modules} php7.4-{modules}
sudo apt remove libapache2-mod-php8.1 php7.4-fpm
sudo a2enmod proxy_fcgi
sudo vim /etc/apache2/sites-available/[your-chamilo2-vhost].conf在虛擬主機配置中，請確保您將 PHP 8.1 FPM 設定為透過在
