Internacionalização e Localização¶

Arquivos de Idiomas¶

Traduções podem ser disponibilizados usando arquivos de idiomas armazenados na aplicação. O formato padrão para arquivos de tradução do CakePHP é o formato Gettext. Os arquivos precisam ser colocado dentro do Diretório resources/locales/ e dentro deste diretório, deve haver uma subpasta para cada idioma, por exemplo:

/resources
    /locales
        /en_US
            default.po
        /en_GB
            default.po
            validation.po
        /es
            default.po

O domínio padrão é “default”, portanto, a pasta resources/locales/ deve pelo menos conter o arquivo default.po como mostrado acima. Um domínio refere-se a qualquer arbitrário agrupamento de mensagens de tradução. Quando nenhum grupo é usado, o grupo padrão é selecionado.

As mensagens das Strings do core extraídos da biblioteca CakePHP podem ser armazenado separadamente em um arquivo chamado cake.po em resources/locales/. O CakePHP localized library possui traduções para as mensagens traduzidas voltados para o cliente no núcleo (o domínio Cake). Para usar esses arquivos, baixar ou copiá-los para o seu local esperado: resources/locales/<locale>/cake.po. Se sua localidade está incompleta ou incorreta, por favor envie um PR neste repositório para corrigi-lo.

Plugins também podem conter arquivos de tradução, a convenção é usar o under_score do nome do plugin como o domínio para a tradução mensagens:

MyPlugin
    /resources
        /locales
            /fr
                my_plugin.po
            /de
                my_plugin.po

Pastas de tradução pode ser o código ISO de duas letras do idioma ou nome do local completo, como fr_FR, es_AR, da_DK que contém tanto o idioma e o país onde ele é falado.

Um exemplo de arquivo de tradução pode ser visto como:

msgid "My name is {0}"
msgstr "Je m'appelle {0}"

msgid "I'm {0,number} years old"
msgstr "J'ai {0,number} ans"

Extraindo arquivos .pot com I18n Shell¶

Para criar os arquivos .pot apartir de __() e outros tipos de mensagens internacionalizadas que podem ser encontrados no código do aplicativo, você pode usar o shell i18n. Por favor, leia o Capítulo Seguinte para saber mais.

Definir a localidade padrão¶

A localidade padrão pode ser definida em no arquivo config/app.php, definindo App.default Locale:

'App' => [
    ...
    'defaultLocale' => env('APP_DEFAULT_LOCALE', 'en_US'),
    ...
]

Isto vai controlar vários aspectos da aplicação, incluindo o padrão da linguagem de traduções, o formato da data, formato de número e moeda sempre que qualquer daqueles é exibida usando as bibliotecas de localização que o CakePHP fornece.

Alterando o local em tempo de execução¶

Para alterar o idioma para as mensagens traduzidas você pode chamar esse método:

use Cake\I18n\I18n;

I18n::setLocale('de_DE');

Isso também irá alterar a forma como números e datas são formatadas quando usamos uma das ferramentas de localização.

Usando variáveis em mensagens de tradução¶

Funções de tradução permitem que você interpole variáveis para as mensagens usando marcadores especiais definidos na própria mensagem ou na string traduzida:

echo __("Hello, my name is {0}, I'm {1} years old", ['Jefferson', 19]);

Marcadores são numéricos, e correspondem às teclas na matriz passada. Você pode também passar variáveis como argumentos independentes para a função:

echo __("Small step for {0}, Big leap for {1}", 'Man', 'Humanity');

Todas as funções de tradução apoiam as substituições de espaço reservado:

__d('validation', 'The field {0} cannot be left empty', 'Name');

__x('alphabet', 'He read the letter {0}', 'Z');

O caracter ' (aspas simples) age como um código de escape na mensagem de tradução. Todas as variáveis entre aspas simples não serão substituídos e é tratado como texto literal. Por exemplo:

__("This variable '{0}' be replaced.", 'will not');

Ao usar duas aspas adjacentes suas variáveis e serão substituídos adequadamente:

__("This variable ''{0}'' be replaced.", 'will');

Estas funções tiram vantagem do UTI MessageFormatter para que possa traduzir mensagens e localizar datas, números e moeda, ao mesmo tempo:

echo __(
    'Hi {0,string}, your balance on the {1,date} is {2,number,currency}',
    ['Charles', '2014-01-13 11:12:00', 1354.37]
);

// Returns
Hi Charles, your balance on the Jan 13, 2014, 11:12 AM is $ 1,354.37

Os números em espaços reservados podem ser formatados, bem como com o controle de grão fino da saída:

echo __(
    'You have traveled {0,number,decimal} kilometers in {1,number,integer} weeks',
    [5423.344, 5.1]
);

// Returns
You have traveled 5,423.34 kilometers in 5 weeks

echo __('There are {0,number,#,###} people on earth', 6.1 * pow(10, 8));

// Returns
There are 6,100,000,000 people on earth

Esta é a lista de especificadores de formato que você pode colocar após a palavra number:

• integer: Remove a parte Decimal

• decimal: Formata o número como um float

• currency: Coloca o local do símbolo de moeda e números de casas decimais

• percent: Formata o número como porcentagem

Datas também pode ser formatadas usando a palavra date após o número do espaço reservado. Uma lista de opções adicionais a seguir:

• short

• medium

• long

• full

A palavra time após o número de espaço reservado também é aceito e compreende as mesmas opções que date.

Plurais¶

Uma parte crucial de internacionalizar sua aplicação é a pluralização das suas mensagens corretamente, dependendo do idioma que eles são mostrados. O CakePHP fornece algumas maneiras de selecionar corretamente plurais em suas mensagens.

msgid "{0,plural,=0{No records found} =1{Found 1 record} other{Found # records}}"
msgstr "{0,plural,=0{Nenhum resultado} =1{1 resultado} other{# resultados}}"

msgid "{placeholder,plural,=0{No records found} =1{Found 1 record} other{Found {1} records}}"
msgstr "{placeholder,plural,=0{Nenhum resultado} =1{1 resultado} other{{1} resultados}}"

__('{0,plural,=0{No records found }=1{Found 1 record} other{Found # records}}', [0]);

// Returns "Ningún resultado" as the argument {0} is 0

__('{0,plural,=0{No records found} =1{Found 1 record} other{Found # records}}', [1]);

// Returns "1 resultado" because the argument {0} is 1

__('{placeholder,plural,=0{No records found} =1{Found 1 record} other{Found {1} records}}', [0, 'many', 'placeholder' => 2])

// Returns "many resultados" because the argument {placeholder} is 2 and
// argument {1} is 'many'

{ [count placeholder],plural, case1{message} case2{message} case3{...} ... }

msgid "search.results"
msgstr "{0,plural,=0{Nenhum resultado} =1{1 resultado} other{{1} resultados}}"

__('search.results', [2, 2]);

// Returns: "2 resultados"

=0{No results} =1{...} other{...}

zero{No Results} one{One result} few{...} many{...} other{...}

# One message identifier for singular
msgid "One file removed"
# Another one for plural
msgid_plural "{0} files removed"
# Translation in singular
msgstr[0] "Un fichero eliminado"
# Translation in plural
msgstr[1] "{0} ficheros eliminados"

// Returns: "10 ficheros eliminados"
$count = 10;
__n('One file removed', '{0} files removed', $count, $count);

// Também é possível utilizá-lo dentro de um domínio
__dn('my_plugin', 'One file removed', '{0} files removed', $count, $count);

msgid "One file removed"
msgid_plural "{0} files removed"
msgstr[0] "{0} datoteka je uklonjena"
msgstr[1] "{0} datoteke su uklonjene"
msgstr[2] "{0} datoteka je uklonjeno"