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
54747238
Commit
54747238
authored
Jul 02, 2014
by
AbrahamGreyson
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Guide-zh-cn/start-installation.md proofread.
parent
edc292bd
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
28 additions
and
43 deletions
+28
-43
start-installation.md
docs/guide-zh-CN/start-installation.md
+28
-43
No files found.
docs/guide-zh-CN/start-installation.md
View file @
54747238
安装 Yii
==============
你可以通过两种方式安装 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,你可以按
[
getcomposer.org
](
https://getcomposer.org/download/
)
中的方法安装。
在 Linux 和 Mac OS X 中,可以运行如下命令安装:
如果还没有安装 Composer,你可以按
[
getcomposer.org
](
https://getcomposer.org/download/
)
中的方法安装。在 Linux 和 Mac OS X 中可以运行如下命令:
curl -s http://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
在 Windows 中,你需要下载并运行
[
Composer-Setup.exe
](
https://getcomposer.org/Composer-Setup.exe
)
。
如果遇到
了任何问题或者想更深入地学习 Composer,请参考
[
Composer 文档(英文)
](
https://getcomposer.org/doc/
)
,
[
Composer 中文
](
https://github.com/5-say/composer-doc-cn
)
。
如果遇到
任何问题或者想更深入地学习 Composer,请参考
[
Composer 文档(英文)
](
https://getcomposer.org/doc/
)
,
[
Composer 中文
](
https://github.com/5-say/composer-doc-cn
)
。
Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下命令即可安装 Yii :
...
...
@@ -26,12 +24,11 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
如上命令会将 Yii 安装在一个名为
`basic`
的目录中。
> 技巧:如果你想安装 Yii 的最新开发版本,可以使用如下命令,它添加了一个
> [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability):
> 技巧:如果你想安装 Yii 的最新开发版本,可以使用如下命令,它添加了一个 [stability 选项](https://getcomposer.org/doc/04-schema.md#minimum-stability):
>
> composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
>
> 注意,Yii 的开发版不应该用于生产环境中,
因为它可能会破坏运行中的代码。.
> 注意,Yii 的开发版不应该用于生产环境中,
它可能会破坏运行中的代码。
通过归档文件安装 <a name="installing-from-archive-file"></a>
...
...
@@ -50,28 +47,24 @@ Composer 安装后,切换到一个可通过 Web 访问的目录,执行如下
但是还可以有其他的安装方式:
*
如果你只想安装核心框架,然后从头开始构建一个应用程序,可以参考
[
从头构建自定义模版
](
tutorial-start-from-scratch.md
)
一节的介绍。
*
如果你要开始一个更复杂的项目,更好的地适用于团队开发环境的,你可以考虑安装
[
高级应用模版
](
tutorial-advanced-app.md
)
.
*
如果你只想安装核心框架,然后从头开始创建一个应用程序,可以参考
[
从头构建自定义模版
](
tutorial-start-from-scratch.md
)
一节的介绍。
*
如果你要开发一个更复杂的应用,更好的地适用于团队开发环境的,可以考虑安装
[
高级应用模版
](
tutorial-advanced-app.md
)
。
验证
安装 <a name="verifying-installation"></a>
检查
安装 <a name="verifying-installation"></a>
--------------------------
安装完成后,就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用
程序
了:
安装完成后,就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用了:
```
http://localhost/basic/web/index.php
```
这个 URL 假设你将 Yii 安装到了一个位于 Web 服务器文档根目录下的
`basic`
目录中,且该 Web 服务器正运行在你自己的电脑上
(
`localhost`
)。你可能需要将其调整为自己的安装环境。
这个 URL 假设你将 Yii 安装到了一个位于 Web 服务器根目录下的
`basic`
目录中,且该 Web 服务器正运行在你自己的电脑上 (
`localhost`
)。你可能需要将其调整为适应自己的安装环境。
![
Yii 安装成功
](
images/start-app-installed.png
)
你应该可以在浏览器中看到如上所示的 "Congratulations!" 页面。如果没有,请检查你安装的 PHP 环境是否符合 Yii 的需求,
可以通过如下任意一种方式检查是否满足最小需求:
你应该可以在浏览器中看到如上所示的 “Congratulations!” 页面。如果没有,请检查你安装的 PHP 环境是否符合 Yii 的需求,可以通过如下任意一种方式检查是否满足最小需求:
*
通过浏览器访问 URL
`http://localhost/basic/requirements.php`
*
执行如下命令:
...
...
@@ -81,64 +74,56 @@ http://localhost/basic/web/index.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/en/pdo.installation.php) 和相应的数据库驱动(例如访问 MySQL 数据库所需的 `pdo_mysql`
)。
配置 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 的 `httpd.conf` 文件或在一个虚拟主机配置文件中使用如下配置。
注意,你应该将 `path/to/basic/web` 替换为实际的 `basic/web` 目录。
在 Apache 的 `httpd.conf` 文件或在一个虚拟主机配置文件中使用如下配置。注意,你应该将 `path/to/basic/web` 替换为实际的 `basic/web` 目录。
```
#
Set document root to be "basic/web"
#
设置文档根目录为 “basic/web”
DocumentRoot "path/to/basic/web"
<Directory
"
path
/
to
/
basic
/
web
"
>
RewriteEngine on
#
If a directory or a file exists, use the request directly
#
如果请求的是真实存在的文件或目录,直接访问
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
#
Otherwise forward the request to
index.php
#
如果请求的不是真实文件或目录,分发请求至
index.php
RewriteRule . index.php
# ...
other settings
...
# ...
其它设置
...
</Directory>
```
### 推荐使用的 Nginx 配置 <a name="recommended-nginx-configuration"></a>
为了使用 [Nginx](http://wiki.nginx.org/),你应该已经将 PHP 安装为 [FPM SAPI](http://php.net/install.fpm) 了。
使用如下 Nginx 配置,将 `path/to/basic/web` 替换为实际的 `basic/web` 目录, `mysite.local` 替换为实际的主机名以提供服务。
为了使用 [Nginx](http://wiki.nginx.org/),你应该已经将 PHP 安装为 [FPM SAPI](http://php.net/install.fpm) 了。使用如下 Nginx 配置,将 `path/to/basic/web` 替换为实际的 `basic/web` 目录,`mysite.local` 替换为实际的主机名以提供服务。
```
server {
charset utf-8;
client_max_body_size 128M;
listen 80; ##
listen for ipv4
#listen [::]:80 default_server ipv6only=on; ##
listen for ipv6
listen 80; ##
监听 ipv4 上的 80 端口
#listen [::]:80 default_server ipv6only=on; ##
监听 ipv6 上的 80 端口
server_name mysite.local;
root /path/to/basic/web;
...
...
@@ -148,11 +133,11 @@ server {
error_log /path/to/basic/log/error.log;
location / {
#
Redirect everything that isn't a real file to
index.php
#
如果找不到真实存在的文件,把请求重定向给
index.php
try_files $uri $uri/ /index.php?$args;
}
#
uncomment to avoid processing of calls to non-existing static files by Yii
#
给这段解除注释,能够避免 Yii 接管不存在文件的处理过程(404)
#location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
# try_files $uri =404;
#}
...
...
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