# 共享托管環境 共享的托管環境常常會對目錄結構以及配置文件有較多的限制。然而，在大多數情況下，你仍可以通過少量的修改以在共享托管環境下運行 Yii 2.0。 ## 部署一個基礎應用模板 由于共享托管環境往往只有一個 webroot，如果可能，請優先使用基礎項目模板（ basic project template )構建你的應用程序。參考?[安裝 Yii 章節](http://www.yiichina.com/doc/guide/2.0/start-installation)在本地安裝基礎項目模板。當你讓應用程序在本地正常運行后，我們將要做少量的修改以讓它可以在共享托管服務器運行。 ### 重命名 webroot 用FTP或者其他的工具連接到你的托管服務器，你可能看到類似如下的目錄結構： ~~~ config logs www ~~~ 在以上，`www`?是你的 web 服務器的 webroot 目錄。不同的托管環境下名稱可能各不相同，通常是類似：?`www`,?`htdocs`, 和`public_html`?之類的名稱。 對于我們的基礎項目模板而言，其 webroot 名為?`web`?。 在你上傳你的應用程序到 web 服務器上去之前，將你的本地 webroot 重命名以匹配服務器。 即： 從?`web`?改為?`www`,?`public_html`?或者其他你的托管環境的 webroot 名稱。 ### FTP 根目錄可寫 如果你有 FTP 根目錄的寫權限，即，有?`config`,?`logs`?和?`www`?的根目錄，那么，如本地根目錄相同的結構上傳?`assets`,`commands`?等目錄。 ### 增加 web 服務器的額外配置 如果你的 web 服務器是 Apache，你需要增加一個包含如下內容的?`.htaccess`?文件到你的?`web`?目錄(或者?`public_html`?根據實際情況而定，是你的?`index.php`?文件所在的目錄)。 ~~~ Options +FollowSymLinks IndexIgnore */* RewriteEngine on # if a directory or a file exists, use it directly RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d # otherwise forward it to index.php RewriteRule . index.php ~~~ 對于nginx而言，你不需要額外的配置文件。 ### 檢查環境要求 為了運行 Yii ，你的 web 服務器必須匹配它的環境要求。最低的要求必須是 PHP 5.4。為了檢查環境配置，將?`requirements.php`?從你的根目錄拷貝到 webroot 目錄，并通過瀏覽器輸入 URL?`http://example.com/requirements.php`?運行它。最后，檢查結束后別忘了刪除這個文件哦！ ## 部署一個高級應用程序模板 部署一個高級應用程序到共享的托管環境比基礎應用要麻煩的原因在于它包含有兩個 webroot 目錄，而共享的托管環境不支持兩個。對于這種情況，我們需要調整目錄結構。 ### 將入口文件移動到同一個 webroot 首先我們需要一個 webroot 目錄，如[重命名 webroot](http://www.yiichina.com/doc/guide/2.0/tutorial-shared-hosting#renaming-webroot)一節所述，創建一個新的跟你的托管環境 webroot 同名的目錄，如類似?`www`?或者`public_html`?的名字。創建如下的目錄結構，其中?`www`?目錄指代你剛剛創建的 webroot 目錄。 ~~~ www admin backend common console environments frontend ... ~~~ `www`?目錄是我們的前臺目錄，所以將?`frontend/web`?里面的內容移到這個目錄。 將?`backend/web`?里面的內容移到?`www/admin`?目錄。對于每種情況下，你需要調整｀index.php`?和?`index-test.php` 里面引用的目錄結構。 ### 分離 Session 和 Cookie 通常情況下，backend 和 frontend 運行在不同的域下，當我們將其都移到同一個域時， frontend 和 backend 將會共享相同的 cookie，這樣會造成沖突。為了修復這個問題，如下調整 backend 的應用程序配置文件?`backend/config/main.php`： ~~~ 'components' => [ 'request' => [ 'csrfParam' => '_backendCSRF', 'csrfCookie' => [ 'httpOnly' => true, 'path' => '/admin', ], ], 'user' => [ 'identityCookie' => [ 'name' => '_backendIdentity', 'path' => '/admin', 'httpOnly' => true, ], ], 'session' => [ 'name' => 'BACKENDSESSID', 'cookieParams' => [ 'path' => '/admin', ], ], ], ~~~