Convenções

O Yii favorece convenções sobre configurações. Siga as convenções e você poderá criar aplicações sofisticadas sem ter que escrever ou gerenciar configurações complexas. Evidentemente, o Yii ainda podem ser personalizados em quase todos os aspectos, com configurações, quando necessário.

Abaixo descrevemos convenções que são recomendadas para programar com o Yii. Por conveniência, assumimos que WebRoot é o diretório onde está instalada uma aplicação desenvolvida com o Yii framework.

URL

Por padrão, o Yii reconhece URLs com o seguinte formato:

http://hostname/index.php?r=ControllerID/ActionID

A variável r, passada via GET, refere-se a rota, que pode ser interpretada pelo Yii como um controle e uma ação. Se o id da ação (ActionID) for omitido, o controle irá utilizar a ação padrão (definida através da propriedade CController::defaultAction); e se o id do controle (ControllerID) também for omitido (ou a variável r estiver ausente), a aplicação irá utilizar o controle padrão (definido através da propriedade CWebApplication::defaultController).

Com a ajuda da classe CUrlManager, é possível criar e reconhecer URLs mais amigáveis, ao estilo SEO, tais como http://hostname/ControllerID/ActionID.html. Esta funcionalidade é abordada em detalhes em Gerenciamento de URL.

Código

O Yii recomenda que nomes de variáveis, funções e nomes de classe sejam escritos no formato Camel Case, onde inicia-se cada palavra com letra maiúscula e junta-se todas, sem espaços entre elas. Variáveis e nomes de funções devem ter a sua primeira palavra totalmente em letras minúsculas, a fim de diferencia-los dos nomes das classes (por exemplo, $basePath, runController(), LinkPager). Para as variáveis privadas membros de classe, é recomendado prefixar seus nomes com um underscore (por exemplo, $_actionList).

Como não há suporte a namespaces antes do PHP 5.3.0, é recomendado que as classes sejam denominadas de uma forma única, para evitar conflitos com nomes de classes de terceiros. Por esta razão, todas as classes do Yii framework são prefixadas com a letra "C".

Existe uma regra especial para as classes de controle, onde deve-se adicionar o sufixo Controller ao nome da classe. O ID do controle é, então, definido como o nome da classe, com a primeira letra minúscula, e a palavra Controller removida. Por exemplo, a classe PageController terá o ID page. Esta regra torna a aplicação mais segura. Também deixa mais limpas as URLs relacionados aos controles (por exemplo, /index.php?r=page/index em vez de /index.php?r=PageController/index).

Configuração

A configuração é um vetor de pares chave-valor. Cada chave representa o nome de uma propriedade do objeto a ser configurado, e cada valor, o valor inicial da propriedade correspondente. Por exemplo, array('name'=>'Minha aplicação', 'basePath'=>'/protected') inicializa as propriedades name e basePath com os valores correspondentes no vetor.

Qualquer propriedades "alterável" de um objeto pode ser configurada. Se não forem configuradas, as propriedades assumirão seus valores padrão. Ao configurar uma propriedade, vale a pena ler a documentação correspondente, para que o valor inicial seja configurado corretamente.

Arquivo

As convenções para nomenclatura e utilização de arquivos dependem seus tipos.

Arquivos de classe devem ser nomeados de acordo com a classe pública que contém. Por exemplo, a classe CController está no arquivo CController.php. Uma classe pública é uma classe que pode ser utilizada por qualquer outra. Cada arquivo de classe deve conter, no máximo, uma classe pública. Classes privadas (aquelas que são utilizadas apenas por uma única classe pública) podem residir no mesmo arquivo com a classe que a utiliza.

Os arquivos das visões devem ser nomeados de acordo com o seus nomes. Por exemplo, a visão index está no arquivo index.php. O arquivo de uma visão contém um script com código HTML e PHP, utilizado, principalmente para apresentação de conteúdo.

Arquivos de configuração podem ser nomeadas arbitrariamente. Um arquivo de configuração é um script em PHP cuja única finalidade é a de retornar um vetor associativo representando a configuração.

Diretório

O Yii assume um conjunto predefinido de diretórios utilizados para diversas finalidades. Cada um deles pode ser personalizado, se necessário.

Banco de Dados

A maioria das aplicações web utilizam algum tipo de banco de dados. Como boa prática, propomos as seguintes convenções para a criação de nomes de tabelas e colunas. Note que nenhuma delas é obrigatória para a utilização do Yii.

$Id: basics.convention.txt 2345 2010-08-28 12:51:08Z mdomba $
$Id: basics.convention.txt 749 2009-02-26 02:11:31Z qiang.xue $