Alan Willms
10 years ago
1 changed files with 142 additions and 0 deletions
@ -0,0 +1,142 @@
|
||||
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. |
Loading…
Reference in new issue