-
-
Notifications
You must be signed in to change notification settings - Fork 6.9k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Brazilian Portuguese translation of the Helpers Overview (#18996)
- Loading branch information
1 parent
817f956
commit 1c082f7
Showing
2 changed files
with
82 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,80 @@ | ||
Helpers | ||
======= | ||
|
||
> Observação: Esta seção está em desenvolvimento. | ||
O Yii oferece muitas classes que ajudam a simplificar as tarefas comuns de codificação, como manipulação de string ou de array, | ||
geração de código HTML, e assim por diante. Essas classes helpers (auxiliares) são organizadas no namespace `yii\helpers` e | ||
são todas classes estáticas (o que significa que contêm apenas propriedades e métodos estáticos e não devem ser instanciadas). | ||
|
||
Você usa uma classe helper chamando diretamente um de seus métodos estáticos, como o seguinte: | ||
|
||
```php | ||
use yii\helpers\Html; | ||
|
||
echo Html::encode('Test > test'); | ||
``` | ||
|
||
> Observação: Para oferecer suporte à [personalização de classes helper](#customizing-helper-classes), o Yii divide cada classe helper principal | ||
em duas classes: uma classe base (ex. `BaseArrayHelper`) e uma classe concreta (ex. `ArrayHelper`). | ||
Ao usar um helper, você deve usar apenas a versão concreta e nunca a classe base. | ||
|
||
|
||
Principais Classes Helper | ||
------------------- | ||
|
||
As seguintes classes helper são fornecidas nas versões Yii: | ||
|
||
- [ArrayHelper](helper-array.md) | ||
- Console | ||
- FileHelper | ||
- FormatConverter | ||
- [Html](helper-html.md) | ||
- HtmlPurifier | ||
- Imagine (fornecido pela extensão yii2-imagine) | ||
- Inflector | ||
- [Json](helper-json.md) | ||
- Markdown | ||
- StringHelper | ||
- [Url](helper-url.md) | ||
- VarDumper | ||
|
||
|
||
Personalização de Classes Helper <span id="customizing-helper-classes"></span> | ||
-------------------------- | ||
|
||
Para personalizar uma classe helper principal (ex. [[yii\helpers\ArrayHelper]]), você deve criar uma nova classe que | ||
estende da classe base correspondente ao helper (ex. [[yii\helpers\BaseArrayHelper]]) e nomear a sua classe da mesma | ||
forma que a classe concreta correspondente (ex. [[yii\helpers\ArrayHelper]]), Essa classe será então configurada para | ||
substituir a implementação original da estrutura. | ||
|
||
O exemplo a seguir mostra como personalizar o método [[yii\helpers\ArrayHelper::merge()|merge()]] da classe | ||
[[yii\helpers\ArrayHelper]]: | ||
|
||
```php | ||
<?php | ||
|
||
namespace yii\helpers; | ||
|
||
class ArrayHelper extends BaseArrayHelper | ||
{ | ||
public static function merge($a, $b) | ||
{ | ||
// sua implementação personalizada | ||
} | ||
} | ||
``` | ||
|
||
Salve sua classe em um arquivo chamado `ArrayHelper.php`. O arquivo pode estar em qualquer diretório, por exemplo `@app/components`. | ||
|
||
Em seguida, no [script de entrada](structure-entry-scripts.md) da sua aplicação, adicione a seguinte linha de código | ||
depois do include do arquivo `yii.php` para dizer ao [autoloader de classes do Yii](concept-autoloading.md) para carregar sua classe | ||
personalizada em vez da classe Helper original do framework: | ||
|
||
```php | ||
Yii::$classMap['yii\helpers\ArrayHelper'] = '@app/components/ArrayHelper.php'; | ||
``` | ||
|
||
Observe que personalizar as classes Helper só é útil se você quiser mudar o comportamento de uma função existente | ||
dos Helpers. Se você deseja adicionar outras funções para usar em sua aplicação, é melhor criar um | ||
Helper para isso. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters