Kumbia PHP Framework

25.1.4 find_first

Sintaxis

El método "find_first" devuelve el primer registro de una entidad ó la primera ocurrencia de acuerdo a unos criterios de búsqueda ú ordenamiento. Los parámetros son todos opcionales y su orden no es relevante, cuando se invoca sin parámetros devuelve el primer registro insertado en la entidad. Este metodo es muy flexible y puede ser usado de muchas formas:

Ejemplo

En este ejemplo buscamos el primer registro cuyo estado sea igual a “A” y ordenado descendentemente, el resultado de este se carga a la variable $Usuarios e igualmente devuelve una instancia del mismo objeto ActiveRecord en caso de éxito ó false en caso contrario.

Con el método find_first podemos buscar un registro en particular a partir de su id de esta forma:

Ejemplo

Así obtenemos el registro 123 e igualmente devuelve una instancia del mismo objeto ActiveRecord en caso de éxito ó false en caso contrario .

Kumbia genera una advertencia cuando los criterios de búsqueda para find_first devuelven más de un registro, para estro podemos forzar que se devuelva uno solo mediante el parámetro limit, de esta forma:

Ejemplo

Cuando queremos consultar solo algunos de los atributos de la entidad podemos utilizar el parámetro columns así:

Ejemplo

Cuando especificamos el primer parámetro de tipo string, ActiveRecord asumirá que son las condiciones de búsqueda para find_first, así:

Ejemplo

De esta forma podemos también deducir que estas 2 sentencias arrojarían el mismo resultado:

Ejemplo

Regresar al indice