Merge pull request #6214 from davidsonalencar/docs-guide-pt-BR-start-installation

docs/guide-pt-BR/start-installation.md

@@ -3,11 +3,11 @@ Instalando o Yii
 
 Você pode instalar o Yii de duas maneiras, usando o [Composer](http://getcomposer.org/)
 ou baixando um arquivo compactado. O primeiro modo é o preferido, já que permite
-que você instale novas [extensões](extend-creating-extensions.md) ou atualize o
+que você instale novas [extensões](structure-extensions.md) ou atualize o
 Yii simplesmente executando um único comando.
 
 > Note: Ao contrário do Yii 1, as instalações padrão do Yii 2 resultam em
-  tanto o framework quanto um esqueleto de aplicação sendo baixados e instalados.
+tanto o framework quanto um esqueleto de aplicação sendo baixados e instalados.
 
 
 Instalando via Composer <a name="installing-via-composer"></a>
@@ -25,15 +25,30 @@ No Windows, você baixará e executará o [Composer-Setup.exe](https://getcompos
 Por favor consulte a [Documentação do Composer](https://getcomposer.org/doc/) se
 você encontrar quaisquer problemas ou se quiser aprender mais sobre o uso do Composer.
 
+Se você já estiver com o Composer instalado, certifique-se de usar uma versão atualizada. 
+Você pode atualizar o Composer executando o comando `composer self-update`.
+
 Com o Composer instalado, você pode instalar o Yii executando o seguinte comando
 em um diretório acessível pela Web:
 
+    composer global require "fxp/composer-asset-plugin:1.0.0-beta3"
     composer create-project --prefer-dist yiisoft/yii2-app-basic basic
 
-O comando acima instala o Yii em um diretório chamado `basic`.
+O primeiro comando instaka o [composer asset plugin](https://github.com/francoispluchino/composer-asset-plugin/)
+o que permite gerenciar dependências via bower e npm package por meio do Composer.
+Você apenas precisa rodar este comando uma vez. O segundo comando instala o Yii
+em um diretório chamado `basic`. Você pode escolher um diretório diferente se quiser.
+
+> Nota: Durante a instalação do Yii pode acontecer que o Composer peça suas 
+> credenciais de login do Github por ultrapassar taxa limite (rate-limit) da API do Github.
+> Isso é normal pois o Composer necessita obter muitas informações de todos os 
+> pacotes no Github.
+> Logando no Github incrementa a taxa limite (rate-limit) da API para que o Composer
+> possa continuar o seu trabalho. Para mais detalhes, por favor consulte a 
+> [documentação do Composer](https://getcomposer.org/doc/articles/troubleshooting.md#api-rate-limit-and-oauth-tokens).
 
 > Tip: Se você quiser instalar a última versão de desenvolvimento do Yii, você
-> pode usar o seguinte comando, que adiciona uma [opção stability](https://getcomposer.org/doc/04-schema.md#minimum-stability):
+> pode usar o seguinte comando, que adiciona uma [opção de estabilidade](https://getcomposer.org/doc/04-schema.md#minimum-stability):
 >
 >     composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
 >
@@ -44,23 +59,31 @@ O comando acima instala o Yii em um diretório chamado `basic`.
 Instalando a partir de um Arquivo Compactado <a name="installing-from-archive-file"></a>
 --------------------------------------------
 
-A instalação do Yii a partir de um arquivo compactado envolve dois passos:
+A instalação do Yii a partir de um arquivo compactado envolve três passos:
 
-1. Baixe o arquivo compactado em [yiiframework.com](http://www.yiiframework.com/download/yii2-basic).
+1. Baixe o arquivo compactado em [yiiframework.com](http://www.yiiframework.com/download/).
 2. Descompacte o arquivo baixado em um diretório acessível pela Web.
+3. Modifique o arquivo `config/web.php` informando uma chave secreta no item de 
+configuração `cookieValidationKey` (isto é feito automaticamente se você instalar
+o Yii pelo Composer):
+
+    ```php
+   // !!! Informe a chave secreta no item a seguir (se estiver vazio) - isto é requerido para a validação do cookie
+   'cookieValidationKey' => 'enter your secret key here',
+   ```
 
 
 Outras Opções de Instalação <a name="other-installation-options"></a>
 ---------------------------
 
 As instruções de instalação acima mostram como instalar o Yii, que também cria
-uma aplicação Web básica que funciona fora da caixa. Este método é um ponto de
-início para projetos pequenos, ou para quando você acaba de começar a aprender
-o Yii.
+uma aplicação Web básica que funciona imediatamente sem qualquer configuração ou 
+modificação (*out of the box*). Este método é um bom ponto de início para projetos 
+pequenos ou para quando você começar a aprender o Yii.
 
 No entanto, existem outras opções de instalação disponíveis:
 
-* Se você só quer instalar o core do framework e gostaria de construir uma aplicação
+* Se você só quer instalar o *core* do framework e gostaria de construir uma aplicação
   inteira do zero, você pode seguir as instruções conforme explicadas em
   [Construindo uma Aplicação a Partir do Zero](tutorial-start-from-scratch.md).
 * Se você quiser começar com uma aplicação mais sofisticada, mais adequada ao
@@ -78,14 +101,14 @@ instalada através da seguinte URL:
 http://localhost/basic/web/index.php
 ```
 
-Essa URL presume que você tenha instalad o Yii em um diretório chamado de `basic`,
+Essa URL presume que você tenha instalado o Yii em um diretório chamado de `basic`,
 diretamente no diretório raiz do servidor Web, e que o servidor Web está rodando
 em sua máquina local (`localhost`). Você pode precisar ajustá-la ao seu ambiente
 de instalação.
 
 ![Instalação do Yii com Sucesso](images/start-app-installed.png)
 
-Você deve ver a página de "Congratulations!" acima em seu navegador. Se não vê-la,
+Você deve ver acima a página de "Congratulations!" em seu navegador. Se não vê-la,
 por favor verifique se a sua instalação do PHP satisfaz os requisitos do Yii. Você
 pode verificar se os requisitos mínimos são atendidos através de um dos seguintes modos:
 
@@ -100,35 +123,38 @@ pode verificar se os requisitos mínimos são atendidos através de um dos segui
 Você deve configurar a sua instalação do PHP de modo que ela atenda aos requisitos
 mínimos do Yii. Mais importante ainda, você deve ter o PHP 5.4 ou superior. Você
 também deve instalar a [Extensão PDO do PHP](http://www.php.net/manual/en/pdo.installation.php) 
-e o driver de banco de dados correspondente (tal como `pdo_mysql` para bancos de
-dados MySQL), se a sua aplicação precisa de um banco de dados.
+e o driver do banco de dados correspondente (tal como `pdo_mysql` para bancos de
+dados MySQL), se a sua aplicação precisar de um banco de dados.
 
 
 Configurando os Servidores Web <a name="configuring-web-servers"></a>
 ------------------------------
 
-> Info: Você pode pular essa sub-seção se só estiver fazendo um test drive do Yii
+> Informação: Você pode pular essa subseção se só estiver fazendo um test drive do Yii
   sem a intenção de publicá-lo em um servidor de produção.
 
-A aplicação instalada de acordo com as instruções acima deve funcionar fora da caixa
-com um [Servidor HTTP Apache](http://httpd.apache.org/) oum um [Servidor HTTP Nginx](http://nginx.org/),
-no Windows, Mac OS X ou Linux.
+A aplicação instalada de acordo com as instruções acima deve funcionar imediatamente 
+com um [Servidor HTTP Apache](http://httpd.apache.org/) ou um [Servidor HTTP Nginx](http://nginx.org/),
+no Windows, Mac OS X ou Linux usando PHP 5.4 ou superior. O Yii 2.0 também é compatível
+com o [HHVM](http://hhvm.com/) do Facebook, no entanto, existem alguns casos extremos
+que o HHVM se comporta diferente no PHP nativo, então, terá que tomar um cuidado 
+extra quando usar o HHVM.
 
 Em um servidor de produção, você pode querer configurar o seu servidor Web de
 modo que a aplicação possa ser acessada pela URL `http://www.example.com/index.php`
 ao invés de `http://www.example.com/basic/web/index.php`. Tal configuração requer que
 você aponte a raiz dos documentos de seu servidor Web para o diretório `basic/web`.
 Você também pode querer ocultar o `index.php` da URL, conforme descrito na seção
-[Análise e Geração de URLs](runtime-url-handling.md). Nesta sub-seção, você
+[Roteamento e Criação de URL](runtime-routing.md). Nesta sub-seção, você
 aprenderá como configurar o seu servidor Apache ou Nginx para atingir estes
 objetivos.
 
-> Info: Definindo `basic/web` como a raiz dos documentos, você também previne os
+> Informação: Definindo `basic/web` como a raiz dos documentos, você também previne os
   usuários finais de acessarem o código privado de sua aplicação e os arquivos de
   dados sensíveis que estão armazenados em diretórios irmãos de `basic/web`.
   Negar o acesso a estes outros diretórios é uma melhoria de segurança.
 
-> Info: Se a sua explicação rodará em um ambiente de hospedagem compartilhada
+> Informação: Se a sua explicação rodará em um ambiente de hospedagem compartilhada
   onde você não tem permissão para alterar a configuração do seu servidor Web,
   você ainda pode ajustar a estrutura de sua aplicação para uma melhor segurança.
   Por favor consulte a seção [Ambiente de Hospedagem Compartilhada](tutorial-shared-hosting.md)
@@ -146,8 +172,8 @@ com o caminho real para `basic/web`.
 DocumentRoot "path/to/basic/web"
 
 <Directory "path/to/basic/web">
+    # Utilize o mod_rewrite para suporte a URL amigável
     RewriteEngine on
-
     # Se um diretório ou arquivo existe, usa a requisição diretamente
     RewriteCond %{REQUEST_FILENAME} !-f
     RewriteCond %{REQUEST_FILENAME} !-d
@@ -164,7 +190,7 @@ DocumentRoot "path/to/basic/web"
 Você deve ter instalado o PHP como um [FPM SAPI](http://php.net/install.fpm) para
 usar o [Nginx](http://wiki.nginx.org/). Use a seguinte configuração do Nginx,
 substituindo `path/to/basic/web` com o caminho real para `basic/web` e `mysite.local`
-com o nome de host real a servir.
+com o nome de host real a servidor.
 
 ```
 server {
@@ -204,7 +230,7 @@ server {
 }
 ```
 
-Ao usar esta configuração, você deve definir `cgi.fix_pathinfo=0` no arquivo `php.ini`
+Ao usar esta configuração, você também deve definir `cgi.fix_pathinfo=0` no arquivo `php.ini`
 de modo a evitar muitas chamadas desnecessárias ao comando `stat()` do sistema.
 
 Também perceba que ao rodar um servidor HTTPS, você precisa adicionar `fastcgi_param HTTPS on;`,