Merge pull request #5651 from alanwillms/pt-br-structure-application-components

docs/guide-pt-BR/structure-application-components.md

+Componentes de Aplicação
+========================
+
+Aplicações são [service locators](concept-service-locator.md). Elas hospedam um
+conjunto de assim chamados *componentes de aplicação* que fornecem diferentes
+serviços para o processamento de requisições. Por exemplo, o componente
+`urlManager` é responsável pelo roteamento de requisições Web aos controllers
+adequados; o componente `db` fornece serviços relacionados a bancos de dados; e
+assim por diante.
+
+Cada componente de aplicação tem um ID que o identifica de maneira única dentre
+os outros componentes de uma mesma aplicação. Você pode acessar um componente de
+aplicação através da expressão
+
+```php
+\Yii::$app->componentID
+```
+
+Por exemplo, você pode usar `\Yii::$app->db` para obter a [[yii\db\Connection|conexão do BD]],
+e `\Yii::$app->cache` para obter o [[yii\caching\Cache|cache primário]] registrado
+com a aplicação.
+
+Um componente de aplicação é criado na primeira vez em que é acessado através
+da expressão acima. Quaisquer acessos posteriores retornarão a mesma instância
+do componente.
+
+Componentes de aplicação podem ser quaisquer objetos. Você pode registrá-los
+configurando a propriedade [[yii\base\Application::components]] nas
+[configurações da aplicação](structure-applications.md#application-configurations).
+Por exemplo,
+
+```php
+[
+    'components' => [
+        // registra o componente "cache" usando um nome de classe
+        'cache' => 'yii\caching\ApcCache',
+
+        // registra o componente "db" usando um array de configuração
+        'db' => [
+            'class' => 'yii\db\Connection',
+            'dsn' => 'mysql:host=localhost;dbname=demo',
+            'username' => 'root',
+            'password' => '',
+        ],
+
+        // registra o componente "search" usando uma função anônima
+        'search' => function () {
+            return new app\components\SolrService;
+        },
+    ],
+]
+```
+
+> Info: Embora você possa registrar quantos componentes de aplicação você quiser,
+  você deveria fazer isso com juízo. Componentes de aplicação são como variáveis
+  globais. Usar componentes de aplicação demais pode tornar seu código
+  potencialmente mais difícil de testar e manter. Em muitos casos, você pode
+  simplesmente criar um componente local e utilizá-lo quando necessário.
+
+
+## Components de Inicialização <a name="bootstrapping-components"></a>
+
+Conforme mencionado acima, um componente de aplicação só será instanciado quando
+ele estiver sendo acessado pela primeira vez. Se ele nunca for acessado durante
+uma requisição, ele não será instanciado. No entanto, algumas vezes você pode
+querer instanciar um componente de aplicação em todas as requisições, mesmo que
+ele não seja explicitamente acessado. Para fazê-lo, você pode listar seu ID na
+propriedade [[yii\base\Application::bootstrap|bootstrap]] da aplicação.
+
+Por exemplo, a configuração de aplicação a seguir assegura-se que o componente
+`log` sempre esteja carregado:
+
+```php
+[
+    'bootstrap' => [
+        'log',
+    ],
+    'components' => [
+        'log' => [
+            // configuração para o componente "log"
+        ],
+    ],
+]
+```
+
+
+## Componentes de Aplicação do Core <a name="core-application-components"></a>
+
+O yii define um conjunto de componentes de aplicação do **core** com IDs fixos
+e configurações padrão. Por exemplo, o componente [[yii\web\Application::request|request]]
+é usado para coletar as informações sobre uma requisição do usuário e resolvê-la
+em uma [rota](runtime-routing.md); o componente [[yii\base\Application::db|db]]
+representa uma conexão do banco de dados através da qual você pode realizar
+consultas. É com a ajuda destes componentes de aplicação do core que as aplicações
+Yii conseguem tratar as requisições dos usuários.
+
+Segue abaixo uma lista dos componentes de aplicação pré-definidos do core. Você
+pode configurá-los e personalizá-los como você faz com componentes de aplicação
+normais. Quando você estiver configurando um componente de aplicação do core,
+se você não especificar sua classe, a padrão será utilizada.
+
+* [[yii\web\AssetManager|assetManager]]: gerencia os asset bundles e a publicação
+  de assets. Por favor consulte a seção [Gerenciando Assets](structure-assets.md)
+  para mais detalhes.
+* [[yii\db\Connection|db]]: representa uma conexão do banco de dados através da
+  qual você poderá realizar consultas. Perceba que quando você configura esse
+  componente, você precisa especificar a classe do componente bem como as outras
+  propriedades obrigatórios, tais como [[yii\db\Connection::dsn]]. Por favor
+  consulte a seção [Data Access Objects](db-dao.md) (Objeto de Acesso a Dados)
+  para mais detalhes.
+* [[yii\base\Application::errorHandler|errorHandler]]: manipula erros e exceções
+  do PHP. Por favor consulte a seção [Tratamento de Erros](runtime-handling-errors.md)
+  para mais detalhes.
+* [[yii\i18n\Formatter|formatter]]: formata dados quando são exibidos aos
+  usuários finais. Por exemplo, um número pode ser exibido com um separador de
+  milhares, uma data pode ser formatada em um formato longo. Por favor consulte
+  a seção [Formatação de Dados](output-formatter.md) para mais detalhes.
+* [[yii\i18n\I18N|i18n]]: suporta a tradução e formatação de mensagens. Por favor
+  consulte a seção [Internacionalização](tutorial-i18n.md) para mais detalhes.
+* [[yii\log\Dispatcher|log]]: gerencia alvos de logs. Por favor consulte a seção
+  [Gerenciamento de Logs](runtime-logging.md) para mais detalhes.
+* [[yii\swiftmailer\Mailer|mail]]: suporta a composição e envio de e-mails. Por
+  favor consulte a seção [Enviando E-mails](tutorial-mailing.md) para mais
+  detalhes.
+* [[yii\base\Application::response|response]]: representa a resposta sendo enviada
+  para os usuários finais. Por favor consulte a seção [Respostas](runtime-responses.md)
+  para mais detalhes.
+* [[yii\base\Application::request|request]]: representa a requisição recebida dos
+  usuários finais. Por favor consulte a seção [Requisições](runtime-requests.md)
+  para mais detalhes.
+* [[yii\web\Session|session]]: representa as informações da sessão. Esse componente
+  só está disponível em [[yii\web\Application|aplicações Web]]. Por favor consulte
+  a seção [Sessões e Cookies](runtime-sessions-cookies.md) para mais detalhes.
+* [[yii\web\UrlManager|urlManager]]: suporta a análise e criação de URLs. Por
+  favor consulte a seção [Análise e Geração de URLs](runtime-url-handling.md)
+  para mais detalhes.
+* [[yii\web\User|user]]: representa as informações de autenticação do usuário.
+  Esse componente só está disponível em [[yii\web\Application|aplicações Web]].
+  Por favor consulte a seção [Autenticação](security-authentication.md) para
+  mais detalhes.
+* [[yii\web\View|view]]: suporta a renderização de views. Por favor consulte a
+  seção [Views](structure-views.md) para mais detalhes.

docs/internals-pt-BR/translation-workflow.md

@@ -87,9 +87,11 @@ Regras e Observações
 - alias
 - cache
 - CamelCase
+- core
 - framework
 - hash
 - helper
 - id
+- runtime
 - widget