Browse Source

Update tutorial-shared-hosting.md

tags/2.0.16
崔亮 6 years ago committed by GitHub
parent
commit
08487e92e4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
  1. 77
      docs/guide-zh-CN/tutorial-shared-hosting.md

77
docs/guide-zh-CN/tutorial-shared-hosting.md

@ -1,16 +1,20 @@
共享托管环境
==========================
共享的托管环境常常会对目录结构以及配置文件有较多的限制。然而,在大多数情况下,你仍可以通过少量的修改以在共享托管环境下运行 Yii 2.0。
共享的托管环境常常会对目录结构以及配置文件有较多的限制。
然而,在大多数情况下,你仍可以通过少量的修改以在共享托管环境下运行 Yii 2.0。
部署一个基础应用模板
---------------------------
由于共享托管环境往往只有一个 webroot,如果可能,请优先使用基础项目模板( basic project template )构建你的应用程序。参考 [安装 Yii 章节](start-installation.md)在本地安装基础项目模板。当你让应用程序在本地正常运行后,我们将要做少量的修改以让它可以在共享托管服务器运行。
由于共享托管环境往往只有一个 webroot,如果可能,请优先使用基础项目模板( basic project template )构建你的应用程序。
参考 [安装 Yii 章节](start-installation.md)在本地安装基础项目模板。
当你让应用程序在本地正常运行后,
我们将要做少量的修改以让它可以在共享托管服务器运行。
### 重命名 webroot <span id="renaming-webroot"></span>
用FTP或者其他的工具连接到你的托管服务器,你可能看到类似如下的目录结构:
FTP 或者其他的工具连接到你的托管服务器,你可能看到类似如下的目录结构:
```
config
@ -18,17 +22,21 @@ logs
www
```
在以上,`www` 是你的 web 服务器的 webroot 目录。不同的托管环境下名称可能各不相同,通常是类似: `www`, `htdocs`,`public_html` 之类的名称。
在以上,`www` 是你的 web 服务器的 webroot 目录。不同的托管环境下名称可能各不相同,通常是类似:`www`,`htdocs``public_html` 之类的名称。
对于我们的基础项目模板而言,其 webroot 名为 `web` 。 在你上传你的应用程序到 web 服务器上去之前,将你的本地 webroot 重命名以匹配服务器。 即: 从 `web` 改为 `www`, `public_html` 或者其他你的托管环境的 webroot 名称。
对于我们的基础项目模板而言,其 webroot 名为 `web`
在你上传你的应用程序到 web 服务器上去之前,将你的本地 webroot 重命名以匹配服务器。
即:从 `web` 改为 `www`,`public_html` 或者其他你的托管环境的 webroot 名称。
### FTP 根目录可写
如果你有 FTP 根目录的写权限,即,有 `config`, `logs``www` 的根目录,那么,如本地根目录相同的结构上传 `assets`, `commands` 等目录。
如果你有 FTP 根目录的写权限,
即,有 `config`,`logs` 和 `www` 的根目录,那么,如本地根目录相同的结构上传 `assets`,`commands` 等目录。
### 增加 web 服务器的额外配置 <span id="add-extras-for-webserver"></span>
如果你的 web 服务器是 Apache,你需要增加一个包含如下内容的 `.htaccess` 文件到你的 `web` 目录(或者 `public_html` 根据实际情况而定,是你的 `index.php` 文件所在的目录)。
如果你的 web 服务器是 Apache,你需要增加一个包含如下内容的 `.htaccess` 文件到你的 `web` 目录
(或者 `public_html` 根据实际情况而定,是你的 `index.php` 文件所在的目录)。
```
Options +FollowSymLinks
@ -44,61 +52,16 @@ RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . index.php
```
对于nginx而言,你不需要额外的配置文件。
对于 nginx 而言,你不需要额外的配置文件。
### 检查环境要求
为了运行 Yii ,你的 web 服务器必须匹配它的环境要求。最低的要求必须是 PHP 5.4。为了检查环境配置,将 `requirements.php` 从你的根目录拷贝到 webroot 目录,
为了运行 Yii,你的 web 服务器必须匹配它的环境要求。最低的要求必须是 PHP 5.4。
为了检查环境配置,将 `requirements.php` 从你的根目录拷贝到 webroot 目录,
并通过浏览器输入 URL `http://example.com/requirements.php` 运行它。最后,检查结束后别忘了删除这个文件哦!
部署一个高级应用程序模板
---------------------------------
部署一个高级应用程序到共享的托管环境比基础应用要麻烦的原因在于它包含有两个 webroot 目录,而共享的托管环境不支持两个。对于这种情况,我们需要调整目录结构。
### 将入口文件移动到同一个 webroot
首先我们需要一个 webroot 目录,如[重命名 webroot](#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`
```php
'components' => [
'request' => [
'csrfParam' => '_backendCSRF',
'csrfCookie' => [
'httpOnly' => true,
'path' => '/admin',
],
],
'user' => [
'identityCookie' => [
'name' => '_backendIdentity',
'path' => '/admin',
'httpOnly' => true,
],
],
'session' => [
'name' => 'BACKENDSESSID',
'cookieParams' => [
'path' => '/admin',
],
],
],
```
将高级应用程序部署到共享主机比基本应用程序有点棘手但可以实现。
请按照[高级项目模板文档](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/topic-shared-hosting.md)中的说明进行操作。

Loading…
Cancel
Save