HUFERSIL.WEBDEVELOPER - Soluções com qualidade - Hugo Ferreira da Silva

where Sex, 01 de fevereiro de 2008 - as 21h06

public function where( $whereStr = null [, mixed $arg1 [, mixed $arg2 [, mixed $arg3 ...]]] )

Adiciona cláusulas where ao objeto para executar consultas ou métodos de persistência.
Por exemplo:

  1. // novo objeto pessoa
  2. $lista = new Pessoa;
  3.  
  4. // adiciona uma condição
  5. $lista->where("nome like '%hugo%'");
  6.  
  7. // recupera
  8. $lista->find();

Por questões de conformidade de padrão, é encorajado o uso do novo método de adição de cláusulas where

Agora, você poderá indicar um alias para a classe, então Lumine irá identificar seus membros automaticamente, e ajustar o valor de confirmidade com o tipo de campo:

  1. $lista->alias('l')
  2.   ->where('l.valor > ?', $_POST['valor']) // Lumine irá converter para o tipo correto de dados.
  3.   ->find();

Nas versões anteriores, em cláusulas como where, group, select, entre outras em que é necessário digitar strings, os valores a serem informados por padrão são os nomes das colunas das tabelas. Caso você deseje utilizar o nome do atributo da entidade, você deverá colocar o valor entre chaves ( { e } ). Este método ainda é suportado. Por exemplo:

  1. $lista->where("{nome} like '%hugo%'");

Você também poderá recuperar o nome da tabela da mesma forma, colocando o nome da entidade:

  1. $lista->where("{Pessoa.nome} like '%hugo%'");

Você também pode usar o estilo de prepared statment em conjunto com as chaves

  1. $lista->where('{nome} like ?', 'hugo');

O método antigo, whereAdd, ainda é válido, mas tem o mesmo comportamento do novo.