20.11.2014 Views

O Guia Definitivo do Yii 1.1

O Guia Definitivo do Yii 1.1

O Guia Definitivo do Yii 1.1

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Como não há suporte a namespaces antes <strong>do</strong> PHP 5.3.0, é recomenda<strong>do</strong> que as classes<br />

sejam denominadas de uma forma única, para evitar conflitos com nomes de classes de<br />

terceiros. Por esta razão, todas as classes <strong>do</strong> <strong>Yii</strong> framework são prefixadas com a letra<br />

"C".<br />

Existe uma regra especial para as classes de controle, onde deve-se adicionar o sufixo<br />

Controller ao nome da classe. O ID <strong>do</strong> controle é, então, defini<strong>do</strong> como o nome da classe,<br />

com a primeira letra minúscula, e a palavra Controller removida. Por exemplo, a classe<br />

PageController terá o ID page. Esta regra torna a aplicação mais segura. Também deixa<br />

mais limpas as URLs relaciona<strong>do</strong>s aos controles (por exemplo,/index.php?r=page/index<br />

em vez de /index.php?r=PageController/index).<br />

Configuração<br />

A configuração é um vetor de pares chave-valor. Cada chave representa o nome de uma<br />

propriedade <strong>do</strong> objeto a ser configura<strong>do</strong>, e cada valor, o valor inicial da propriedade<br />

correspondente. Por exemplo, array('name'=>'Minha aplicação', 'basePath'=>'/protected')<br />

inicializa as propriedades name e basePath com os valores correspondentes no vetor.<br />

Qualquer propriedades "alterável" de um objeto pode ser configurada. Se não forem<br />

configuradas, as propriedades assumirão seus valores padrão. Ao configurar uma<br />

propriedade, vale a pena ler a <strong>do</strong>cumentação correspondente, para que o valor inicial seja<br />

configura<strong>do</strong> corretamente.<br />

Arquivo<br />

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

Arquivos de classe devem ser nomea<strong>do</strong>s de acor<strong>do</strong> com a classe pública que contém.<br />

Por exemplo, a classe CController está no arquivo CController.php. Uma classe pública é<br />

uma classe que pode ser utilizada por qualquer outra. Cada arquivo de classe deve<br />

conter, no máximo, uma classe pública. Classes privadas (aquelas que são utilizadas<br />

apenas por uma única classe pública) podem residir no mesmo arquivo com a classe que<br />

a utiliza.<br />

Os arquivos das visões devem ser nomea<strong>do</strong>s de acor<strong>do</strong> com o seus nomes. Por exemplo,<br />

a visão index está no arquivo index.php. O arquivo de uma visão contém um script com<br />

código HTML e PHP, utiliza<strong>do</strong>, principalmente para apresentação de conteú<strong>do</strong>.<br />

Arquivos de configuração podem ser nomeadas arbitrariamente. Um arquivo de<br />

configuração é um script em PHP cuja única finalidade é a de retornar um vetor<br />

associativo representan<strong>do</strong> a configuração.<br />

Diretório<br />

O <strong>Yii</strong> assume um conjunto predefini<strong>do</strong> de diretórios utiliza<strong>do</strong>s para diversas finalidades.<br />

Cada um deles pode ser personaliza<strong>do</strong>, se necessário.<br />

• WebRoot/protected: este é o diretório base da aplicação, onde estão to<strong>do</strong>s os scripts<br />

PHP que precisão estar seguros e os arquivos de da<strong>do</strong>s. O <strong>Yii</strong> tem um apeli<strong>do</strong> (alias)

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!