Indiquez la table pour la requête en utilisant la méthode from(). Vous pouvez indiquer le nom de table comme une chaîne de caractères. Zend_Db_Select applique l'échappement des identificateurs autour du nom de table, ainsi vous pouvez employer les caractères spéciaux.

<?php
// Construire cette requête :
//   SELECT *
//   FROM "produits" 

$select = $db->select()
    ->from( 'produits' );
?>

Vous pouvez également indiquer le nom de corrélation (parfois appelé "l'alias de table") pour une table. Au lieu d'une chaîne de caractère simple, employez un tableau associatif faisant correspondre le nom de corrélation au nom de table. Dans d'autres clauses de la requête SQL, employez ce nom de corrélation. Si votre requête réalise des jointures sur plus d'une table, Zend_Db_Select produit des noms uniques de corrélation basés sur les noms de table, pour chaque table pour lesquelles vous n'indiquez pas le nom de corrélation.

<?php
// Construire cette requête :
//   SELECT p.*
//   FROM "produits" AS p

$select = $db->select()
    ->from( array('p' => 'produits') );
?>

Certaines marques de SGBDR supportent un spécificateur de schéma principal pour une table. Vous pouvez spécifiez un nom de table comme "nomDuSchema.nomDeTable", où Zend_Db_Select échappera chaque partie individuellement, ou vous pouvez spécifier le nom du schéma séparément. Un nom de schéma spécifié dans le nom de table sera prioritaire sur un schéma fourni séparément dans les cas où les deux seraient fournis.

<?php
// Construire cette requête :
//   SELECT *
//   FROM "monschema"."produits"

$select = $db->select()
    ->from( 'monschema.produits' );

// or

$select = $db->select()
    ->from('produits', '*', 'monschema');
?>

Dans le deuxième argument de la méthode from(), vous pouvez indiquer les colonnes à choisir parmi les tables respectives. Si vous n'indiquez aucune colonne, la valeur par défaut est "*", la caractère de remplacement SQL pour "toutes les colonnes".

Vous pouvez énumérer les colonnes dans un tableau simple de chaîne de caractère, ou en tant que tableau associatif faisant correspondre l'alias de la colonne au nom de la colonne. Si vous avez seulement une colonne à requêter, et vous n'avez pas besoin d'indiquer un alias de colonne, vous pouvez l'énumérer comme une chaîne simple au lieu d'un tableau.

Vous pouvez indiquer le nom de colonne en tant que "aliasDeTable.nomDeColonne". Zend_Db_Select échappera chaque partie individuellement. Si vous n'indiquez pas un nom d'alias pour une colonne, elle emploie le nom de corrélation de la table nommée dans la méthode courante from().

<?php
// Construire cette requête :
//   SELECT p."produit_id", p."produit_nom"
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'produit_nom'));

// Construire la même requête, en spécifiant l'alias de table :
//   SELECT p."produit_id", p."produit_nom"
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('p.produit_id', 'p.produit_nom'));

// Construire cette requête avec un alias pour une colonne :
//   SELECT p."produit_id" AS prodno, p."produit_nom"
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('prodno' => 'produit_id', 'produit_nom'));
?>

Les colonnes dans les requêtes SQL sont parfois des expressions, pas simplement des noms de colonnes d'une table. Les expressions peuvent avoir des noms d'alias ou peuvent nécessiter d'être échappées. Si la chaîne de caractère designant votre colonne contient des parenthèses, Zend_Db_Select la reconnait comme une expression.

Vous pouvez aussi créer un objet de type Zend_Db_Expr explicitement, pour éviter qu'une chaîne soit traitée comme un nom de colonne. Zend_Db_Expr est une classe minimale qui contient une unique chaîne de caractère. Zend_Db_Select reconnait les objets de type Zend_Db_Expr et les convertit en chaînes de caractère, mais n'applique aucun changement, tel qu'un échappement ou un alias.

	Note
	Utiliser Zend_Db_Expr pour les noms de colonnes n'est pas nécessaire si votre expression de colonne contient des parenthèses ; Zend_Db_Select reconnait les parenthèses et traite la chaîne comme une expression en ommettant l'échappement et les alias.

<?php
// Construire cette requête :
//   SELECT p."produit_id", LOWER(produit_nom)
//   FROM "produits" AS p
// Une expression avec parenthèses devient implicitement
// un objet Zend_Db_Expr.

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'LOWER(produit_nom)'));

// Construire cette requête :
//   SELECT p."produit_id", (p.prix * 1.08) AS prix_avec_taxe
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'prix_avec_taxe' => '(p.prix * 1.08)'));

// Construire cette requête en utilisant explicitement Zend_Db_Expr :
//   SELECT p."produit_id", p.prix * 1.08 AS prix_avec_taxe
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'prix_avec_taxe' => new Zend_Db_Expr('p.prix * 1.08')));
?>

Dans les cas ci-dessus, Zend_Db_Select ne change pas la chaîne pour appliquer des alias ou échapper les identificateurs. Si ces changements sont nécessaires pour résoudre l'ambiguïté, vous devez faire manuellement les changements dans la chaîne de caractères.

Si vos noms de colonne sont des mots-clés de SQL ou contiennent les caractères spéciaux, vous devriez employer la méthode quoteIdentifier() de l'adaptateur et interpoler le résultat dans la chaîne de caractères. La méthode quoteIdentifier() utilise l'échappement SQL pour délimiter les identificateurs, qui indique clairement que c'est un identificateur pour une table ou une colonne, et non n'importe quelle autre partie de la syntaxe de SQL.

Votre code est plus indépendant du SGBDR si vous utilisez la méthode quoteIdentifier() au lieu d'échapper littéralement dans votre chaîne, car quelques marques de SGBDR utilisent des symboles non standards pour échapper les identificateurs. La méthode quoteIdentifier() est conçue pour utiliser le symbole d'échappement approprié basé sur le type d'adaptateur. La méthode quoteIdentifier() échappe aussi tout caractère d'échappement qui apparaissent dans l'identificateur lui-même.

<?php
// Construire cette requête, en échappant une colonne spéciale nommée "from" dans une expression :
//   SELECT p."from" + 10 AS origine
//   FROM "produits" AS p

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('origine' => '(p.' . $db->quoteIdentifier('from') . ' + 10)'));
?>

Beaucoup de requêtes utiles impliquent l'utilisation de JOIN pour combiner les lignes issues de tables multiples. Vous pouvez ajouter des tables à une requête en utilisant la méthode join(). L'utilisation de cette méthode est similaire à la méthode from(), excepté que vous pouvez aussi spécifier une condition join dans la plupart des cas.

<?php
// Construire cette requête :
//   SELECT p."produit_id", p."produit_nom", l.*
//   FROM "produits" AS p JOIN "ligne_items" AS l
//     ON p.produit_id = l.produit_id

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'produit_nom'))
    ->join(array('l' => 'ligne_items'),
        'p.produit_id = l.produit_id');
?>

Le deuxième argument de join() est une chaîne qui représente la condition join. C'est une expression qui déclare les critères par lesquels les lignes d'une table correspondent aux lignes dans une autre table. Vous pouvez utiliser un nom d'alias dans cette expression.

	Note
	Aucun échappement n'est appliqué à une expression que vous spécifiez pour une condition join ; si vous avez des noms de colonnes qui nécessitent d'être échappées, vous devez utiliser quoteIdentifier() quand vous préparez la chaîne pour une condition join.

Le troisième argument de join() est un tableau des noms de colonnes, comme c'est utilisé dans la méthode from(). La valeur par défaut est "*", la méthode supporte les alias, les expressions, et les objets Zend_Db_Expr de la même manière que le tableau de noms de colonnes de la méthode from().

Pour ne choisir aucune colonne à partir d'une table, utilisez un tableau vide pour la liste de colonnes. Cette utilisation fonctionnerait aussi avec la méthode from(), mais typiquement vous pouvez avoir besoin de colonnes issues de la table primaire dans vos requêtes, tandis que vous pourriez ne vouloir aucune colonne de la table jointe.

<?php

// Construire cette requête :
//   SELECT p."produit_id", p."produit_nom"
//   FROM "produits" AS p JOIN "ligne_items" AS l
//     ON p.produit_id = l.produit_id

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id', 'produit_name'))
    ->join(array('l' => 'ligne_items'),
        'p.produit_id = l.produit_id',
        array() ); // liste de colonnes vide

?>

Le SQL a plusieurs types de jointures. Voyez la liste ci-dessous des méthodes supportant les différents types de jointures dans Zend_Db_Select.

Vous pouvez spécifier des critères pour restreindre le nombre de lignes du résultat en utilisant la méthode where(). Le premier argument de cette méthode est une expression SQL, et cette expression est utilisée dans une clause WHERE dans la requête.

<?php
// Construire cette requête :
//   SELECT produit_id, produit_nom, prix
//   FROM "produits"
//   WHERE prix > 100.00

$select = $db->select()
    ->from(
        'produits',
        array('produit_id', 'produit_nom', 'prix'))
    ->where('prix > 100.00');
?>

	Note
	Aucun échappement n'est appliqué aux expressions passées aux méthodes where() ou orWhere(). Si vous avez des noms de colonnes qui nécessitent d'être échappés, vous devez utiliser quoteIdentifier() quand vous générez la chaîne pour la condition.

Le second argument de la méthode where() est optionnel. C'est une valeur à substituer dans l'expression. Zend_Db_Select échappe cette valeur et la substitue au caractère point ("?") d'interrogation dans l'expression.

Cette méthode accepte un seul paramètre. Si vous avez une expression dans laquelle vous devez substituer plusieurs variables, vous devez formater la chaîne manuellement, en interpolant les variables et en les échappant vous-même.

<?php
// Construire cette requête :
//   SELECT produit_id, produit_nom, prix
//   FROM "produits"
//   WHERE (prix > 100.00)

$prixminimum = 100;

$select = $db->select()
    ->from(
        'produits',
        array('produit_id', 'produit_nom', 'prix'))
    ->where('prix > ?', $prixminimum);
?>

Vous pouvez appeler la méthode where() plusieurs fois sur la même objet Zend_Db_Select. La requête résultante combine les différents termes ensemble en utilisant AND entre eux.

<?php
// Construire cette requête :
//   SELECT produit_id, produit_nom, prix
//   FROM "produits"
//   WHERE (prix > 100.00)
//     AND (prix < 500.00)

$prixminimum = 100;
$prixmaximum = 500;

$select = $db->select()
    ->from('produits',
        array('produit_id', 'produit_nom', 'prix'))
    ->where('prix > ?', $prixminimum)
    ->where('prix < ?', $prixmaximum);
?>

Si vous devez combiner ensemble des termes en utilisant OR, utilisez la méthode orWhere(). Cette méthode est utilisée de la même manière que la méthode where(), excepté que le terme spécifié est précédé par OR, au lieu de AND.

<?php
// Construire cette requête :
//   SELECT produit_id, produit_nom, prix
//   FROM "produits"
//   WHERE (prix < 100.00)
//     OR (prix > 500.00)

$prixminimum = 100;
$prixmaximum = 500;

$select = $db->select()
    ->from('produits',
        array('produit_id', 'produit_nom', 'prix'))
    ->where('prix < ?', $prixminimum)
    ->orWhere('prix > ?', $prixmaximum);
?>

Zend_Db_Select met automatiquement des parenthèses autour de chaque expression spécifiée en utilisant les méthodes where() ou orWhere(). Ceci permet de s'assurer que la priorité de l'opérateur booléen n'entraîne pas de résultats inattendus.

<?php
// Construire cette requête :
//   SELECT produit_id, produit_nom, prix
//   FROM "produits"
//   WHERE (prix < 100.00 OR prix > 500.00)
//     AND (produit_nom = 'Pomme')

$prixminimum = 100;
$prixmaximum = 500;
$prod = 'Pomme';

$select = $db->select()
    ->from('produits',
        array('produit_id', 'produit_nom', 'prix'))
    ->where("prix < $prixminimum OR prix > $prixmaximum")
    ->where('produit_nom = ?', $prod);
?>

Dans l'exemple ci-dessus, le résultat serait tout à fait différent sans parenthèses, car AND a une plus grande priorité que OR. Zend_Db_Select applique les parenthèses avec pour effet de relier de manière plus étroite chaque expression dans les appels successifs de where() qu'avec AND qui combine les expressions.

Dans la syntaxe SQL, la clause GROUP BY vous permet de réduire le nombre de lignes du résultat de la requête à une ligne par valeur unique trouvé dans une(des) colonne(s) nommées) dans la clause GROUP BY.

Dans Zend_Db_Select, vous pouvez spécifier la(es) colonne(s) à utliser pour calculer les groupes de lignes en utilisant la méthode group(). L'argument de cette méthode est une colonne ou un tableau de colonnes à utiliser dans la clause GROUP BY.

<?php
// Construire cette requête :
//   SELECT p."produit_id", COUNT(*) AS ligne_items_par_produit
//   FROM "produits" AS p JOIN "ligne_items" AS l
//     ON p.produit_id = l.produit_id
//   GROUP BY p.produit_id

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id'))
    ->join(array('l' => 'ligne_items'),
        'p.produit_id = l.produit_id',
        array('ligne_items_par_produit' => 'COUNT(*)'))
    ->group('p.produit_id');
?>

Comme le tableau de colonnes de la méthode from(), vous pouvez utiliser des noms d'alias dans le nom de la colonne, et la colonne est échappé comme un identificateur à moins que la chaîne ne contiennent des parenthèses ou que ce soit un objet de type Zend_Db_Expr.

Dans la syntaxe SQL, la clause HAVING applique une restriction sur un groupe de lignes. Ceci est similaire à la manière dont la clause WHERE applique une restriction sur des lignes. Mais les deux clauses sont différentes car les conditions WHERE sont appliqués avant que les groupes de lignes ne soient définis, alors que les conditions HAVING sont appliqués après que les groupes ont été définis.

Dans Zend_Db_Select, vous pouvez spécifier des conditions pour restreindre des groupes en utilisant la méthode having(). Son utilisation est similaire à celle de la méthode where(). Le premier argument est une chaîne contenant une expression SQL. Le second argument facultatif est une valeur qui est utilisé pour remplacer le caractère de substitution positionné dans l'expression SQL. Les expressions passées dans de multiples appels de la méthode having() sont combinées en utilisant l'opérateur booléen AND, ou l'opérateur OR si vous utilisez la méthode orHaving().

<?php
// Construire cette requête :
//   SELECT p."produit_id", COUNT(*) AS ligne_items_par_produit
//   FROM "produits" AS p JOIN "ligne_items" AS l
//     ON p.produit_id = l.produit_id
//   GROUP BY p.produit_id
//   HAVING ligne_items_par_produit > 10

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id'))
    ->join(array('l' => 'ligne_items'),
        'p.produit_id = l.produit_id',
        array('ligne_items_par_produit' => 'COUNT(*)'))
    ->group('p.produit_id')
    ->having('ligne_items_par_produit > 10');
?>

	Note
	Aucun échappement n'est appliqué aux expressions fournies aux méthodes having() ou orHaving(). Si vous avez des noms de colonnes qui nécessitent d'être échappées, vous devez utiliser quoteIdentifier() quand vous générez la chaîne de cette condition.

Dans la syntaxe SQL, la clause ORDER BY spécifie une ou plusieurs colonnes ou expressions suivant lesquels le résultat d'une requête doit être trié. Si plusieurs colonnes sont listées, les colonnes secondaires sont utilisées pour résoudre les égalités ; l'ordre du tri est déterminé par les colonnes secondaires si les colonnes précédentes contiennent des valeurs identiques. Le tri par défaut est ascendant (du plus petit vers le plus grand). Vous pouvez aussi appliqué un tri descendant (du plus grand vers le plus petit) pour une colonne en spécifiant le mot-clé DESC après la colonne.

Dans Zend_Db_Select, vous pouvez utiliser la méthode order() pour spécifier une colonne ou un tableau de colonnes par lesquelles vous voulez trier. Chaque élément du tableau est une chaîne nommant une colonne, facultativement suivi les mots-clés ASC ou DESC en séparant avec un espace.

Comme pour les méthodes from() et group(), les noms de colonnes sont échappées comme des identificateurs, à moins qu'elles ne contiennent des parenthèses ou ne soient des objets de type Zend_Db_Expr.

<?php
// Construire cette requête :
//   SELECT p."produit_id", COUNT(*) AS ligne_items_par_produit
//   FROM "produits" AS p JOIN "ligne_items" AS l
//     ON p.produit_id = l.produit_id
//   GROUP BY p.produit_id
//   ORDER BY "ligne_items_par_produit" DESC, "produit_id"

$select = $db->select()
    ->from(array('p' => 'produits'),
        array('produit_id'))
    ->join(array('l' => 'ligne_items'),
        'p.produit_id = l.produit_id',
        array('ligne_items_par_produit' => 'COUNT(*)'))
    ->group('p.produit_id')
    ->order(array('ligne_items_par_produit DESC', 'produit_id'));
?>

Certaines marques de SGBDR étendent la syntaxe SQL avec une clause LIMIT. Cette clause réduit le nombre de lignes d'un résultat à un nombre maximum que vous spécifiez. Vous pouvez de plus indiquer un nombre de lignes à éviter avant de commencer à produire le résultat. Cette fonctionnalité facilite l'extraction d'un sous-ensemble d'un résultat, par exemple quand vous affichez des résultats avec un défilement de pages.

Dans Zend_Db_Select, vous pouvez utiliser la méthode limit() pouur spécifier le nombre de lignes ainsi que le nombre de lignes à omettre. Le premier argument de cette méthode est le nombre de lignes désirées. Le second argument est le nombre de lignes à omettre.

<?php
// Construire cette requête :
//   SELECT p."produit_id", p."produit_nom"
//   FROM "produits" AS p 
//   LIMIT 10, 20

$select = $db->select()
    ->from(array('p' => 'produits'), array('produit_id', 'produit_nom'))
    ->limit(10, 20);
?>

	Note
	La syntaxe LIMIT n'est pas suporté par toutes les marques de SGBDR. Quelques SGBDR nécessite une syntaxe diférente pour supporter une fonctionnalité similaire. Chaque classe Zend_Db_Adapter_Abstract inclue une méthode pour produire le code SQL approprié à ce SGBDR.

La méthode distinct() vous permet d'ajouter le mot-clé DISTINCT à votre requête SQL.

<?php
// Construire cette requête :
//   SELECT DISTINCT p."produit_nom"
//   FROM "produits" AS p

$select = $db->select()
    ->distinct()
    ->from(array('p' => 'produits'), 'produit_nom');
?>

La méthode forUpdate() vous permet d'ajouter le modificateur FOR UPDATE à votre requête SQL.

<?php
// Construire cette requête :
//   SELECT FOR UPDATE p.*
//   FROM "produits" AS p

$select = $db->select()
    ->forUpdate()
    ->from(array('p' => 'produits'));
?>

Vous pouvez exécuter la requête représentée par l'objet Zend_Db_Select en le passant comme premier argument de la méthode query() d'u objet Zend_Db_Adapter_Abstract. Utilisez les objets Zend_Db_Select plutôt qu'une simple chaîne de requête.

La méthode query() retourne un objet de type Zend_Db_Statement ou PDOStatement, dépendant du type d'adaptateur.

<?php
$select = $db->select()
  ->from('produits');

$stmt = $db->query($select);
$result = $stmt->fetchAll();
?>

Comme alternative à l'emploi de la méthode query()de l'objet adaptateur, vous pouvez utiliser la méthode query() de l'objet Zend_Db_Select. Les deux méthodes retourne un objet de type Zend_Db_Statement ou PDOStatement, dépendant du type d'adaptateur.

<?php
$select = $db->select()
    ->from('produits');

$stmt = $select->query();
$result = $stmt->fetchAll();
?>

Si vous devez accéder à la chaîne représentant la requête SQL correspondant à un objet Zend_Db_Select, utilisez la méthode __toString().

<?php
$select = $db->select()
    ->from('produits');

$sql = $select->__toString();
echo "$sql\n";

// L'affichage est la chaîne :
//   SELECT * FROM "produits"
?>

La méthode getPart() retourne une représentation d'une partie de votre requête SQL. Par exemple, vous pouvez utiliser cette méthode pour retourner un tableau d'expressions pour la clause WHERE, ou un tableau de colonnes (d'expressions de colonnes) qui sont dans l'élément SELECT, ou les valeurs de nombre et de décalage pour la clause LIMIT.

La valeur retournée n'est pas une chaîne de caractère contenant un fragment de syntaxe SQL. La valeur retournée est une représentation interne, qui est typiquement une structure de type tableau contenant des valeurs et des expressions. Chaque partie de la requête a une structure différente.

L'argument unique de la méthode getPart() est une chaîne qui identifie quelle partie de la requête Select doit être retournée. Par exemple, la chaîne "from" identifie la partie de l'objet Select qui stocke l'information concernant les tables dans la clause FROM, incluant les tables jointes.

La classe Zend_Db_Select définit des constantes que vous pouvez utiliser pour les parties de la requête SQL. Vous pouvez utiliser ces constantes ou des chaînes de caractères littérales.

<?php
$select = $db->select()
    ->from('produits')
    ->order('produit_id');

// Vous pouvez spécifier une chaîne littérale
$orderData = $select->getPart( 'order' );

// Vous pouvez utiliser une constante
$orderData = $select->getPart( Zend_Db_Select::ORDER );

// La valeur retournée peut être une structure tableau, pas une chaîne.
// Chaque partie a une structure différente
print_r( $orderData );
?>

La méthode reset() vous permet de vider une partie spécifique de la requête SQL, ou toutes les parties si vous omettez l'argument.

L'argument unique est facultatif. Vous pouvez spécifier la partie de la requête à effacer, en utilisant les mêmes chaînes que vous utilisez en tant qu'argument de la méthode getPart(). La partie de la requête que vous spécifiez est réinitialisé à l'état par défaut.

Si vous omettez le paramètre, reset() réinitialise toutes les parties de la requête à leur valeur par défaut. Ceci rend l'objet Zend_Db_Select équivalent à un nouvel objet, comme si vous l'aviez tout juste instancier.

<?php
// Construire cette requête :
//   SELECT p.*
//   FROM "produits" AS p
//   ORDER BY "produit_nom"

$select = $db->select()
    ->from(array('p' => 'produits')
    ->order('produit_nom');

// Changer la condition d'ordre avec une colonne différente :
//   SELECT p.*
//   FROM "produits" AS p
//   ORDER BY "produit_id"

// Vider la partie afin de la redéfinir
$select->reset( Zend_Db_Select::ORDER );

// Et spécifier une colonne différente
$select->order('produit_id');

// Vider toutes les parties de la requête
$select->reset();
?>