安装 Yii

    标准安装完Yii之后，框架和一个项目模板两者都下载并安装好了。
    一个项目模板是实现了一些基本特性的一个 可行的Yii项目，比如登录，联系表单，等等。
    它的代码是以推荐的方式组织的。因此，它能够适合作为你项目的一个好的起点。

    在本章节和以后的章节，我们将会介绍如何去安装Yii和所谓的基本的应用程序模板和如何去实现这个模板上的新特性。
    Yii当然也提供了其它模板叫
    高级的应用程序模板，
    它是更好应用于在一个团队开发环境中去开发多层级的应用程序。

    如果还没有安装 Composer，你可以按 中的方法安装。
    在 Linux 和 Mac OS X 中可以运行如下命令：

    在 Windows 中，你需要下载并运行 Composer-Setup.exe。

    如果遇到任何问题或者想更深入地学习 Composer，
    请参考 。
    如果你已经安装有 Composer 请确保使用的是最新版本，
    你可以用 命令更新 Composer 为最新版本。

    在本指南中，所有 composer 命令都假定您已经安装了全局 的 composer，
    这样它可以作为 composer 命令。如果您在本地目录中使用 composer.phar，
    则必须相应地调整示例命令。

    如果您之前已安装 Composer，请确保使用最新版本。
    您可以通过运行 composer self-update 来更新Composer。

    Note: 在安装 Yii 期间，Composer 需要从 Github API 请求很多信息。
    请求的数量取决于您的应用程序所依赖的数量，
    并可能大于 Github API 速率限制。如果达到此限制，Composer 可能会要求您提供 Github 登录凭据以获取
    Github API 访问令牌。在快速连接上，您可能比 Composer 能够处理的时间早，
    因此我们建议您在安装 Yii 之前配置访问令牌。
    有关如何执行此操作的说明，请参阅
    。

    安装 Composer 后，您可以通过在 Web 可访问的文件夹下运行以下命令来
    安装Yii应用程序模板：

    1. composer create-project --prefer-dist yiisoft/yii2-app-basic basic

    这将在一个名为 basic 的目录中安装Yii应用程序模板的最新稳定版本。
    如果需要，您可以选择不同的目录名称。

    " class="reference-link">通过归档文件安装

    通过归档文件安装 Yii 包括三个步骤：

    1. 从 下载归档文件。
    2. 将下载的文件解压缩到 Web 访问的文件夹中。

    3. 修改 config/web.php 文件，给 cookieValidationKey 配置项
      添加一个密钥（若你通过 Composer 安装，则此步骤会自动完成）：

    上文介绍了两种安装 Yii 的方法，
    安装的同时也会创建一个立即可用的 Web 应用程序。
    这个方法对大多数的大或者小的项目是一个不错的起点。如果你正好开始学习Yii，这是特别适合的。

    但是其他的安装方式也存在：

    • 如果你只想安装核心框架，然后从零开始构建整个属于你自己的应用程序模版，
      可以参考从头构建自定义模版一节的介绍。
    • 如果你要开发一个更复杂的应用，可以更好地适用于团队开发环境的，
      你可以考虑安装。

    " class="reference-link">安装 Assets

    Yii依靠 和/或 NPM 软件包来安装 asset（CSS 和 JavaScript）库。
    它使用Composer来获取这些库，允许 PHP 和 CSS/JavaScript 包版本同时解析。
    这可以通过使用 或 composer asset plugin 来实现。
    有关更多详细信息，请参阅 。

    您可能希望通过本地 Bower/NPM 客户端管理您的 assets，使用 CDN 或完全避免 assets 的安装。
    为了防止通过 Composer 安装 assets，请将以下几行添加到您的 ‘composer.json’ 中：

    1. "replace": {
    2.     "bower-asset/jquery": ">=1.11.0",
    3.     "bower-asset/inputmask": ">=3.2.0",
    4.     "bower-asset/punycode": ">=1.3.0",
    5.     "bower-asset/yii2-pjax": ">=2.0.0"
    6. },

    Note: 在通过 Composer 绕过 assets 安装的情况下，您负责 assets 的安装和解决版本冲突。
    准备来自不同扩展名的 assets 文件之间的可能不一致。

    当安装完成之后，
    或配置你的Web服务器(看下面的文章)或使用内置Web Server，
    当在项目 web 目录下可以通过下面的命令:

      安装完成后，就可以使用浏览器通过如下 URL 访问刚安装完的 Yii 应用了：

      1. http://localhost:8080/

      • 复制 /requirements.php 到 /web/requirements.php，然后通过浏览器访问 URL http://localhost/requirements.php

      • 执行如下命令：

        1. cd basic
        2. php requirements.php

      你需要配置好 PHP 安装环境，使其符合 Yii 的最小需求。主要是需要 PHP 5.4 或 以上版本。
      如果应用需要用到数据库，那还要安装
      和相应的数据库驱动（例如访问 MySQL 数据库所需的 pdo_mysql）。

      " class="reference-link">配置 Web 服务器

      Tip: 如果你现在只是要试用 Yii 而不是将其部署到生产环境中，
      本小节可以跳过。

      通过上述方法安装的应用程序在 Windows，Max OS X，
      Linux 中的
      或 Nginx HTTP 服务器且PHP版本为5.4或更高都可以直接运行。
      Yii 2.0 也兼容 Facebook 公司的 ，
      由于 HHVM 和标准 PHP 在边界案例上有些地方略有不同，在使用 HHVM 时需稍作处理。

      在生产环境的服务器上，你可能会想配置服务器让应用程序可以通过
      URL http://www.example.com/index.php 访问而不是 。
      这种配置需要将 Web 服务器的文档根目录(document root)指向 basic/web 目录。
      可能你还会想隐藏掉 URL 中的 index.php，具体细节在 URL 解析和生成一章中有介绍，
      你将学到如何配置 Apache 或 Nginx 服务器实现这些目标。

      在 Apache 的 httpd.conf 文件或在一个虚拟主机配置文件中使用如下配置。
      注意，你应该将 path/to/basic/web 替换为实际的 basic/web 目录。

      为了使用 ，你应该已经将 PHP 安装为 FPM SAPI 了。
      你可以使用如下 Nginx 配置，将 path/to/basic/web 替换为实际的 basic/web 目录，
      mysite.local 替换为实际的主机名以提供服务。

      1. server {
      2.     charset utf-8;
      3.     client_max_body_size 128M;
      5.     listen 80; ## listen for ipv4
      6.     #listen [::]:80 default_server ipv6only=on; ## listen for ipv6
      8.     server_name mysite.test;
      9.     root        /path/to/basic/web;
      10.     index       index.php;
      12.     access_log  /path/to/basic/log/access.log;
      13.     error_log   /path/to/basic/log/error.log;
      15.     location / {
      16.         # Redirect everything that isn't a real file to index.php
      17.         try_files $uri $uri/ /index.php$is_args$args;
      19.     # uncomment to avoid processing of calls to non-existing static files by Yii
      20.     #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
      21.     #    try_files $uri =404;
      22.     #}
      23.     #error_page 404 /404.html;
      25.     # deny accessing php files for the /assets directory
      26.     location ~ ^/assets/.*\.php$ {
      27.         deny all;
      28.     }
      30.     location ~ \.php$ {
      31.         include fastcgi_params;
      32.         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
      33.         fastcgi_pass 127.0.0.1:9000;
      34.         #fastcgi_pass unix:/var/run/php5-fpm.sock;
      35.         try_files $uri =404;
      36.     }
      38.     location ~* /\. {
      39.         deny all;
      40.     }
      41. }

      使用该配置时，你还应该在 php.ini 文件中设置 cgi.fix_pathinfo=0 ，
      能避免掉很多不必要的 stat() 系统调用。

      还要注意当运行一个 HTTPS 服务器时，需要添加 一行，
      这样 Yii 才能正确地判断连接是否安全。