exec doit être utilisé pour les requêtes qui ne renvoient pas de résultat (UPDATE, INSERT, DELETE...). cette méthode renvoie juste le nombre de lignes concernées par la requête. Exemple :

  $cnx = jDb::getConnection();

  $cnx->exec("INSERT INTO users (nom,prenom) VALUES('dupont','toto')");

query est fait pour les requêtes qui renvoient des résultats, vides ou pas (SELECT ou procédures stockées). La méthode renvoie alors un objet jDbResultSet.

Voici un exemple rapide :

  $cnx = jDb::getConnection();

  $rs = $cnx->query('SELECT nom, prenom FROM users');
  $result = '';
  while ($record = $rs->fetch()) {
     $result .= 'nom = '.$record->nom.' prenom = '.$record->prenom."\n";
  }

Vous pouvez faire des requêtes qui récupèrent un nombre limité d'enregistrements. Vous utiliserez alors la méthode limitQuery :

  $cnx = jDb::getConnection();

  $rs = $cnx->limitQuery('SELECT nom, prenom FROM users', 5, 10);
  $result = '';
  while ($record = $rs->fetch()) {
     $result .= 'nom = '.$record->nom.' prenom = '.$record->prenom."\n";
  }

Le premier paramètre est la requête. Le deuxième est le numéro, dans la liste des résultats, du premier enregistrement à récupérer. Le troisième paramètre est le nombre d'enregistrements à récupérer.

Vous pouvez utiliser des requêtes préparées. C'est d'ailleurs plus sécurisé quand il faut injecter des paramètres dans la requete SQL. Tous les drivers fournis avec Jelix supportent les requêtes préparées, excepté "mssql".

L'API est similaire à PDO : une méthode prepare permet d'indiquer la requête. Celle-ci peut avoir des paramètres nommés, commençant par ":". La méthode renvoi un objet de type jDbResultSet.

    $stmt = $cnx->prepare('INSERT INTO `labels_test` (`key`,`lang` ,`label`) VALUES (:k, :lg, :lb)');

Sur cet objet jDbResultSet, on peut indiquer la valeur de chaque paramètre avec la méthode bindParam() ou bindValue(). bindParam() permet de donner une valeur de variable, tandis que bindValue() permet d'indiquer directement une valeur PHP. Vous devez indiquer à ces deux methodes, le type de la valeur ou de la variable, avec l'une des constantes PDO::PARAM_*. Par défaut, c'est PDO::PARAM_STR, donc la valeur doit être une chaîne.

    $bind = $stmt->bindParam('lg', $lang);
    $bind = $stmt->bindParam('k', $key, PDO::PARAM_INT);
    $bind = $stmt->bindValue('lb', 'hello', PDO::PARAM_STR);

Et ensuite, on lance l'execution de la requête :

    $stmt->execute();

Si la requête est un select, on peut se servir de $stmt comme un ResultSet classique, voir la section suivante.

Il est possible de relancer l'execution avec d'autres valeurs pour les paramètres, autant de fois que l'on veut, sans avoir à rééxecuter prepare().

    $stmt = $cnx->prepare('INSERT INTO `labels_test` (`key`,`lang` ,`label`) VALUES (:k, :lg, :lb)');

    // on insère un premier enregistrement
    $bind = $stmt->bindParam('lg', $lang);
    $bind = $stmt->bindParam('k', $key, PDO::PARAM_INT);
    $bind = $stmt->bindValue('lb', 'hello', PDO::PARAM_STR);
    $stmt->execute();

    // on insère un deuxième enregistrement, en modifiant juste les paramètres
    // qui changent
    $bind = $stmt->bindValue('k', 'good.bye', PDO::PARAM_INT);
    $bind = $stmt->bindValue('lb', 'Good Bye', PDO::PARAM_STR);
    $stmt->execute();

Une alternative à l'utilisation de bindParam() et bindValue(), est de donner les valeurs directement à la méthode execute().

    $stmt = $cnx->prepare('INSERT INTO `labels_test` (`key`,`lang` ,`label`) VALUES (:k, :lg, :lb)');

    $stmt->execute(array(
        'lg' => $lang,
        'k' => $key,
        'lb' => 'hello'
    ));

Notez que le driver oci ne prend pas en charge les paramètres donnés à execute().

Il est possible de passer un objet jDbResultSet dans un template.

Dans le contrôleur :

  $cnx = jDb::getConnection();

  $rs = $cnx->query('SELECT nom, prenom FROM users');

  $template->assign('resultats', $rs);

Dans le template :

  <table>
    <tr> <th>nom</th> <th>prenom</th></tr>
  {foreach $resultats as $user}
    <tr> 
       <td>{$user->nom|eschtml}</td>
       <td>{$user->prenom|eschtml}</td>
    </tr>
  {/foreach}
   </table>