Skip to content
Projects
Groups
Snippets
Help
This project
Loading...
Sign in / Register
Toggle navigation
Y
yii2
Project
Overview
Details
Activity
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
PSDI Army
yii2
Commits
0f6304ff
Commit
0f6304ff
authored
Jul 20, 2014
by
东方孤思子(Paris·QianSen)
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
profreading [skip ci]
parent
def4cf3c
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
24 additions
and
18 deletions
+24
-18
start-installation.md
docs/guide-zh-CN/start-installation.md
+24
-18
No files found.
docs/guide-zh-CN/start-installation.md
View file @
0f6304ff
...
@@ -3,7 +3,7 @@
...
@@ -3,7 +3,7 @@
你可以通过两种方式安装 Yii:使用
[
Composer
](
http://getcomposer.org/
)
或下载一个归档文件。推荐使用前者,这样只需执行一条简单的命令就可以安装新的
[
扩展
](
extend-creating-extensions.md
)
或更新 Yii 了。
你可以通过两种方式安装 Yii:使用
[
Composer
](
http://getcomposer.org/
)
或下载一个归档文件。推荐使用前者,这样只需执行一条简单的命令就可以安装新的
[
扩展
](
extend-creating-extensions.md
)
或更新 Yii 了。
> 注意:和 Yii 1 不同,以标准方式安装 Yii 2 时会同时下载并安装框架本身和一个应用程序骨架。
> 注意:和 Yii 1 不同,以标准方式安装 Yii 2 时会同时下载并安装框架本身和一个应用程序
的基本
骨架。
通过 Composer 安装 <a name="installing-via-composer"></a>
通过 Composer 安装 <a name="installing-via-composer"></a>
...
@@ -22,13 +22,13 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
...
@@ -22,13 +22,13 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
composer create-project --prefer-dist yiisoft/yii2-app-basic basic
如上命令会将 Yii 安装在
一个
名为
`basic`
的目录中。
如上命令会将 Yii 安装在名为
`basic`
的目录中。
> 技巧:如果你想安装 Yii 的最新开发版本,可以使用如下命令,它添加了一个 [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability):
> 技巧:如果你想安装 Yii 的最新开发版本,可以使用如下命令,它添加了一个 [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability)
([中文版](https://github.com/5-say/composer-doc-cn/blob/master/cn-introduction/04-schema.md#minimum-stability))
:
>
>
> composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
> composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
>
>
> 注意,Yii 的开发版不应该用于生产环境中,它可能会破坏运行中的代码。
> 注意,Yii 的开发版
(dev 版)
不应该用于生产环境中,它可能会破坏运行中的代码。
通过归档文件安装 <a name="installing-from-archive-file"></a>
通过归档文件安装 <a name="installing-from-archive-file"></a>
...
@@ -38,20 +38,26 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
...
@@ -38,20 +38,26 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
1.
从
[
yiiframework.com
](
http://www.yiiframework.com/download/yii2-basic
)
下载归档文件。
1.
从
[
yiiframework.com
](
http://www.yiiframework.com/download/yii2-basic
)
下载归档文件。
2.
将下载的文件解压缩到 Web 目录中。
2.
将下载的文件解压缩到 Web 目录中。
3.
修改
`config/web.php`
文件,给
`cookieValidationKey`
配置项添加一个密钥(若你通过 Composer 安装,则此步骤会自动完成):
```
php
// !!! 在下面插入一段密钥(若为空) - 以供 cookie validation 的需要
'cookieValidationKey'
=>
'在此处输入你的密钥'
,
``
`
其他安装方式
<
a
name
=
"other-installation-options"
></
a
>
其他安装方式
<
a
name
=
"other-installation-options"
></
a
>
--------------------------
--------------------------
上文介绍了两种安装 Yii 的方法,安装的同时也会创建一个立即可用的 Web 应用程序。对于小的项目或
学习,这是一个很好
的起点。
上文介绍了两种安装
Yii
的方法
,
安装的同时也会创建一个立即可用的
Web
应用程序
。
对于小的项目或
用于学习上手
,
这都是一个不错
的起点
。
但是
还可以有其他的安装方式
:
但是
其他的安装方式也存在
:
*
如果你只想安装核心框架,然后从
头开始创建一个应用程序
,可以参考
[
从头构建自定义模版
](
tutorial-start-from-scratch.md
)
一节的介绍。
*
如果你只想安装核心框架
,
然后从
零开始构建整个属于你自己的应用程序模版
,
可以参考
[
从头构建自定义模版
](
tutorial
-
start
-
from
-
scratch
.
md
)
一节的介绍
。
*
如果你要开发一个更复杂的应用,
更好的
地适用于团队开发环境的,可以考虑安装
[
高级应用模版
](
tutorial-advanced-app.md
)
。
*
如果你要开发一个更复杂的应用
,
可以更好
地适用于团队开发环境的
,
可以考虑安装
[
高级应用模版
](
tutorial
-
advanced
-
app
.
md
)
。
检查安装
<a name="verifying-installation"></a>
验证安装的结果
<
a
name
=
"verifying-installation"
></
a
>
--------------------------
--------------------------
安装完成后
,
就可以使用浏览器通过如下
URL
访问刚安装完的
Yii
应用了
:
安装完成后
,
就可以使用浏览器通过如下
URL
访问刚安装完的
Yii
应用了
:
...
@@ -60,11 +66,11 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
...
@@ -60,11 +66,11 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
http://localhost/basic/web/index.php
http://localhost/basic/web/index.php
```
```
这个 URL 假设你将 Yii 安装到了一个位于 Web 文档根目录下的
`basic`
目录中,且该 Web 服务器正运行在你自己的电脑上
(
`localhost`
)。你可能需要将其调整为适应自己的安装环境。
这个 URL 假设你将 Yii 安装到了一个位于 Web 文档根目录下的 `basic` 目录中,且该 Web 服务器正运行在你自己的电脑上(`localhost`)。你可能需要将其调整为适应自己的安装环境。
![Yii 安装成功](images/start-app-installed.png)
![Yii 安装成功](images/start-app-installed.png)
你应该可以在浏览器中看到如上所示的 “Congratulations!” 页面。如果没有,请
检查你安装的 PHP 环境是否符合 Yii 的需求,可以通过如下任意一种方式检查是否满足最小
需求:
你应该可以在浏览器中看到如上所示的 “Congratulations!” 页面。如果没有,请
通过以下任意一种方式,检查当前 PHP 环境是否满足 Yii 最基本
需求:
* 通过浏览器访问 URL `http://localhost/basic/requirements.php`
* 通过浏览器访问 URL `http://localhost/basic/requirements.php`
* 执行如下命令:
* 执行如下命令:
...
@@ -74,21 +80,21 @@ http://localhost/basic/web/index.php
...
@@ -74,21 +80,21 @@ http://localhost/basic/web/index.php
php requirements.php
php requirements.php
```
```
你需要配置好 PHP 安装环境,使其符合 Yii 的最小需求。
最重要的是需要有 PHP 5.4 以上版本。如果应用需要用到数据库,那还要安装 [PDO PHP 扩展](http://www.php.net/manual/en
/pdo.installation.php) 和相应的数据库驱动(例如访问 MySQL 数据库所需的 `pdo_mysql`)。
你需要配置好 PHP 安装环境,使其符合 Yii 的最小需求。
主要是需要 PHP 5.4 以上版本。如果应用需要用到数据库,那还要安装 [PDO PHP 扩展](http://www.php.net/manual/zh
/pdo.installation.php) 和相应的数据库驱动(例如访问 MySQL 数据库所需的 `pdo_mysql`)。
配置 Web 服务器 <a name="configuring-web-servers"></a>
配置 Web 服务器 <a name="configuring-web-servers"></a>
-----------------------
-----------------------
>补充:如果你现在只是要试用 Yii 而不是
要将其部署到生产环境中的服务器上
,本小节可以跳过。
>补充:如果你现在只是要试用 Yii 而不是
将其部署到生产环境中
,本小节可以跳过。
通过上述方法安装的应用程序在 Windows,Max OS X,
Linux 中的 [Apache HTTP 服务器](http://httpd.apache.org/)或 [Nginx HTTP 服务器](http://nginx.org/) 上都可以直接运行。
通过上述方法安装的应用程序在 Windows,Max OS X,Linux 中的 [Apache HTTP 服务器](http://httpd.apache.org/)或 [Nginx HTTP 服务器](http://nginx.org/) 上都可以直接运行。
在生产环境的服务器上,你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是 `http://www.example.com/basic/web/index.php`。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。可能你还会想隐藏掉 URL 中的 `index.php`,具体细节在 [URL 解析和生成](runtime-url-handling.md) 一章中有介绍,你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
在生产环境的服务器上,你可能会想配置服务器让应用程序可以通过 URL `http://www.example.com/index.php` 访问而不是 `http://www.example.com/basic/web/index.php`。这种配置需要将 Web 服务器的文档根目录指向 `basic/web` 目录。可能你还会想隐藏掉 URL 中的 `index.php`,具体细节在 [URL 解析和生成](runtime-url-handling.md) 一章中有介绍,你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。
>补充:将 `basic/web` 设置为文档根目录,可以防止终端用户访问 `basic/web` 相邻目录中的私有应用
程序代码和敏感数据文件。禁止对其他目录的访问是一个切实可行
的安全改进。
>补充:将 `basic/web` 设置为文档根目录,可以防止终端用户访问 `basic/web` 相邻目录中的私有应用
代码和敏感数据文件。禁止对其他目录的访问是一个不错
的安全改进。
>补充:如果你的应用程序将来要运行在共享
的主机环境中,没有权限修改它的 Web 服务器配置,你依然可以调整应用程序的结构
提升安全性。详情请参考[共享主机环境](tutorial-shared-hosting.md) 一章。
>补充:如果你的应用程序将来要运行在共享
虚拟主机环境中,没有修改其 Web 服务器配置的权限,你依然可以通过调整应用的结构来
提升安全性。详情请参考[共享主机环境](tutorial-shared-hosting.md) 一章。
### 推荐使用的 Apache 配置 <a name="recommended-apache-configuration"></a>
### 推荐使用的 Apache 配置 <a name="recommended-apache-configuration"></a>
...
@@ -137,7 +143,7 @@ server {
...
@@ -137,7 +143,7 @@ server {
try_files $uri $uri/ /index.php?$args;
try_files $uri $uri/ /index.php?$args;
}
}
#
给这段解除注释,能够
避免 Yii 接管不存在文件的处理过程(404)
#
若取消下面这段的注释,可
避免 Yii 接管不存在文件的处理过程(404)
#location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
#location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
# try_files $uri =404;
# try_files $uri =404;
#}
#}
...
@@ -155,6 +161,6 @@ server {
...
@@ -155,6 +161,6 @@ server {
}
}
```
```
使用该配置时,你还应该在
`php.ini`
文件中设置
`cgi.fix_pathinfo=0`
以避免
很多不必要的
`stat()`
系统调用。
使用该配置时,你还应该在
`php.ini`
文件中设置
`cgi.fix_pathinfo=0`
,能避免掉
很多不必要的
`stat()`
系统调用。
还要注意当运行一个 HTTPS 服务器时,需要添加
`fastcgi_param HTTPS on;`
一行,这样 Yii 才能正确地判断连接是否安全。
还要注意当运行一个 HTTPS 服务器时,需要添加
`fastcgi_param HTTPS on;`
一行,这样 Yii 才能正确地判断连接是否安全。
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment