From 22baabd8ed4b53ea3269002456d45dcb34cf0d03 Mon Sep 17 00:00:00 2001
From: Davidson Alencar <davidson.t.i@gmail.com>
Date: Mon, 24 Nov 2014 17:38:20 -0200
Subject: [PATCH] docs/guide-pt-BR/start-installation.md - typo/update
---
docs/guide-pt-BR/start-installation.md | 74 ++++++++++++++++++++++++++++++++++++++++++++++++++------------------------
1 file changed, 50 insertions(+), 24 deletions(-)
diff --git a/docs/guide-pt-BR/start-installation.md b/docs/guide-pt-BR/start-installation.md
index bc432b6..795240e 100644
--- a/docs/guide-pt-BR/start-installation.md
+++ b/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.
-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;`,
--
libgit2 0.27.1