|
|
|
@ -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;`, |
|
|
|
|