Spécification des méta-données

La première longue section décrit en détail comment les méta-données décrivant la base de données et le modèle SDO requis est fourni à DAS Relationnel.

Lorsque le constructeur de DAS Relationnel est appelé, il doit recevoir plusieurs informations. La majeure partie des informations, passée en tant qu'un tableau associatif dans le premier argument du constructeur, dit à DAS Relationnel ce qu'il doit savoir à propos de la base de données relationnelle. Il décrit les noms des tables, des colonnes, des clés primaires et des clés secondaires. On devrait comprendre assez facilement ce qui est requis et une fois écrit, il peut être placé dans un fichier PHP et inclut lorsque nécessaire. Le reste des informations, passé dans un deuxième et troisième arguments du constructeur, dit au DAS Relationnel ce qu'il doit savoir à propos des relations entre les objets et la forme du graphique de données; il détermine finalement comment les données de la base de données seront normalisées dans le graphique.

create table compagnie (
   id integer auto_increment,
   nom char(20),
   employe_du_mois integer,
   primary key(id)
 );
 create table department (
   id integer auto_increment,
   nom char(20),
   emplacement char(10),
   nombre integer(3),
   co_id integer,
   primary key(id)
 );
 create table employe (
   id integer auto_increment,
   nom char(20),
   SN char(4),
   gestionnaire tinyint(1),
   dept_id integer,
   primary key(id)
 );

create table compagnie ( \
    id integer not null generated by default as identity,  \
    nom varchar(20), \
    employe_du_mois integer, \
    primary key(id) )
create table department ( \
    id integer not null generated by default as identity, \
    nom varchar(20), \
    emplacement varchar(10), \
    nombre integer, \
    co_id integer, \
    primary key(id) )
create table employe ( \
    id integer not null generated by default as identity, \
    nom varchar(20), \
    SN char(4), \
    gestionnaire smallint, \
    dept_id integer, \
    primary key(id) )

Exemples avec une table

Les exemples suivants utilisent tous le DAS Relationnel pour travailler avec un graphique de données contenant juste un objet de données d'application, une seule compagnie et les données qui seront dans la table compagnie. Ces exemples ne montre pas le pouvoir de SDO ou de DAS Relationnel et bien sûr les mêmes résultats peuvent être atteints plus économiquement à l'aide de requêtes SQL directes mais ces exemples sont pour vous montrer comment fonctionne le DAS Relationnel.

Pour ce simple scénario, il serait possible de simplifier les méta-données de base de données pour inclure juste la table de compagnie - si cela était fait, le deuxième et troisième argument du constructeur et le spécificateur de colonne utilisé dans l'exemple de requête deviendrait optionnel.

Exemple 1. Création d'un objet de données Le plus simple exemple est de créer un objet de données simple et de l'écrire à la base de données. Dans cet exemple, un objet simple de compagnie est créé, son nom est fixé à 'Acme' et le DAS Relationnel est appelé pour écrire les changements à la base de données. Le nom de la compagnie est fixé ici en utilisant la méthode de propriété de nom. Voyez la section d'exemples sur l'extension SDO pour d'autres moyens d'accéder au propriétés d'un objet. Les objets de données peuvent seulement être créés lorsque vous avez un objet de données au démarrage. C'est pour cette raison que le premier appel à DAS Relationnel ici est pour obtenir l'objet racine. C'est en effet comment demander pour un graphique de données vide - l'objet de racine spécial est la vrai racine de l'arbre. L'objet de données compagnie est alors créé avec l'appel à createDataObject() sur l'objet racine. Ceci crée l'objet de données compagnie et l'insère dans le graphique en insérant une propriété de valeurs multiples contenue dans l'objet racine appelé 'compagnie'. Lorsque DAS Relationnel est appelé pour effectuer les changements, une simple requête d'insertion 'INSERT INTO compagnie (nom} VALUES ("Acme");' sera construite et exécutée. La clé primaire générée automatiquement sera fixée dans l'objet de données et le changement sera effacé, alors il serait possible de continuer de travailler avec le même objet de données, le modifier, et applique les nouveaux changements une deuxième fois. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Construit le DAS avec les méta-données ***************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); /************************************************************** * Obtient l'objet racine et crée un objet compagnie dessous. * Effectue un petit changement à l'objet de données. ***************************************************************/ $root = $das  -> createRootDataObject(); $acme = $root -> createDataObject('compagnie'); $acme->name = "Acme"; /************************************************************** * Récupère la connexion à la base de données et écrit l'objet à la base de données ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $das -> applyChanges($dbh, $root); ?>

Exemple 2. Récupération d'un objet de données Dans cet exemple, un simple objet de données est récupéré de la base de données - ou possiblement plus d'un s'il y avait plus d'une compagnie qui était appelée 'Acme'. Pour chaque compagnie retournée, les propriétés nom et id sont affichées. Dans cet exemple, le troisième argument de executeQuery(), le spécificateur de colonne est requis puisqu'il y a d'autres tables dans les méta-données avec le nom de colonne nom et id. S'il n'y avait pas d'ambiguïté possible, il aurait pu être omis. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Construit le DAS avec les méta-données ***************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); /************************************************************** * Récupère la connexion à la base de données ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); /************************************************************** * Effectue une requête pour obtenir un objet compagnie - possiblement * plusieurs s'ils existent ***************************************************************/ $root = $das->executeQuery($dbh,            'select nom, id from compagnie where nom="Acme"',             array('compagnie.nom', 'compagnie.id') );             /************************************************************** * Affiche le nom et le id ***************************************************************/ foreach ($root['compagnie'] as $compagnie) {     echo "La compagnie obtenue de la base de données a le nom = " .     $compagnie['nom'] . " et un id " . $compagnie['id'] . "\n"; } ?>

Exemple 3. Mise à jour d'objet de données Cet exemple combine les deux précédent, dans le sens que pour être mis à jour, l'objet doit être premièrement récupéré. L'application renverse le nom de compagnie (alors 'Acme' devient 'emcA') et alors les changements sont écrits à la base de données de la même manière qu'ils étaient lorsque l'objet avait été créé. Puisque la requête cherche pour le nom, on peut chercher des deux manières le nom à plusieurs reprises pour trouver la compagnie et renverser son nom chaque fois. Dans cet exemple, la même instance de DAS Relationnel est réutilisée pour applyChanges(), avec le descripteur de base de données PDO. Ceci est tout à fait correcte; il est aussi possible d'autoriser les instances précédentes d'être ramassées par le ramasse-miettes et d'obtenir de nouvelles instances. Aucune données d'état concernant le graphique n'est tenue par le DAS Relationnel une fois qu'il a retourné un graphique de données à l'application. Toutes les données nécessaires sont soit dans le graphique ou peuvent être reconstruites à partir des méta-données. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Construit le DAS avec les méta-données ***************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); /************************************************************** * Récupère la connexion à la base de données ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); /************************************************************** * Effectue une requête pour obtenir un objet compagnie - possiblement * plusieurs s'ils existent ***************************************************************/ $root = $das->executeQuery($dbh,     'select nom, id from compagnie where nom="Acme" or nom="emcA"',     array('compagnie.nom', 'compagnie.id') ); /************************************************************** * Modifie le nom de la première compagnie seulement ***************************************************************/ $compagnie = $root['compagnie'][0]; echo "Compagnie obtenue avec le nom " . $compagnie->nom . "\n"; $compagnie->nom = strrev($compagnie->nom); /************************************************************** * Écriture du changement ***************************************************************/ $das->applyChanges($dbh,$root); ?>

Exemple 4. Suppression d'un objet de données Toutes compagnies appelées 'Acme' ou son inverse 'emcA' sont récupérées. Elles sont ensuite toutes supprimées du graphique avec unset. Dans l'exemple, elles sont toutes supprimées en un seul coup en supprimant la propriété contenue (la propriété définissant la relation contenue). Il est aussi possible de les supprimer individuellement. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Construit le DAS avec les méta-données ***************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); /************************************************************** * Récupère la connexion à la base de données ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); /************************************************************** * Effectue une requête pour obtenir un objet compagnie - possiblement * plusieurs s'ils existent ***************************************************************/ $root = $das->executeQuery($dbh,     'select nom, id from compagnie where nom="Acme" or nom="emcA"',     array('company.name', 'company.id') ); /************************************************************** * Supprime les compagnies trouvées du graphique de données ***************************************************************/ unset($root['compagnie']); /************************************************************** * Écrit le(s) changement(s) ***************************************************************/ $das->applyChanges($dbh,$root); ?>

Exemples avec deux tables

Les exemples suivants utilisent tous deux tables de la base de données compagnie : les tables compagnie et departement. Ces exemples montrent plus le fonctionnement de DAS Relationnel.

Dans cette série d'exemples, une compagnie et un département son créé, récupéré, mis à jour et finalement supprimé. Ceci montre le cycle de vie pour un graphique de données contenant plus d'un objet. Notez que cet exemple vide les tables compagnie et departement au démarrage, ainsi les résultats exacts des requêtes peuvent être connus.

Vous pouvez trouvez ces exemples combinés dans un script appelé 1cd-CRUD dans le répertoire Scenarios du paquetage DAS Relationnel.

Exemple 5. Une compagnie, un département - Création Comme dans l'exemple précédent où l'on créait juste un objet de données de compagnie, la première action après la construction du DAS Relationnel est d'appeler createRootDataObject() pour obtenir l'objet racine spécial du graphique de données vide. L'objet compagnie est alors créé en tant que fils de cet objet racine, et l'objet departement en tant que fils de l'objet compagnie. Lorsqu'il est venu le temps d'appliquer les changements, le DAS Relationnel doit effectuer des traitements spéciaux pour maintenir la clé étrangère qui supporte les relations contenues, en particulier si une clé primaire générée automatiquement est en jeu. Dans cet exemple, les relations entre la clé primaire générée automatiquement id dans la table compagnie et la colonne co_id dans la table departement doivent être maintenues. Lors de l'insertion de la compagnie et du département pour la première fois, le DAS Relationnel doit premièrement insérer une ligne de compagnie, ensuite appeler la méthode de PDO getLastInsertId() pour obtenir la clé primaire générée automatiquement, et ensuite ajouter la valeur à la colonne co_id lors de l'insertion de la ligne departement. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************************************* * Vidage des deux tables *************************************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $pdo_stmt = $dbh->prepare('DELETE FROM COMPAGNIE;'); $rows_affected = $pdo_stmt->execute(); $pdo_stmt = $dbh->prepare('DELETE FROM DEPARTEMENT;'); $rows_affected = $pdo_stmt->execute(); /************************************************************** * Crée une compagnie avec le nom Acme et un département, département de Chaussure ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $root = $das -> createRootDataObject(); $acme = $root -> createDataObject('compagnie'); $acme -> nom = "Acme"; $chaussure = $acme->createDataObject('departement'); $chaussure->nom = 'Chaussure'; $das -> applyChanges($dbh, $root); ?>

Exemple 6. Une compagnie, un département - Récupération et Mise à jour Dans ce cas, la requête SQL passé à executeQuery() exécute un inner join pour joindre les données des tables compagnie et departement. Les clés primaires pour les tables compagnie et departement doivent être incluses dans la requête. Le jeu de résultats est normalisé de nouveau pour former un graphique de données normalisé. Notez que le spécificateur de colonne est passé en troisième argument de l'appel executeQuery() qui autorise DAS Relationnel de savoir quelle colonne est laquelle dans le jeu de résultats. Notez que la colonne co_id bien qu'utilisée dans la requête n'est pas requis dans le jeu de résultats. Afin de comprendre que fait DAS Relationnel lorsqu'il construit le graphique de données, il peut être utile de visualiser à quoi ressemble les jeu de résultats. Bien que les données dans la base de données sont normalisée, alors plusieurs lignes de département peuvent pointer vers la clé étrangère d'une ligne de compagnie, les données dans le jeu de résultats sont non-normalisée : c'est, s'il y a une compagnie et de multiples département, les valeurs pour la compagnie qui sont répétées à chaque ligne. Le DAS Relationnel doit renverser ce processus et retourner le jeu de résultats dans un graphique normalisé, avec seulement un objet compagnie. Dans cet exemple, le DAS Relationnel examine le jeu de résultats et le spécificateur de colonne, trouve les données pour les tables compagnie et departement, trouve les clés primaires pour les deux et interprète chaque ligne comme contenant des données d'un département et comme parent compagnie. S'il n'a pas vue de données de la compagnie auparavant (il utilise la clé primaire pour vérifier), il crée un objet compagnie et ensuite l'objet compagnie sous lui. S'il a vu des données pour la compagnie avant et a déjà créé l'objet compagnie, il crée simplement l'objet departement sous lui. De cette manière, le DAS Relationnel peut récupérer et normaliser de nouveau les données pour de multiples compagnies et de multiples départements sous ceux-ci. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Récupération de la compagnie et du département de Chaussure, ensuite * supprime Chaussure et ajoute IT ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $root = $das->executeQuery($dbh, 'select c.id, c.nom, d.id, d.nom from compagnie «c, departement d where d.co_id = c.id', array('compagnie.id','compagnie.nom','departement.id','departement.nom')); $acme      = $root['compagnie'][0];            // récupère la première compagnie - sera 'Acme' $chaussure = $acme['departement'][0];          // récupère le premier département en dessous - sera 'Chaussure' unset($acme['departement'][0]); $it = $acme->createDataObject('departement'); $it->name = 'IT'; $das -> applyChanges($dbh, $root); ?>

Exemple 7. Une compagnie, deux départements - Récupération et Suppression Dans cet exemple, la compagnie et le département sont récupérés et ensuite supprimés. Il n'est pas nécessaire de les supprimer individuellement (bien que cela est possible) - la suppression de l'objet compagnie du graphique de données supprime aussi tous les départements sous lui. Notez le moyen de l'objet compagnie est actuellement supprimé en utilisant l'appel unset de PHP. La suppression doit être effectuée sur la propriété qui est dans ce cas la propriété de compagnie sur l'objet racine spécial. Vous devez utiliser : <?php unset($root['compagnie'][0]); ?> et non pas : <?php unset($acme); // FAUX ?> La suppression de $acme détruira simplement la variable mais laissera les données dans le graphique intacte. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************** * Récupération de la compagnie et du département IT, ensuite supprime la * compagnie entière ***************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $root = $das->executeQuery($dbh, 'select c.id, c.nom, d.id, d.nom from compagnie c, departement d where d.co_id = c.id', array('compagnie.id','compagnie.nom','departement.id','departement.nom')); $acme = $root['compagnie'][0]; $it = $acme['departement'][0]; unset($root['compagnie'][0]); $das -> applyChanges($dbh, $root); ?>

Exemple avec trois tables

Les exemples suivant utilisent tous trois tables de la base de données compagnie : les tables compagnie, departement et employe. Elles introduisent le dernier morceau du fonctionnement non expliqué dans les exemples ci haut : la référence non contenue employe_du_mois.

Comme les exemples ci haut pour la compagnie et le département, la série d'exemples illustre le cycle de vie complet d'un graphique de données.

Exemple 8. Une compagnie, un département, un employé - Création Dans cet exemple, une compagnie est créée contenant un département et seulement un employé. Notez que dans cet exemple, les trois tables sont vidées à leur démarrage ainsi les résultats exacts des requêtes peuvent être connus. Notez comment une fois que la compagnie, le département et l'employé est créé que la propriété employe_du_mois de la compagnie peut être faite pour pointer au nouvel employé. Puisque c'est une référence qui n'est pas contenue, ceci ne peut être effectué tant que l'objet employé ait été créé dans le graphique. Les références non contenues doivent être gérées prudemment. Par exemple, si un employé est maintenant supprimé de son département, il ne serait pas correcte d'essayer de sauver le graphique sans premièrement effacer ou réassigner la propriété employe_du_mois . Cette règle des graphiques de données SDO requière que tous les objets pointé par une référence qui n'est pas contenue doit être aussi accessible par des relations contenues. Lorsque vient le moment d'insérer le graphique dans la base de données, la procédure est similaire à l'exemple d'insertion d'une compagnie et d'un département, cependant, la propriété employe_du_mois introduit une plus grande complexité. Le DAS Relationnel doit insérer les objets en descendant l'arbre formée des relations contenues, donc la compagnie, ensuite le département et ensuite l'employée. Ceci est nécessaire puisqu'il y a toujours une clé primaire générée automatiquement du parent pour l'inclure dans une ligne du fils. Mais lorsque la compagnie est insérée, l'employée qui est l'employé du mois n'est pas encore inséré et la clé primaire est inconnue. La procédure est qu'après l'insertion de l'employé et que sa clé primaire soit connue, une dernière étape est effectuée qui permet de modifier la compagnie avec la clé primaire de l'employé. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************************************* * Vidage des deux tables *************************************************************************************/ $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $pdo_stmt = $dbh->prepare('DELETE FROM COMPAGNIE;'); $rows_affected = $pdo_stmt->execute(); $pdo_stmt = $dbh->prepare('DELETE FROM DEPARTEMENT;'); $rows_affected = $pdo_stmt->execute(); $pdo_stmt = $dbh->prepare('DELETE FROM EMPLOYE;'); $rows_affected = $pdo_stmt->execute(); /************************************************************************************* * Crée une compagnie minuscule mais complète. * Le nom de la compagnie est Acme. * Il y a un département, Chaussure. * Il y a une employé, Bob. * L'employé du mois est Bob. *************************************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $root                      = $das  -> createRootDataObject(); $acme                      = $root -> createDataObject('compagnie'); $acme -> nom         = "Acme"; $chaussure                 = $acme -> createDataObject('departement'); $chaussure -> nom    = 'Chaussure'; $chaussure -> emplacement = 'Bloc-A'; $bob                       = $chaussure -> createDataObject('employe'); $bob -> nom          = 'Bob'; $acme -> employe_du_mois = $bob; $das -> applyChanges($dbh, $root); echo "Écriture de Acme avec un département et un employé\n"; ?>

Exemple 9. Une compagnie, un département, un employé - Récupération et Mise à Jour La requête SQL passée à DAS Relationnel est cette fois un inner join qui récupère les données des trois tables. Autrement, cet exemple n'introduit rien de nouveau de l'exemple précédent Le graphique est mis à jour avec l'addition d'un nouveau département et d'un nouvel employé et quelques modifications au propriétés de nom des objets existant dans le graphique. Les changements combinés sont écrits. Le DAS Relationnel traitera et appliquera un mélange arbitraire des additions, des modifications et des suppressions provenant et allant vers le graphique. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************************************* * Trouve la compagnie encore et change certains aspects. * Change le nom de la compagnie, le département et l'employé. * Ajoute un second département et un nouvel employé. * Change l'employé du mois *************************************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $root = $das->executeQuery($dbh,     "select c.id, c.nom, c.employe_du_mois, d.id, d.nom, e.id, e.nom " .     "from compagnie c, departement d, employe e " .     "where e.dept_id = d.id and d.co_id = c.id and c.nom='Acme'",      array('compagnie.id','compagnie.nom','compagnie.employe_du_mois',      'departement.id','departement.nom','employe.id','employe.nom')); $acme     = $root['compagnie'][0]; $chaussure    = $acme->departement[0]; $bob          = $chaussure -> employe[0]; $it     = $acme->createDataObject('departement'); $it->nom = 'IT'; $it->location = 'Bloc-G'; $billy     = $it->createDataObject('employe'); $billy->nom = 'Billy'; $acme->nom = 'MegaCorp'; $chaussure->nom = 'Footwear'; $sue->nom = 'Suzan'; $acme->employe_du_mois = $billy; $das -> applyChanges($dbh, $root); echo "Écriture de la compagnie avec un département en plus et un employé et tous les noms ont changés Megacorp/Footwear/Suzan)\n"; ?>

Exemple 10. Une compagnie, deux départements, deux employés - Récupération et Suppression La compagnie est récupéré en tant qu'un graphique de données complet contenant cinq objets de données - la compagnie, deux départements et deux employés. Ils sont tous supprimés en supprimant l'objet compagnie. La suppression d'un objet du graphique supprime tous les objets sous celui-ci dans le graphique. Cinq requêtes DELETE SQL sera générées et exécutée. Comme d'habitude, elles seront qualifiées avec une clause WHERE qui contient tous les champs qui ont été récupérés, alors toutes les mises à jour des données dans la base de données pendant ce temps par un autre processus seront détectées. <?php require_once 'SDO/DAS/Relational.php'; require_once 'company_metadata.inc.php'; /************************************************************************************* * Maintenant lit une ou plusieurs fois et supprime. * Vous pouvez supprimer par partie, appliquer les changements, et ensuite * continuer à travailler avec le même graphique de données mais la précaution * est requise pour garder véracité - vous ne pouvez pas supprimer l'employé * qui est l'employé du mois sans le réassigner. Pour plus de précaution ici, * nous supprimons la compagnie en entier d'un seul coup. *************************************************************************************/ $das = new SDO_DAS_Relational ($database_metadata,'compagnie',$SDO_containment_metadata); $dbh = new PDO(PDO_DSN,DATABASE_USER,DATABASE_PASSWORD); $root = $das->executeQuery($dbh,     "select c.id, c.nom, c.employe_du_mois, d.id, d.nom, e.id, e.nom " .     "from compagnie c, departement d, employe e " .     "where e.dept_id = d.id and d.co_id = c.id and c.nom='MegaCorp';",      array('compagnie.id','compagnie.nom','compagnie.employe_du_mois',      'departement.id','departement.nom','employe.id','employe.nom')); $megacorp = $root['compagnie'][0]; unset($root['compagnie']); $das -> applyChanges($dbh, $root); echo "Suppression de la compagnie, des départements et des employés d'un seul coup.\n"; ?>

SDO_DAS_Relational

Le seul autre objet que SDO_DAS_Relational_Exception que l'application pourrait interagir.

SDO_DAS_Relational_Exception

Est une sous-classe de la classe PHP Exception. Elle n'ajoute aucun comportement à Exception. Jetée, avec une explication utile, pour signaler les erreurs dans les méta-données ou des échecs non prévus pour exécuter des opérations SQL.