你可以通過兩種方式安裝 Yii:使用 Composer 或下載一個歸檔文件。推薦使用前者,這樣只需執行一條簡單的命令就可以安裝新的擴展或更新 Yii 了。
標準安裝完Yii之後,框架和一個項目模板兩者都下載並安裝好了。一個項目模板是實現了一些基本特性的一個 可行的Yii項目,比如登錄,聯繫表單,等等。它的代碼是以推薦的方式組織的。因此,它能夠適合作爲你項目的一個好的起點。
在本章節和以後的章節,我們將會介紹如何去安裝Yii和所謂的基本的應用程序模板和如何去實現這個模板上的新特性。Yii當然也提供了其它模板叫高級的應用程序模板,它是更好應用於在一個團隊開發環境中去開發多層級的應用程序。
信息: 這個基本的應用程序模板是適合於開發90%的Web應用程序。 它不同於高級的應用程序模板主要地在如何使它們的代碼是有組織的。 如果你是剛接觸Yii,我們強烈建議你堅持使用簡單並有足夠的功能的基礎的應用程序模板。
通過 Composer 安裝
如果還沒有安裝 Composer,你可以按 getcomposer.org 中的方法安裝。在 Linux 和 Mac OS X 中,你可以運行如下命令:
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
在 Windows 中,你需要下載並運行 Composer-Setup.exe。
如果遇到任何問題或者想更深入地學習 Composer,請參考 Composer 文檔(英文),Composer 中文。
如果你已經安裝有 Composer 請確保使用的是最新版本,你可以用 composer self-update
命令更新 Composer 爲最新版本。
Composer 安裝後,切換到一個可通過 Web 訪問的目錄,執行如下命令即可安裝 Yii :
composer global require "fxp/composer-asset-plugin:^1.2.0"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
第一條命令安裝
Composer asset plugin,它是通過 Composer 管理 bower 和 npm 包所必須的,此命令全局生效,一勞永逸。第二條命令會將 Yii 安裝在名爲
basic
的目錄中。如果你想使用其它目錄名稱,你可以選擇其他目錄名稱。
注意: 在安裝過程中 Composer 可能會詢問你 GitHub 賬戶的認證信息,因爲可能在使用中超過了 GitHub API (對匿名用戶的)使用限制。因爲 Composer 需要爲所有擴展包從 GitHub 中獲取大量信息,所以超限非常正常。(譯註:也意味着作爲程序猿沒有 GitHub 賬號,就真不能愉快地玩耍了)登陸 GitHub 之後可以得到更高的 API 限額,這樣 Composer 才能正常運行。更多細節請參考 Composer 文檔(該段 Composer中文文檔期待您的參與)。
提示: 如果你想安裝 Yii 的最新開發版本,可以使用以下命令代替,它添加了一個 stability 選項(中文版):
composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
注意,Yii 的開發版(dev 版)不應該用於生產環境中,它可能會破壞運行中的代碼。
通過歸檔文件安裝
通過歸檔文件安裝 Yii 包括三個步驟:
- 從 yiiframework.com 下載歸檔文件。
- 將下載的文件解壓縮到 Web 訪問的文件夾中。
-
修改
config/web.php
文件,給cookieValidationKey
配置項添加一個密鑰(若你通過 Composer 安裝,則此步驟會自動完成):// !!! 在下面插入一段密鑰(若爲空) - 以供 cookie validation 的需要 'cookieValidationKey' => '在此處輸入你的密鑰',
其他安裝方式
上文介紹了兩種安裝 Yii 的方法,安裝的同時也會創建一個立即可用的 Web 應用程序。這個方法對大多數的大或者小的項目是一個不錯的起點。如果你正好開始學習Yii,這是特別適合的。
但是其他的安裝方式也存在:
驗證安裝的結果
當安裝完成之後,或配置你的Web服務器(看下面的文章)或使用內置Web Server,當在項目
web
目錄下可以通過下面的命令:
php yii serve
注意: 默認情況下Https-server將監聽8080。可是如果這個端口已經使用或者你想通過這個方式運行多個應用程序,你可以指定使用哪些端口。只加上 --port 參數:
php yii serve --port=8888
安裝完成後,就可以使用瀏覽器通過如下 URL 訪問剛安裝完的 Yii 應用了:
http://localhost:8080/