From f5da8366baa474253241cdbd3784deb5bb007dba Mon Sep 17 00:00:00 2001 From: fangliang Date: Tue, 1 Sep 2015 20:39:36 +0800 Subject: [PATCH] init translate --- docs/guide-zh-CN/tutorial-shared-hosting.md | 103 ++++++++++++++++++++++++ docs/guide-zh-CN/tutorial-start-from-scratch.md | 55 +++++++++++++ docs/guide-zh-CN/tutorial-template-engines.md | 49 +++++++++++ 3 files changed, 207 insertions(+) create mode 100644 docs/guide-zh-CN/tutorial-shared-hosting.md create mode 100644 docs/guide-zh-CN/tutorial-start-from-scratch.md create mode 100644 docs/guide-zh-CN/tutorial-template-engines.md diff --git a/docs/guide-zh-CN/tutorial-shared-hosting.md b/docs/guide-zh-CN/tutorial-shared-hosting.md new file mode 100644 index 0000000..6aebf44 --- /dev/null +++ b/docs/guide-zh-CN/tutorial-shared-hosting.md @@ -0,0 +1,103 @@ +共享托管环境 +========================== + +共享的托管环境常常会对目录结构以及配置文件有较多的限制。然而，在大多数情况下，你仍可以通过少量的修改以在共享托管环境下运行 Yii 2.0。 + +部署一个基础应用模板 +--------------------------- + +由于共享托管环境往往只有一个 webroot，如果可能，请优先使用基础项目模板（ basic project template )构建你的应用程序。参考 [安装 Yii 章节](start-installation.md)在本地安装基础项目模板。当你让应用程序在本地正常运行后，我们将要做少量的修改以让它可以在共享托管服务器运行。 + +### 重命名 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](#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', + ], + ], +], +``` diff --git a/docs/guide-zh-CN/tutorial-start-from-scratch.md b/docs/guide-zh-CN/tutorial-start-from-scratch.md new file mode 100644 index 0000000..36ad3ba --- /dev/null +++ b/docs/guide-zh-CN/tutorial-start-from-scratch.md @@ -0,0 +1,55 @@ +Creating your own Application structure +======================================= + +> Note: This section is under development. + +While the [basic](https://github.com/yiisoft/yii2-app-basic) and [advanced](https://github.com/yiisoft/yii2-app-advanced) +project templates are great for most of your needs, you may want to create your own project template with which +to start your projects. + +Project templates in Yii are simply repositories containing a `composer.json` file, and registered as a Composer package. +Any repository can be identified as a Composer package, making it installable via `create-project` Composer command. + +Since it's a bit too much to start building your entire template from scratch, it is better to use one of the built-in +templates as a base. Let's use the basic template here. + +Clone the Basic Template +---------------------------------------- + +The first step is to clone the basic Yii template's Git repository: + +```bash +git clone git@github.com:yiisoft/yii2-app-basic.git +``` + +Then wait for the repository to be downloaded to your computer. Since the changes made to the template won't be pushed back, you can delete the `.git` diretory and all +of its contents from the download. + +Modify the Files +------------ + +Next, you'll want to modify the `composer.json` to reflect your template. Change the `name`, `description`, `keywords`, `homepage`, `license`, and `support` values +to describe your new template. Also adjust the `require`, `require-dev`, `suggest`, and other options to match your template's requirements. + +> Note: In the `composer.json` file, use the `writable` parameter under `extra` to specify +> per file permissions to be set after an application is created using the template. + +Next, actually modify the structure and contents of the application as you would like the default to be. Finally, update the README file to be applicable to your template. + +Make a Package +-------------- + +With the template defined, create a Git repository from it, and push your files there. If you're going to open source your template, [Github](http://github.com) is the best place to host it. If you intend to keep your template non-collaborative, any Git repository site will do. + +Next, you need to register your package for Composer's sake. For public templates, the package should be registered at [Packagist](https://packagist.org/). +For private templates, it is a bit more tricky to register the package. For instructions, see the [Composer documentation](https://getcomposer.org/doc/05-repositories.md#hosting-your-own). + +Use the Template +------ + +That's all that's required to create a new Yii project template. Now you can create projects using your template: + +``` +composer global require "fxp/composer-asset-plugin:~1.0.0" +composer create-project --prefer-dist --stability=dev mysoft/yii2-app-coolone new-project +``` diff --git a/docs/guide-zh-CN/tutorial-template-engines.md b/docs/guide-zh-CN/tutorial-template-engines.md new file mode 100644 index 0000000..56f8def --- /dev/null +++ b/docs/guide-zh-CN/tutorial-template-engines.md @@ -0,0 +1,49 @@ +Using template engines +====================== + +By default, Yii uses PHP as its template language, but you can configure Yii to support other rendering engines, such as +[Twig](http://twig.sensiolabs.org/) or [Smarty](http://www.smarty.net/) available as extensions. + +The `view` component is responsible for rendering views. You can add a custom template engine by reconfiguring this +component's behavior: + +```php +[ + 'components' => [ + 'view' => [ + 'class' => 'yii\web\View', + 'renderers' => [ + 'tpl' => [ + 'class' => 'yii\smarty\ViewRenderer', + //'cachePath' => '@runtime/Smarty/cache', + ], + 'twig' => [ + 'class' => 'yii\twig\ViewRenderer', + 'cachePath' => '@runtime/Twig/cache', + // Array of twig options: + 'options' => [ + 'auto_reload' => true, + ], + 'globals' => ['html' => '\yii\helpers\Html'], + 'uses' => ['yii\bootstrap'], + ], + // ... + ], + ], + ], +] +``` + +In the code above, both Smarty and Twig are configured to be useable by the view files. But in order to get these extensions into your project, you need to also modify +your `composer.json` file to include them, too: + +``` +"yiisoft/yii2-smarty": "*", +"yiisoft/yii2-twig": "*", +``` +That code would be added to the `require` section of `composer.json`. After making that change and saving the file, you can install the extensions by running `composer update --prefer-dist` in the command-line. + +For details about using concrete template engine please refer to its documentation: + +- [Twig guide](https://github.com/yiisoft/yii2-twig/tree/master/docs/guide) +- [Smarty guide](https://github.com/yiisoft/yii2-smarty/tree/master/docs/guide) \ No newline at end of file