db | Base de données |
|---|---|
| CodeIgniter | PHP |
Description
Cette classe permet d'effectuer des requêtes à la base de données et contient l'Active Record (si «$active_record = TRUE;» est existant dans le fichier /application/config/database.php). Ainsi, elle contient toutes les méthodes nécessaires à la manipulation d'une base de données selon la manière d'un ORM (comme Doctrine, Propel,...). Grâce à l'«Active Record» les requêtes SQL sont portable d'une base de données à l'autre.
Initialisation
| $autoload['libraries']=array('database'); |
Méthode
Voici la liste des méthodes de la classe «db» accessible uniquement dans Code Igniter et n'étant pas fournit avec PHP :
| Méthode | Description |
|---|---|
| $this->db->cache_delete(); | Cette méthode permet d'effacer les fichiers de cache associé avec une page particulière. |
| $this->db->cache_delete_all(); | Cette méthode permet d'effacer tous les fichiers de cache. |
| $this->db->cache_off(); | Cette méthode permet de désactiver le cache des requêtes SQL. |
| $this->db->cache_on(); | Cette méthode permet d'activer le cache des requêtes SQL. |
| $this->db->call_function($fonction); | Cette méthode permet d'activer l'appel des fonctions de base de données PHP n'étant pas inclus de façon natif dans Code Igniter. |
| $this->db->conn_id | Cette propriété contient l'identificateur de connexion à la base de données. |
| $this->db->count_all($table); | Cette méthode permet de demander le nombre d'enregistrement qu'à retourner la requêtes sur une table spécifié. |
| $this->db->count_all_results($table); | Cette méthode permet de demander le nombre d'enregistrement qu'à retourner la requêtes sur une table spécifié dans une requête d'Active Record. |
| $this->db->delete($nomtable,$tableauassociatif); | Cette méthode permet de supprimer les enregistrements correspondant au critère spécifié de la table spécifié. |
| $this->db->distinct(); | Cette méthode permet d'ajouter un «DISTINCT» à une requête SQL de résultat comme un «SELECT». |
| $this->db->empty_table($nomtable); | Cette méthode permet de supprimer le contenu de la table spécifié. |
| $this->db->escape($valeur); | Cette méthode permet de mettre les caractères spéciaux pour passer la valeur dans une requêtes SQL en ajouter de simple guillemet au début et à la fin de la chaine de caractères. |
| $this->db->escape_like_str($valeur); | Cette méthode permet de mettre d'ajouter les caractères spéciaux pour passer la valeur dans une requêtes SQL sans ajouter de simple guillemet au début et à la fin de la chaine de caractères dans un contexte de «LIKE». |
| $this->db->escape_str($valeur); | Cette méthode permet de mettre d'ajouter les caractères spéciaux pour passer la valeur dans une requêtes SQL sans ajouter de simple guillemet au début et à la fin de la chaine de caractères. |
| $this->db->field_data($nomtable); | Cette méthode permet de retourner un tableau d'objet du contenu des champs d'une table. |
| $this->db->field_exists($nomchamp,$nomtable); | Cette méthode permet de vérifier si le champ spécifié dans la table spécifié existe. |
| $this->db->from($nomtable); | Cette méthode permet d'indiquer une table à spécifier pour la requête SQL. |
| $this->db->flush_cache(); | Cette méthode permet de supprimer tous les items du cache d'Active Record. |
| $this->db->free_result(); | Cette méthode permet de libérer tous les ressources utilisées par la requête SQL. |
| $this->db->get($nomtable); | Cette méthode permet de retourner dans un tableau du résultat d'une requête sur une table. |
| $this->db->get($nomtable,$limit,$deplacement); | Cette méthode permet de retourner dans un tableau une partie du résultat d'une requête sur une table. |
| $this->db->get_where($table, $tableauchamp, $limit, $offset); | Cette méthode permet d'indiquer de retourner le résultat d'une requête selon la table spécifié et les champs spécifiés pour la recherche. |
| $this->db->group_by($titre); | Cette méthode permet d'ajouter un champ au «GROUP BY» à la requête SQL. |
| $this->db->group_by($tableau); | Cette méthode permet d'ajouter une liste de champs dans un «GROUP BY» à la requête SQL. |
| $this->db->having($expression); | Cette méthode permet d'écrire la portion «HAVING» d'une requête SQL. |
| $this->db->having($champ,$valeur); | Cette méthode permet d'écrire le champ et la valeur spécifié d'une portion «HAVING» d'une requête SQL. |
| $this->db->insert($table,$donnees); | Cette méthode permet d'insérer une chaine de caractères de données spécifiées et d'exécuter la requête. |
| $this->db->insert_batch($table,$donnees); | Cette méthode permet d'insérer plusieurs chaine de caractères de données spécifié et d'exécuter la requête dans un contexte de traitement par lot. |
| $this->db->join($table, $condition, $alignement); | Cette méthode permet d'effectuer une jointure dans une la requête SQL. |
| $this->db->like($champ,$correspondance); | Cette méthode permet d'indiquer d'ajouter un test «LIKE» avec le champ et la valeur spécifié. |
| $this->db->limit($limit); | Cette méthode permet de fixer la limite du nombre d'enregistrement retourner par une requête SQL. |
| $this->db->list_tables(); | Cette méthode permet de retourner un tableau contenant les noms de toutes les tables dans la base de données actuellement connecté. |
| $this->db->not_like($champ,$correspondance); | Cette méthode permet d'indiquer d'ajouter un test «NOT LIKE» avec le champ et la valeur spécifié. |
| $this->db->num_rows(); | Cette méthode permet de demander le nombre d'enregistrements retournés par la requête SQL. |
| $this->db->num_fields(); | Cette méthode permet de demander le nombre de champs retournées par la requête SQL. |
| $this->db->order_by($champ,$direction); | Cette méthode permet d'indiquer l'ordre de tri de la requête SQL. |
| $this->db->or_like($champ,$correspondance); | Cette méthode permet d'indiquer d'ajouter un «OU» avec un test «LIKE» avec le champ et la valeur spécifié. |
| $this->db->or_not_like($champ,$correspondance); | Cette méthode permet d'indiquer d'ajouter un «OU» avec un test «NOT LIKE» avec le champ et la valeur spécifié. |
| $this->db->or_where($nomchamp,$valeur); | Cette méthode permet d'indiquer d'indiquer les tests à effectuer dans une requête SQL précédé par un «OU». |
| $this->db->or_where_in($champ, $tableau); | Cette méthode permet de tester, avec condition «OR» dans le «WHERE», plusieurs valeurs pour un même champ dans une requête SQL. |
| $this->db->or_where_not_in($champ, $tableau); | Cette méthode permet de tester, avec condition «OR» dans le «WHERE», que plusieurs valeurs ne se trouvent pas dans un champ de la requête SQL. |
| $this->db->query($sql); | Cette méthode permet de passer directement les requêtes SQL. |
| $this->db->result(); | Cette méthode permet de retourner le résultat d'une requête dans un tableau d'objets ou tableau vide si la requête n'a pas réussis. |
| $this->db->result_array(); | Cette méthode permet de retourner le résultat d'une requête dans un pure tableau. |
| $this->db->row(); | Cette méthode permet de retourner uniquement le résultat du première enregistrement. |
| $this->db->row_array(); | Cette méthode permet de retourner sous forme d'un tableau le contenu d'un enregistrement. |
| $this->db->select($portion); | Cette méthode permet d'indiquer une portion du «SELECT» d'une requête SQL. |
| $this->db->select_avg($champ); | Cette méthode permet de retourner la moyenne du champ spécifié. |
| $this->db->select_max($champ); | Cette méthode permet de retourner la valeur maximal du champ spécifié. |
| $this->db->select_min($champ); | Cette méthode permet de retourner la valeur minimal du champ spécifié. |
| $this->db->select_sum($champ); | Cette méthode permet de retourner la somme du champ spécifié. |
| $this->db->set($champ, $valeur); | Cette méthode permet de fixer la valeur d'un champ pour une requête «INSERT» ou «UPDATE». |
| $this->db->start_cache(); | Cette méthode permet de démarrer le cache. |
| $this->db->stop_cache(); | Cette méthode permet d'appeler l'arrêt du cache. |
| $this->db->table_exists($nomtable); | Cette méthode permet de vérifier si la table spécifiée existe. |
| $this->db->trans_begin(); | Cette méthode permet d'indiquer d'indiquer manuellement le début d'une transaction. |
| $this->db->trans_complete(); | Cette méthode permet d'indiquer la fin d'une transaction. |
| $this->db->trans_off(); | Cette méthode permet de désactiver une transaction. |
| $this->db->trans_status(); | Cette méthode permet de retourner l'état de la transaction. |
| $this->db->trans_strict($bool); | Cette méthode permet d'indiquer si le mode de transaction est strict. |
| $this->db->trans_start(); | Cette méthode permet d'indiquer le début d'une transaction. |
| $this->db->truncate(); | Cette méthode permet de vider le contenu de la table courante. |
| $this->db->truncate($nomtable); | Cette méthode permet de vider le contenu de la table spécifié. |
| $this->db->update($table,$donnees); | Cette méthode permet de mettre à jour et d'exécuter les requêtes basés sur les données spécifiés. |
| $this->db->update_batch($matable,$donnees,$titre); | Cette méthode permet de générer une mise-à-jour de chaine de caractères basé sur des données fournit et exécute la requête dans un traitement par lot. |
| $this->db->where($nomchamp,$valeur); | Cette méthode permet d'ajouter un test sur un champ spécifié pour une requête SQL. |
| $this->db->where($tableauassocatif); | Cette méthode permet d'ajouter une série de test pour une requête SQL. |
| $this->db->where_in($champ, $tableau); | Cette méthode permet de tester plusieurs valeurs pour un même champ dans une requête SQL. |
| $this->db->where_not_in($champ, $tableau); | Cette méthode permet de tester que plusieurs valeurs ne se trouvent pas dans un champ de la requête SQL. |
Dernière mise à jour : Jeudi, le 31 décembre 2015