O Guia Definitivo do Yii 1.1

Informação: Uma chave estrangeira pode ser composta, consistindo de duas ou mais
colunas. Nesse caso, devemos concatenar os nomes das colunas da chave
estrangeira e separa-los por um espaço ou uma vírgula. Para relacionamentos do tipo
MANY_MANY, a tabela associativa também deve ser especificada na chave
estrangeira. Por exemplo, o relacionamento categories em Post é especificado com a
chave estrangeira PostCategory(postID, categoryID).
A declaração de relacionamentos em uma classe AR adiciona, implicitamente, uma
propriedade para cada relacionamento declarado. Depois que a consulta relacional for
executada, a propriedade correspondente será preenchida com as instâncias AR
relacionadas. Por exemplo, se $author representa uma instância de User, podemos
utilizar $author->posts para acessar as instâncias de seus Post relacionados.
Executando Consultas Relacionais
A maneira mais simples de executar uma consulta relacional é acessar uma propriedade
relacional em uma instância AR. Se a propriedade não foi acessada antes, uma consulta
relacional será iniciada, que irá unir as duas tabelas relacionadas e filtra-las pela chave
primária da instância. O resultado da consulta será armazenado na propriedade como
instância(s) da classe AR relacionada. Essa técnica é conhecida por delazy loading
(carregamento retardado). Ou seja, a pesquisa relacional é executada somente quando
os objetos relacionados são acessados. O exemplo abaixo mostra como utilizar essa
técnica:
// recupera post com ID 10
$post=Post::model()->findByPk(10);
// recupera o autor do post. Uma consulta relacional será executada aqui
$author=$post->author;
Informação: Se não existirem instâncias para um relacionamento, a propriedade
correspondente poderá ser null ou um vetor vazio. Para relacionamentos do tipo
BELONGS_TO e HAS_ONE, o retorno é null; para HAS_MANY e MANY_MANY, o
retorno é um vetor vazio. Note que HAS_MANY e MANY_MANY retornam um vetor de
objetos. Sendo assim, você precisará primeiro acessar seus elementos para acessar
suas propriedades. Caso contrário, você poderá gerar o erro "Trying to get property of
non-object".
A técnica do lazy loading é bastante conveniente, mas não é eficiente em alguns cenários.
Por exemplo, se queremos acessar informações do autor para N posts, a utilização de
lazy loading irá executar N consultas. Nessas circunstâncias devemos recorrer a técnica
de eager loading.
Nessa técnica, recuperamos as instâncias AR relacionadas junto com a instância AR
principal. Isso é feito utilizando-se o método with(), junto com um dos métodos find ou
findAll. Por exemplo:
$posts=Post::model()->with('author')->findAll();