O Guia Definitivo do Yii 1.1

class Post extends CActiveRecord
{
public function relations()
{
return array(
'commentCount'=>array(self::STAT, 'Comment', 'postID'),
'categoryCount'=>array(self::STAT, 'Category', 'PostCategory
(postID, categoryID)'),
);
}
}
No código acima, declaramos duas consultas estatísticas: commentCount, que calcula o
número de comentários em um post e categoryCount, que calcula o número de categorias
a quem um post pertence. Note que o relacionamento entre Post e Comment é do tipo
HAS_MANY, enquanto o relacionamento entrePost e Category é MANY_MANY (com a
tabela associativa PostCategory). Como podemos ver a declaração é bastante similar a
das relações descritas anteriormente. A única diferença é que o tipo de relação agora é
STAT.
Com a declaração acima, podemos recuperar o número de comentários para um post
acessando a propriedade $post->commentCount. Ao acessá-la pela primeira vez, uma
instrução SQL será executada, implicitamente, para retornar o resultado correspondente.
Como já sabemos, essa técnica é chamada de lazy loading. Também podemos utilizar a
técnica eager loading se precisarmos determinar a quantidade de comentários para vários
posts.
$posts=Post::model()->with('commentCount', 'categoryCount')->findAll();
O código acima irá executar três instruções SQL para retornar todos os posts juntamente
com a quantidade de comentários e categorias em cada um deles. Utilizando lazy loading,
acabaríamos executando 2*N+1instruções SQL, se existirem N posts.
Por padrão, uma consulta estatística utiliza a expressão COUNT para calcular os
resultados. Podemos personaliza-la especificando opções adicionais, no método relations
(). As opções disponíveis estão resumidas abaixo:
• select: a expressão estatística. Por padrão é COUNT(*), que contará todos os
objetos.
• defaultValue: o valor a ser atribuído aos registros que não receberem um resultado
em uma consulta estatística. Por exemplo, se um post não tiver comentários, o valor
de commentCount será o especificado nesta propriedade. Por padrão, seu valor é 0.
• condition: representa a cláusula WHERE. Não tem nenhum valor por padrão.
• params: representa os parâmetros que devem ser vinculados na instrução SQL
gerada.