mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-26 03:30:32 +08:00
Merge pull request #7 from AbrahamGreyson/master
Guide-zh-cn/start-installation.md proofread.
This commit is contained in:
Yang Liu
@@ -1,24 +1,22 @@
|
||||
安装 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`）。你可能需要将其调整为适应自己的安装环境。
|
||||
|
||||
|
||||
|
||||
你应该可以在浏览器中看到如上所示的 "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;
|
||||
#}
|
||||
|
||||
Reference in New Issue
Block a user