通過Composer安裝?

可以通過多種方式在你的系統中來使用Composer安裝CodeIgniter。

前兩種方法描述了使用CodeIgniter4來創建一個項目的骨架結構,從而讓你可以在一個新的webapp中作為基礎來使用。 而第三種技術,如下所述,使得你可以將CodeIgniter4加入進一個現存的webapp中。

注意: 如果你正使用一個Git倉庫來存儲代碼或與他人寫作,那么 vendor 目錄就需要添加到gitignore文件中。在這種情況下,當你克隆倉庫到新系統中,就需要執行 composer update 指令

啟動應用?

CodeIgniter 4 應用啟動 倉庫里通過composer依賴最新版本的框架來維護了一個基礎骨架的應用。

以下安裝教程適用于每一位希望啟動一個新的基于CodeIgniter4的項目的開發者。

安裝和設置?

在你的項目根目錄執行以下命令:

composer create-project codeigniter4/appstarter project-root

該指令將會創建一個 “project-root” 目錄。

如果你忽略了”project-root”參數,該命令就會創建一個”appstarter”目錄,該目錄當需要時可以被重命名。

如果你不需要或不想安裝PHPUnit以及跟它相關的任何Composer依賴,請在該命令的尾部增加”–no-dev”選項。 這一操作將只會使用Composer安裝框架本體以及三個我們打包過的可信賴的外部依賴包。

下面是一個這樣的安裝指令的示例,使用默認的項目根目錄”APPstarter”:

composer create-project codeigniter4/appstarter --no-dev

安裝完成后你應該根據 “升級” 這節里的步驟繼續進行。

升級?

每當有新的發布時,在你項目的根目錄運行以下指令:

composer update

如果在你創建項目時使用了”–no-dev”選項,那么在這里也一樣適合這樣做。composer update --no-dev

閱讀升級指南,并檢查指定的 app/Config 目錄是否有內容變更。

優點?

便于安裝,便于升級。

缺點?

你仍需要在更新后檢查 app/Config 的變更。

結構?

設置完成后你的項目中會有以下目錄:

  • app, public, tests, writable
  • vendor/codeigniter4/framework/system
  • vendor/codeigniter4/framework/app & public (compare with yours after updating)

最新的開發版本?

App Start倉庫里有著 builds 腳本,在框架當前穩定發布版本和最新的開發版本間進行選擇。 對于開發者而言,可以選擇使用該腳本來獲取最新的變更,不過這些變更可能是不穩定的。

開發者用戶手冊 可以在線訪問。請注意與當前發布版本的用戶手冊 有所不同,并獨立維護一個開發的分支。

在你的項目根目錄執行以下指令:

php builds development

以上的指令將會更新 composer.json 文件并將當前的工作倉庫指向 develop 分支,并在配置和XML文件中更新對應的路徑。 如果要回退以上變更,請執行:

php builds release

在使用完 builds 命令后,請確保運行 composer update 來將你的vendor目錄與最新版本的同步。

將CodeIgniter4添加到現存項目中?

在”手動安裝”這章中描述過的 CodeIgniter 4 framework 倉庫同樣也可使用Composer來被添加到現存的項目中。

app 目錄下開發你的應用,public 目錄作為文檔的根目錄。

在你的項目根目錄下:

composer require codeigniter4/framework

與前面兩個composer安裝方式類似,你也可以在”composer require”命令中使用”–no-dev”參數來忽略安裝PHPunit。

設置?

vendor/codeigniter4/framework 中復制app, public, tests 和 writable目錄到你的項目根目錄下。

vendor/codeigniter4/framework 中復制 env, phpunit.xml.dist and spark 文件到你的項目根目錄下。

你需要設置指向 vendor/codeigniter/framework 的目錄 —— 通過修改 app/Config/Paths.php 中的 $systemDirectory 變量

升級?

每當有新的發布時,在你項目的根目錄運行以下指令:

composer update

如果在你創建項目時使用了”–no-dev”選項,那么在這里也一樣適合這樣做。composer update --no-dev

閱讀升級指南,并檢查指定的 app/Config 目錄是否有內容變更。

專業人士?

相當簡單的安裝方式;便于升級

貢獻者?

你仍需要在更新后檢查 app/Config 的變更。

結構?

設置完成后你的項目結構如下:

  • app, public, tests, writable
  • vendor/codeigniter4/framework/system

安裝翻譯?

如果你想充分利用系統信息的翻譯,可以類似地把這些翻譯加入到項目中。

在項目根目錄運行以下指令:

composer require codeigniter4/translations @rc

當你每次運行 composer update 時這些翻譯文件也同樣會被更新。