Composer 安裝¶
你可以利用多種方式透過 Composer 安裝 CodeIgniter4 。
前兩種方式將說明如何以建立新專案為目標安裝 CodeIgniter4 ;第三種方式將告訴你如何把 CodeIgniter4 添加到現有的網頁應用程式之中。
備註
如果你是用 Git 進行專案管理並且與他人共同開發,那麼 git ignored 將會自動忽略 vendor
資料夾,你必須要在克隆你的儲存庫後執行 composer update
,將專案所依賴的程式庫下載至本地開發環境之中。
安裝穩定版本¶
Codeigniter4 appstarter 儲存庫 包含一個最簡應用程式, Composer 將依賴這個儲存庫的最新版本。
若你希望將 CodeIgniter4 使用在全新的產品開發專案中,你將適合這種安裝方式。
安裝與設定¶
在預計安裝專案的資料夾中下執行以下指令:
composer create-project codeigniter4/appstarter project-root
執行上述指令將會創建一個「 project-root 」 資料夾。
如果你省略了上述指令中「 project-root 」引數,那麼 Composer 將會自動生成出「 appstarter 」資料夾,你可以依照自己的需求命名你的資料夾。
若是你不需要安裝 phpunit 及其所有的 Composer 依賴,則必須在上述的指令中添加 -–no-dev
。執行了這個指令, Composer 將會安裝單純的框架檔案,以及我們預先同捆的三個所需的依賴程式庫。
下例將使用預設的專案資料夾名稱「 appstarter 」演示上述需求的安裝指令:
composer create-project codeigniter4/appstarter --no-dev
往後若需要升及框架,你只需要按照下一小節「如何升級框架」來進行升級。
如何升級框架¶
每當有新版本的 codeigniter4 發布時,請從專案的根目錄執行以下指令:
composer update
If you want to compare the latest framework source structure for non-system directory (app, public, etc), you can update with --prefer-source
:
composer update codeigniter4/framework --prefer-source
If --prefer-source
doesn’t automatically update to pull latest framework source structure, you can remove first:
rm -rf vendor/codeigniter4/framework && composer update codeigniter4/framework --prefer-source
如果你在創建專案時使用了 --no-dev
,那麼在升級框架時你也必須做一樣的事: composer update --no-dev
。
最後,你必須閱讀新版本的升級說明,並檢查 app/Config
資料夾中的文件是否因為升級有所改變。
優點¶
安裝簡單;容易更新。
缺點¶
在自動更新後,仍需檢查 app/Config
是否有因為升級而有所改變。
結構¶
在安裝 CodeIgniter 4 後,這些資料夾將會佈署進你的專案中:
- app, public, tests, writable
- vendor/codeigniter4/framework/system
- vendor/codeigniter4/framework/app & public (更新後可以利用這裡比較
app/Config
是否有所不同。)
安裝最新版本¶
穩定版本儲存庫附帶一個 builds
腳本,可以切換穩定版本框架與最新開發版本框架之間的 Composer 來源。對於願意接受最新且未發布的特性(可能不穩定)的開發人員,請使用這個腳本。
你可以閱讀 開發中的使用者說明書(原文),這與穩定發布版的使用者說明書不同,它將會明確地記載開發中的功能與使用說明。
在專案的根目錄中執行以下指令:
php builds development
執行這個命令後,將會更新 composer.json 把儲存庫指向 develop
分支 ,並且更新 config 和 XML 檔案中的對應路徑。若你需要還原這些改動,請執行:
php builds release
使用 builds
後請務必執行 composer update
,以便將你的 vendor 資料夾與目前希望執行的版本進行同步。
將 CodeIgniter4 佈署到現有專案中¶
與「手動安裝」 CodeIgniter 4 相同,你也可以透過 Composer 下載最新版本再自行佈署。
你可以在框架中的 app
資料夾開發你的應用程式,而 public
資料夾則是放置網站的公開檔案。
在你的專案根目錄執行以下指令:
composer require codeigniter4/framework
與前兩個 Composer 安裝方法相同,你可以透過「 –no-dev 」引數,省略安裝 phpunit 及其 Composer 依賴,
安裝¶
將 app 、 publuc 、 tests 以及 writable 資料夾從 vendor/codeigniter4/framework
複製到你的專案根目錄中。
並且,也將 env
、 phpunit.xml.dist
以及 spark
檔案,從 vendor/codeigniter4/framework
複製到你的專案根目錄中。
為了讓框架得以載入正確的 system 資料夾,你必須調整 app/Config/Paths.php
中 $systemDirectory 變數的路徑字串,指向 vendor/codeigniter/framework
的相對位置。
如何升級框架¶
每當有新版本的 codeigniter4 發布時,請從專案的根目錄執行以下指令:
composer update
如果你在創建專案時使用了「 –no-dev 」,那麼在升級框架時你也必須做一樣的事: composer update --no-dev
。
最後,你必須閱讀新版本的升級說明,並檢查 app/Config
資料夾中的文件是否因為升級有所改變。
優點¶
相對簡單的安裝;容易更新。
缺點¶
在自動更新後,仍需檢查 app/Config
是否有因為升級而有所改變。
結構¶
在執行完上述流程後,這些資料夾將會佈署進你的專案中:
- app, public, writable(當使用
--prefer-source
) - vendor/codeigniter4/framework/system