O Guia Definitivo do Yii 1.1

No exemplo acima, utilizamos o método find em conjunto com Post::model(). Lembre-se
que o método estático model() é obrigatório em todas as classes AR. Esse método retorna
uma instância AR que é utilizada para acessar métodos a nível de classe (algo parecido
com métodos estáticos de classe) em um contexto de objeto.
Se o método find encontra um registro que satisfaça as condições da consulta, ele irá
retornar uma instância cujas propriedades irão conter os valores do registro específico.
Podemos então ler os valores carregados normalmente como fazemos com as
propriedades de um objeto. Por exemplo, echo $post->title;.
O método find irá retornar null se nenhum registro for encontrado.
Ao executar o método find, utilizamos os parâmetros $condition e $params para
especificar as condições desejadas. Nesse caso, $condition pode ser uma string
representando uma cláusula WHERE, do SQL, e $params é um vetor com parâmetros
cujos valores devem ser vinculados a marcadores na $condition. Por exemplo:
// encontra o registro com postID=10
$post=Post::model()->find('postID=:postID', array(':postID'=>10));
Nota: No exemplo acima, precisamos escapar a referência para a coluna postID, em
certos SGBDs. Por exemplo, se estivermos utilizando o PostgreSQL, deveríamos ter
escrito a condição como "postID"=:postID, porque este banco de dados, por padrão,
não diferencia letras maiúsculas e minúsculas nos nomes de colunas.
Podemos também utilizar o parâmetro $condition para especificar condições de pesquisa
mais complexas. Em vez de uma string, $condition pode ser uma instância de
CDbCriteria, o que permite especificar outras condições além do WHERE. Por exemplo:
$criteria=new CDbCriteria;
$criteria->select='title'; // seleciona apenas a coluna title
$criteria->condition='postID=:postID';
$criteria->params=array(':postID'=>10);
$post=Post::model()->find($criteria); // $params não é necessario
Note que, ao utilizar CDbCriteria como condição para a pesquisa, o parâmetro $params
não é mais necessário, uma vez que ele pode ser especificado diretamente na instância
de CDbCriteria, como no exemplo acima.
Uma maneira alternativa de utilizar CDbCriteria é passar um vetor para o método find. As
chaves e valores do vetor correspondem as propriedades e valores da condição,
respectivamente. O exemplo acima pode ser reescrito da seguinte maneira: