cvs: phpdoc-fr /reference/pdo book.xml connections.xml drivers.xml error-handling.xml lobs.xml pdo.xml pdoexception.xml pdostatement.xml
prepared-statements.xml setup.xml transactions.xml

From: Date: Sat, 27 Dec 2008 18:40:49 +0000
Subject: cvs: phpdoc-fr /reference/pdo book.xml connections.xml drivers.xml error-handling.xml lobs.xml pdo.xml pdoexception.xml pdostatement.xml
prepared-statements.xml setup.xml transactions.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-6178@lists.php.net to get a copy of this message
yannick Sat Dec 27 18:40:49 2008 UTC Modified files: /phpdoc-fr/reference/pdo book.xml connections.xml drivers.xml error-handling.xml lobs.xml pdoexception.xml pdostatement.xml pdo.xml prepared-statements.xml setup.xml transactions.xml Log: fix encoding

http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/book.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/book.xml diff -u phpdoc-fr/reference/pdo/book.xml:1.2 phpdoc-fr/reference/pdo/book.xml:1.3 --- phpdoc-fr/reference/pdo/book.xml:1.2 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pdo/book.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: database.abstract --> @@ -13,28 +13,28 @@ <preface xml:id="intro.pdo"> &reftitle.intro; <para> - L'extension <acronym>PHP Data Objects</acronym> (PDO) définit - une excellente interface pour accéder à une base de données depuis PHP. - Chaque pilote de base de données implémenté dans l'interface PDO peut utiliser - des fonctionnalités spécifiques de chacune des bases de données + L'extension <acronym>PHP Data Objects</acronym> (PDO) définit + une excellente interface pour accéder à une base de données depuis PHP. + Chaque pilote de base de données implémenté dans l'interface PDO peut utiliser + des fonctionnalités spécifiques de chacune des bases de données en utilisant des extensions de fonctions. Notez que vous ne pouvez - exécuter aucune fonction de base de données en utilisant l'extension PDO - par elle-même ; vous devez utiliser un <link linkend="pdo.drivers">driver - PDO spécifique à la base de données</link> pour accéder au serveur de base - de données. + exécuter aucune fonction de base de données en utilisant l'extension PDO + par elle-même ; vous devez utiliser un <link linkend="pdo.drivers">driver + PDO spécifique à la base de données</link> pour accéder au serveur de base + de données. </para> <para> - PDO fournit une interface d'abstraction à l'accès de données, ce qui signifie que vous utilisez - les mêmes fonctions pour exécuter des requêtes ou récupérer les données quelque - soit la base de données utilisée. PDO ne fournit <emphasis>pas</emphasis> - une abstraction de base de données : il ne réécrit pas le SQL, n'émule pas des fonctionnalités - manquantes. Vous devriez utiliser une interface d'abstraction complète si vous avez + PDO fournit une interface d'abstraction à l'accès de données, ce qui signifie que vous utilisez + les mêmes fonctions pour exécuter des requêtes ou récupérer les données quelque + soit la base de données utilisée. PDO ne fournit <emphasis>pas</emphasis> + une abstraction de base de données : il ne réécrit pas le SQL, n'émule pas des fonctionnalités + manquantes. Vous devriez utiliser une interface d'abstraction complète si vous avez besoin de cela. </para> <para> PDO est fournit avec PHP 5.1 et est disponible en tant qu'extension PECL pour PHP 5.0 ; - PDO requiert les nouvelles fonctionnalités OO fournies par PHP 5 et donc, ne fonctionne - pas avec les versions antérieures de PHP. + PDO requiert les nouvelles fonctionnalités OO fournies par PHP 5 et donc, ne fonctionne + pas avec les versions antérieures de PHP. </para> </preface> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/connections.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/connections.xml diff -u phpdoc-fr/reference/pdo/connections.xml:1.2 phpdoc-fr/reference/pdo/connections.xml:1.3 --- phpdoc-fr/reference/pdo/connections.xml:1.2 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pdo/connections.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> @@ -7,15 +7,15 @@ <chapter xml:id="pdo.connections" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Connexions et gestionnaire de connexion</title> <para> - Les connexions sont établies en créant des instances de la classe de base de PDO. + Les connexions sont établies en créant des instances de la classe de base de PDO. Peut importe quel driver vous voulez utiliser ; vous utilisez toujours le nom - de la classe PDO. Le constructeur accepte des paramètres pour spécifier - la source de la base de données (connue en tant que DSN) et optionnellement, + de la classe PDO. Le constructeur accepte des paramètres pour spécifier + la source de la base de données (connue en tant que DSN) et optionnellement, le nom d'utilisateur et le mot de passe (s'il y en a un). </para> <para> <example> - <title>Connexion à MySQL</title> + <title>Connexion à MySQL</title> <programlisting role='php'> <![CDATA[ <?php @@ -27,8 +27,8 @@ </para> <para> S'il y a des erreurs de connexion, un objet <literal>PDOException</literal> - est lancé. Vous pouvez attraper cette exception si vous voulez gérer - cette erreur, ou laisser le gestionnaire global d'exception défini + est lancé. Vous pouvez attraper cette exception si vous voulez gérer + cette erreur, ou laisser le gestionnaire global d'exception défini via la fonction <function>set_exception_handler</function> la traiter. </para> <para> @@ -54,21 +54,21 @@ </para> <warning> <para> - Si votre application n'attrape pas les exceptions lancées depuis le constructeur PDO, - l'action par défaut du moteur zend est de terminer le script et d'afficher une trace. - Cette trace devrait révéler des détails complets sur la connexion à la base de données, - incluant le nom d'utilisateur et le mot de passe. Il en est donc de votre responsabilité + Si votre application n'attrape pas les exceptions lancées depuis le constructeur PDO, + l'action par défaut du moteur zend est de terminer le script et d'afficher une trace. + Cette trace devrait révéler des détails complets sur la connexion à la base de données, + incluant le nom d'utilisateur et le mot de passe. Il en est donc de votre responsabilité d'attraper cette exception, soit explicitement (via l'instruction <literal>catch</literal>) ou implicitement via la fonction <function>set_exception_handler</function>. </para> </warning> <para> - Lorsque la connexion à la base de données a réussi, une instance de la classe - PDO est retournée à votre script. La connexion est active tant que l'objet PDO - l'est. Pour clore la connexion, vous devez détruire l'objet en vous assurant que - toutes ses références sont effacées. Vous pouvez faire cela en assignant &null; - à la variable gérant l'objet. Si vous ne le faites pas explicitement, PHP fermera - automatiquement la connexion lorsque le script arrivera à la fin. + Lorsque la connexion à la base de données a réussi, une instance de la classe + PDO est retournée à votre script. La connexion est active tant que l'objet PDO + l'est. Pour clore la connexion, vous devez détruire l'objet en vous assurant que + toutes ses références sont effacées. Vous pouvez faire cela en assignant &null; + à la variable gérant l'objet. Si vous ne le faites pas explicitement, PHP fermera + automatiquement la connexion lorsque le script arrivera à la fin. </para> <para> <example> @@ -89,11 +89,11 @@ </para> <para> Beaucoup d'applications web utilisent des connexions persistantes aux serveurs - de base de données. Les connexions persistantes ne sont pas fermées à la fin du - script, mais sont mises en cache et réutilisées lorsqu'un autre script demande une connexion - en utilisant les mêmes paramètres. Le cache des connexions persistantes - vous permet d'éviter d'établir une nouvelle connexion à chaque fois qu'un - script doit accéder à une base de données, rendant l'application web plus rapide. + de base de données. Les connexions persistantes ne sont pas fermées à la fin du + script, mais sont mises en cache et réutilisées lorsqu'un autre script demande une connexion + en utilisant les mêmes paramètres. Le cache des connexions persistantes + vous permet d'éviter d'établir une nouvelle connexion à chaque fois qu'un + script doit accéder à une base de données, rendant l'application web plus rapide. </para> <para> <example> @@ -113,21 +113,21 @@ <para> Si vous souhaitez utiliser des connexions persistantes, vous devez utiliser la valeur <constant>PDO::ATTR_PERSISTENT</constant> dans le - le tableau des options du driver passé au constructeur PDO. Si vous - définissez cet attribut avec la méthode <function>PDO::setAttribute</function> - après l'instanciation de l'objet, le driver n'utilisera pas les connexions + le tableau des options du driver passé au constructeur PDO. Si vous + définissez cet attribut avec la méthode <function>PDO::setAttribute</function> + après l'instanciation de l'objet, le driver n'utilisera pas les connexions persistantes. </para> </note> <note> <para> - Si vous utilisez le driver PDO ODBC et que votre bibliothèque ODBC supporte + Si vous utilisez le driver PDO ODBC et que votre bibliothèque ODBC supporte le pool de connexion ODBC (unixODBC et Windows le supportent tous les deux ; - peut être plus), alors il est recommandé de ne pas utiliser les connexions persistantes - PDO mais plutôt laisser le pool de connexion ODBC mettre en cache les connexions. - Le pool de connexion ODBC est partagé avec les autres modules dans le processus ; - si PDO met en cache la connexion, alors cette connexion ne sera jamais retournée - par le pool de connexion ODBC, faisant que plusieurs connexions sont créées pour + peut être plus), alors il est recommandé de ne pas utiliser les connexions persistantes + PDO mais plutôt laisser le pool de connexion ODBC mettre en cache les connexions. + Le pool de connexion ODBC est partagé avec les autres modules dans le processus ; + si PDO met en cache la connexion, alors cette connexion ne sera jamais retournée + par le pool de connexion ODBC, faisant que plusieurs connexions sont créées pour les autres modules. </para> </note> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/drivers.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/drivers.xml diff -u phpdoc-fr/reference/pdo/drivers.xml:1.2 phpdoc-fr/reference/pdo/drivers.xml:1.3 --- phpdoc-fr/reference/pdo/drivers.xml:1.2 Sat Jun 28 13:35:57 2008 +++ phpdoc-fr/reference/pdo/drivers.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <!-- Purpose: database.abstract --> @@ -10,14 +10,14 @@ <partintro> <para> - Les pilotes suivants (<literal>driver</literal>) sont actuellement implémentés + Les pilotes suivants (<literal>driver</literal>) sont actuellement implémentés dans l'interface PDO : <informaltable> <tgroup cols='2'> <thead> <row> <entry>Nom du driver</entry> - <entry>Bases de données supportées</entry> + <entry>Bases de données supportées</entry> </row> </thead> <tbody> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/error-handling.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/pdo/error-handling.xml diff -u phpdoc-fr/reference/pdo/error-handling.xml:1.4 phpdoc-fr/reference/pdo/error-handling.xml:1.5 --- phpdoc-fr/reference/pdo/error-handling.xml:1.4 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pdo/error-handling.xml Sat Dec 27 18:40:48 2008 @@ -1,13 +1,13 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> <!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="pdo.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Les erreurs et leur gestion</title> <para> - PDO vous offre 3 façon différentes de gérer les erreurs afin de mieux - s'adapter à votre application. + PDO vous offre 3 façon différentes de gérer les erreurs afin de mieux + s'adapter à votre application. </para> <itemizedlist> <listitem> @@ -15,15 +15,15 @@ <constant>PDO::ERRMODE_SILENT</constant> </para> <para> - C'est le mode par défaut. PDO définit simplement le code erreur à inspecter - grâce aux méthodes <function>PDO::errorCode</function> et - <function>PDO::errorInfo</function> sur les objets représentant - les requêtes mais aussi ceux représentant les bases de données ; si l'erreur - résulte d'un appel à l'objet représentant la requête, vous pouvez appeler - la méthode <function>PDOStatement::errorCode</function> ou la méthode + C'est le mode par défaut. PDO définit simplement le code erreur à inspecter + grâce aux méthodes <function>PDO::errorCode</function> et + <function>PDO::errorInfo</function> sur les objets représentant + les requêtes mais aussi ceux représentant les bases de données ; si l'erreur + résulte d'un appel à l'objet représentant la requête, vous pouvez appeler + la méthode <function>PDOStatement::errorCode</function> ou la méthode <function>PDOStatement::errorInfo</function> sur l'objet. - Si l'erreur résulte d'un appel sur l'objet représentant une base de données, - vous pouvez également appeler ces deux mêmes méthodes sur l'objet. + Si l'erreur résulte d'un appel sur l'objet représentant une base de données, + vous pouvez également appeler ces deux mêmes méthodes sur l'objet. </para> </listitem> <listitem> @@ -31,9 +31,9 @@ <constant>PDO::ERRMODE_WARNING</constant> </para> <para> - En plus de définir le code erreur, PDO émettra un message E_WARNING - traditionnel. Cette configuration est utile lors des tests et du déboguage, - si vous voulez voir le problème sans interrompre l'application. + En plus de définir le code erreur, PDO émettra un message E_WARNING + traditionnel. Cette configuration est utile lors des tests et du déboguage, + si vous voulez voir le problème sans interrompre l'application. </para> </listitem> <listitem> @@ -41,22 +41,22 @@ <constant>PDO::ERRMODE_EXCEPTION</constant> </para> <para> - En plus de définir le code erreur, PDO lancera une exception - <classname>PDOException</classname> et y définit les propriétés - afin de représenter le code erreur et les informations complémentaires. - Cette configuration est également utile lors du déboguage, car elle + En plus de définir le code erreur, PDO lancera une exception + <classname>PDOException</classname> et y définit les propriétés + afin de représenter le code erreur et les informations complémentaires. + Cette configuration est également utile lors du déboguage, car elle va "contourner" le point critique de votre code, vous montrer - rapidement le problème rencontré (souvenez-vous : les transactions - sont automatiquement annulées si l'exception fait que votre script + rapidement le problème rencontré (souvenez-vous : les transactions + sont automatiquement annulées si l'exception fait que votre script se termine). </para> <para> - Le mode "exception" est également très utile car ainsi, vous pouvez + Le mode "exception" est également très utile car ainsi, vous pouvez structurer votre gestionnaire d'erreur plus clairement qu'avec les alertes traditionnelles PHP et, ce, avec moins de code que - lorsque vous exécutez votre code en mode silence, et que vous - vérifiez systématiquement les valeurs retournées après chaque appel - à la base de données. + lorsque vous exécutez votre code en mode silence, et que vous + vérifiez systématiquement les valeurs retournées après chaque appel + à la base de données. </para> <para> Voir le chapitre sur les <link linkend='language.exceptions'>exceptions</link> @@ -66,12 +66,12 @@ </itemizedlist> <para> PDO utilise les codes erreurs SQL-92 SQLSTATE ; chaque driver PDO est - responsable de lier leurs codes natifs aux codes SQLSTATE appropriés. - La méthode <function>PDO::errorCode</function> retourne un code - SQLSTATE unique. Si vous avez besoin d'informations spécifiques sur - l'erreur, PDO vous propose également la méthode <function>PDO::errorInfo</function> - qui retourne un tableau contenant le code SQLSTATE, le code erreur spécifique - du driver et la chaîne décrivant l'erreur provenant du driver. + responsable de lier leurs codes natifs aux codes SQLSTATE appropriés. + La méthode <function>PDO::errorCode</function> retourne un code + SQLSTATE unique. Si vous avez besoin d'informations spécifiques sur + l'erreur, PDO vous propose également la méthode <function>PDO::errorInfo</function> + qui retourne un tableau contenant le code SQLSTATE, le code erreur spécifique + du driver et la chaîne décrivant l'erreur provenant du driver. </para> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/lobs.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/pdo/lobs.xml diff -u phpdoc-fr/reference/pdo/lobs.xml:1.3 phpdoc-fr/reference/pdo/lobs.xml:1.4 --- phpdoc-fr/reference/pdo/lobs.xml:1.3 Sat Jun 28 13:35:57 2008 +++ phpdoc-fr/reference/pdo/lobs.xml Sat Dec 27 18:40:48 2008 @@ -1,33 +1,33 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> <!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="pdo.lobs" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Les objets larges (LOBs)</title> <para> - À un moment dans votre application, vous pourriez avoir besoin de stocker de - larges données dans votre base de données. "Large" signifie typiquement - des données d'environ 4 ko ou plus, bien que certaines bases de données peuvent - gérer plus de 32 ko avant que les données deviennent "larges". Les objets larges - peuvent être de nature textuelle ou binaire. PDO vous permet de travailler - avec ce type de larges données en utilisant le code type + À un moment dans votre application, vous pourriez avoir besoin de stocker de + larges données dans votre base de données. "Large" signifie typiquement + des données d'environ 4 ko ou plus, bien que certaines bases de données peuvent + gérer plus de 32 ko avant que les données deviennent "larges". Les objets larges + peuvent être de nature textuelle ou binaire. PDO vous permet de travailler + avec ce type de larges données en utilisant le code type <constant>PDO::PARAM_LOB</constant> dans vos appels aux fonctions <function>PDOStatement::bindParam</function> ou <function>PDOStatement::bindColumn</function>. - <constant>PDO::PARAM_LOB</constant> demande à PDO de mapper les données + <constant>PDO::PARAM_LOB</constant> demande à PDO de mapper les données en un flux que vous pourrez manipuler en utilisant l'<link linkend='ref.stream'>API PHP sur les flux</link>. </para> <para> <example> - <title>Affichage d'une image depuis une base de données</title> + <title>Affichage d'une image depuis une base de données</title> <para> - Cet exemple lie un LOB dans une variable nommée $lob et l'envoie + Cet exemple lie un LOB dans une variable nommée $lob et l'envoie au navigateur en utilisant la fonction <function>fpassthru</function>. - Étant donné qu'un LOB est représenté en un flux, les fonctions comme + Étant donné qu'un LOB est représenté en un flux, les fonctions comme <function>fgets</function>, <function>fread</function> et - <function>stream_get_contents</function> peuvent être utilisées sur ce flux. + <function>stream_get_contents</function> peuvent être utilisées sur ce flux. </para> <programlisting role='php'> <![CDATA[ @@ -48,12 +48,12 @@ </para> <para> <example> - <title>Insertion d'une image dans une base de données</title> + <title>Insertion d'une image dans une base de données</title> <para> - Cet exemple ouvre un fichier et passe le pointeur de fichier à PDO - pour l'insérer en tant que LOB. PDO fera son possible pour récupérer - le contenu du fichier et l'insérer dans la base de données de la - manière la plus efficace possible. + Cet exemple ouvre un fichier et passe le pointeur de fichier à PDO + pour l'insérer en tant que LOB. PDO fera son possible pour récupérer + le contenu du fichier et l'insérer dans la base de données de la + manière la plus efficace possible. </para> <programlisting role='php'> <![CDATA[ @@ -62,8 +62,8 @@ $stmt = $db->prepare("insert into images (id, contenttype, imagedata) values (?, ?, ?)"); $id = get_new_id(); // fonction pour allouer un nouvel ID -// assumons que nous récupérons un fichier depuis un formulaire -// vous pouvez trouver plus de détails dans la documentation de PHP +// assumons que nous récupérons un fichier depuis un formulaire +// vous pouvez trouver plus de détails dans la documentation de PHP $fp = fopen($_FILES['file']['tmp_name'], 'rb'); @@ -81,12 +81,12 @@ </para> <para> <example> - <title>Insertion d'une image dans une base de données Oracle</title> + <title>Insertion d'une image dans une base de données Oracle</title> <para> - Oracle requiert une syntaxe légèrement différente pour y insérer un LOB - depuis un fichier. Il est également essentiel d'effectuer votre insertion - au sein d'une transaction, sinon, votre nouveau LOB sera inséré - avec une longueur de zéro : + Oracle requiert une syntaxe légèrement différente pour y insérer un LOB + depuis un fichier. Il est également essentiel d'effectuer votre insertion + au sein d'une transaction, sinon, votre nouveau LOB sera inséré + avec une longueur de zéro : </para> <programlisting role='php'> <![CDATA[ @@ -96,8 +96,8 @@ "VALUES (?, ?, EMPTY_BLOB()) RETURNING imagedata INTO ?"); $id = get_new_id(); // fonction pour allouer un nouvel ID -// assumons que nous récupérons un fichier depuis un formulaire -// vous pouvez trouver plus de détails dans la documentation de PHP +// assumons que nous récupérons un fichier depuis un formulaire +// vous pouvez trouver plus de détails dans la documentation de PHP $fp = fopen($_FILES['file']['tmp_name'], 'rb'); http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdoexception.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/pdoexception.xml diff -u phpdoc-fr/reference/pdo/pdoexception.xml:1.2 phpdoc-fr/reference/pdo/pdoexception.xml:1.3 --- phpdoc-fr/reference/pdo/pdoexception.xml:1.2 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pdo/pdoexception.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> @@ -13,7 +13,7 @@ <section xml:id="pdoexception.intro"> &reftitle.intro; <para> - Représente une erreur émise par PDO. Vous ne devez pas lancer + Représente une erreur émise par PDO. Vous ne devez pas lancer une exception <classname>PDOException</classname> depuis votre propre code. Voir le chapitre sur les <link linkend='language.exceptions'>exceptions</link> @@ -43,7 +43,7 @@ </classsynopsisinfo> <!-- }}} --> - <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> + <classsynopsisinfo role="comment">Propriétés</classsynopsisinfo> <fieldsynopsis><!-- {{{ errorInfo --> <modifier>public</modifier> <type>string</type> @@ -79,7 +79,7 @@ <term><varname>errorInfo</varname></term> <listitem> <para> - Correspond à <function>PDO::errorInfo</function> ou + Correspond à <function>PDO::errorInfo</function> ou <function>PDOStatement::errorInfo</function> </para> </listitem> @@ -88,16 +88,16 @@ <term><varname>message</varname></term> <listitem> <para> - Message d'erreur textuel. Utilisez la méthode - <function>Exception::getMessage</function> pour y accéder. + Message d'erreur textuel. Utilisez la méthode + <function>Exception::getMessage</function> pour y accéder. </listitem> </varlistentry><!-- }}} --> <varlistentry xml:id="pdoexception.props.code"><!-- {{{ --> <term><varname>code</varname></term> <listitem> <para> - Code erreur <literal>SQLSTATE</literal>. Utilisez la méthode - <function>Exception::getCode</function> pour y accéder. + Code erreur <literal>SQLSTATE</literal>. Utilisez la méthode + <function>Exception::getCode</function> pour y accéder. </para> </listitem> </varlistentry><!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdostatement.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/pdo/pdostatement.xml diff -u phpdoc-fr/reference/pdo/pdostatement.xml:1.1 phpdoc-fr/reference/pdo/pdostatement.xml:1.2 --- phpdoc-fr/reference/pdo/pdostatement.xml:1.1 Fri Mar 28 23:52:18 2008 +++ phpdoc-fr/reference/pdo/pdostatement.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> @@ -13,8 +13,8 @@ <section xml:id="pdostatement.intro"> &reftitle.intro; <para> - Représente une requête préparée et, une fois exécutée, le jeu de résultats - associé. + Représente une requête préparée et, une fois exécutée, le jeu de résultats + associé. </para> </section> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/pdo.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc-fr/reference/pdo/pdo.xml diff -u phpdoc-fr/reference/pdo/pdo.xml:1.3 phpdoc-fr/reference/pdo/pdo.xml:1.4 --- phpdoc-fr/reference/pdo/pdo.xml:1.3 Sat Jun 21 20:51:41 2008 +++ phpdoc-fr/reference/pdo/pdo.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.3 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.4 $ --> <!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/prepared-statements.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/prepared-statements.xml diff -u phpdoc-fr/reference/pdo/prepared-statements.xml:1.2 phpdoc-fr/reference/pdo/prepared-statements.xml:1.3 --- phpdoc-fr/reference/pdo/prepared-statements.xml:1.2 Sun Mar 30 10:26:53 2008 +++ phpdoc-fr/reference/pdo/prepared-statements.xml Sat Dec 27 18:40:48 2008 @@ -1,53 +1,53 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="pdo.prepared-statements" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Requêtes préparées et procédures stockées</title> + <title>Requêtes préparées et procédures stockées</title> <para> - La plupart des bases de données supportent le concept des requêtes préparées. - Qu'est-ce donc ? Vous pouvez les voir comme une sorte de modèle compilé - pour le SQL que vous voulez exécuter, qui peut être personnalisé en utilisant - des variables en guise de paramètres. Les requêtes préparées offrent - deux fonctionnalités essentielles : + La plupart des bases de données supportent le concept des requêtes préparées. + Qu'est-ce donc ? Vous pouvez les voir comme une sorte de modèle compilé + pour le SQL que vous voulez exécuter, qui peut être personnalisé en utilisant + des variables en guise de paramètres. Les requêtes préparées offrent + deux fonctionnalités essentielles : </para> <itemizedlist> <listitem> <simpara> - La requête ne doit être analysée (ou préparée) qu'une seule fois, mais peut - être exécutée plusieurs fois avec des paramètres identiques ou différents. - Lorsque la requête est préparée, la base de données va analyser, compiler - et optimiser son plan pour exécuter la requête. Pour les requêtes complexes, + La requête ne doit être analysée (ou préparée) qu'une seule fois, mais peut + être exécutée plusieurs fois avec des paramètres identiques ou différents. + Lorsque la requête est préparée, la base de données va analyser, compiler + et optimiser son plan pour exécuter la requête. Pour les requêtes complexes, ce processus peut prendre assez de temps, ce qui peut ralentir vos applications - si vous devez répéter la même requête plusieurs fois avec différents paramètres. - En utilisant les requêtes préparées, vous évitez ainsi de répéter le cycle - analyser/compilation/optimisation. Pour résumer, les requêtes préparées - utilisent moins de ressources et s'exécutent plus rapidement. + si vous devez répéter la même requête plusieurs fois avec différents paramètres. + En utilisant les requêtes préparées, vous évitez ainsi de répéter le cycle + analyser/compilation/optimisation. Pour résumer, les requêtes préparées + utilisent moins de ressources et s'exécutent plus rapidement. </simpara> </listitem> <listitem> <simpara> - Les paramètres pour préparer les requêtes n'ont pas besoin d'être entre - guillemets ; le driver le gère pour vous. Si votre application utilise exclusivement - les requêtes préparées, vous pouvez être sûr qu'aucune injection SQL - n'est possible (Cependant, si vous construisez d'autres parties de la requête - en vous basant sur des entrées utilisateurs, vous continuez à prendre un risque). + Les paramètres pour préparer les requêtes n'ont pas besoin d'être entre + guillemets ; le driver le gère pour vous. Si votre application utilise exclusivement + les requêtes préparées, vous pouvez être sûr qu'aucune injection SQL + n'est possible (Cependant, si vous construisez d'autres parties de la requête + en vous basant sur des entrées utilisateurs, vous continuez à prendre un risque). </simpara> </listitem> </itemizedlist> <para> - Les requêtes préparées sont tellement pratiques que c'est l'unique fonctionnalité - que PDO émule pour les drivers qui ne les supportent pas. Ceci assure de pouvoir - utiliser la même technique pour accéder aux données, sans se soucier des capacités - de la base de données. + Les requêtes préparées sont tellement pratiques que c'est l'unique fonctionnalité + que PDO émule pour les drivers qui ne les supportent pas. Ceci assure de pouvoir + utiliser la même technique pour accéder aux données, sans se soucier des capacités + de la base de données. </para> <para> <example> - <title>Insertions répétitives en utilisant les requêtes préparées</title> + <title>Insertions répétitives en utilisant les requêtes préparées</title> <simpara> - Cet exemple effectue une requête INSERT en y substituant un - <literal>nom</literal> et une <literal>valeur</literal> pour les marqueurs nommés. + Cet exemple effectue une requête INSERT en y substituant un + <literal>nom</literal> et une <literal>valeur</literal> pour les marqueurs nommés. </simpara> <programlisting role='php'> <![CDATA[ @@ -61,7 +61,7 @@ $value = 1; $stmt->execute(); -// insertion d'une autre ligne avec des valeurs différentes +// insertion d'une autre ligne avec des valeurs différentes $name = 'two'; $value = 2; $stmt->execute(); @@ -72,9 +72,9 @@ </para> <para> <example> - <title>Insertions répétées en utilisant des requêtes réparées</title> + <title>Insertions répétées en utilisant des requêtes réparées</title> <simpara> - Cet exemple effectue une requête INSERT en y substituant un <literal>nom</literal> + Cet exemple effectue une requête INSERT en y substituant un <literal>nom</literal> et une <literal>valeur</literal> pour les marqueurs <literal>?</literal>. </simpara> <programlisting role='php'> @@ -89,7 +89,7 @@ $value = 1; $stmt->execute(); -// insertion d'une autre ligne avec différentes valeurs +// insertion d'une autre ligne avec différentes valeurs $name = 'two'; $value = 2; $stmt->execute(); @@ -100,10 +100,10 @@ </para> <para> <example> - <title>Récupération des données en utilisant des requêtes préparées</title> + <title>Récupération des données en utilisant des requêtes préparées</title> <simpara> - Cet exemple récupère des données basées sur la valeur d'une clé fournie - par un formulaire. L'entrée utilisateur est automatiquement échappée, il n'y a + Cet exemple récupère des données basées sur la valeur d'une clé fournie + par un formulaire. L'entrée utilisateur est automatiquement échappée, il n'y a donc aucun risque d'attaque par injection SQL. </simpara> <programlisting role='php'> @@ -121,28 +121,28 @@ </example> </para> <para> - Si le driver de la base de données le supporte, vous pouvez également lier - des paramètres aussi bien pour l'entrée que pour la sortie. Les paramètres de sortie - sont utilisés typiquement pour récupérer les valeurs d'une procédure stockée. - Les paramètres de sortie sont un peu plus complexe à utiliser que les paramètres d'entrée - car vous devez savoir la longueur d'un paramètre donné pourra atteindre lorsque vous - le liez. Si la valeur retournée est plus longue que la taille qui vous auriez suggéré, - une erreur sera émise. + Si le driver de la base de données le supporte, vous pouvez également lier + des paramètres aussi bien pour l'entrée que pour la sortie. Les paramètres de sortie + sont utilisés typiquement pour récupérer les valeurs d'une procédure stockée. + Les paramètres de sortie sont un peu plus complexe à utiliser que les paramètres d'entrée + car vous devez savoir la longueur d'un paramètre donné pourra atteindre lorsque vous + le liez. Si la valeur retournée est plus longue que la taille qui vous auriez suggéré, + une erreur sera émise. </para> <para> <example> - <title>Appel d'une procédure stockée avec un paramètre de sortie</title> + <title>Appel d'une procédure stockée avec un paramètre de sortie</title> <programlisting role='php'> <![CDATA[ <?php $stmt = $dbh->prepare("CALL sp_returns_string(?)"); $stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000); -// Appel de la procédure stockée +// Appel de la procédure stockée $stmt->execute(); -print "La procédure a retourné : $return_value\n"; +print "La procédure a retourné : $return_value\n"; ?> ]]> </programlisting> @@ -150,16 +150,16 @@ </para> <para> - Vous devez également spécifier les paramètres qui gèrent les valeurs - aussi bien pour l'entrée que pour la sortie ; la syntaxe est similaire aux - paramètres de sortie. Dans le prochain exemple, la chaîne 'Bonjour' est passée - à la procédure stockée et lorsqu'elle retourne la valeur, 'Bonjour' est remplacée - par la valeur retournée par la procédure. + Vous devez également spécifier les paramètres qui gèrent les valeurs + aussi bien pour l'entrée que pour la sortie ; la syntaxe est similaire aux + paramètres de sortie. Dans le prochain exemple, la chaîne 'Bonjour' est passée + à la procédure stockée et lorsqu'elle retourne la valeur, 'Bonjour' est remplacée + par la valeur retournée par la procédure. </para> <para> <example> - <title>Appel d'une procédure stockée avec un paramètre d'entrée/sortie</title> + <title>Appel d'une procédure stockée avec un paramètre d'entrée/sortie</title> <programlisting role='php'> <![CDATA[ <?php @@ -167,10 +167,10 @@ $value = 'hello'; $stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000); -// appel de la procédure stockée +// appel de la procédure stockée $stmt->execute(); -print "La procédure a retourné : $value\n"; +print "La procédure a retourné : $value\n"; ?> ]]> </programlisting> @@ -185,7 +185,7 @@ $stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE '%?%'"); $stmt->execute(array($_GET['name'])); -// un marqueur doit être utilisé à la place d'une valeur complète +// un marqueur doit être utilisé à la place d'une valeur complète $stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE ?"); $stmt->execute(array("%$_GET[name]%")); ?> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/setup.xml?r1=1.1&r2=1.2&diff_format=u Index: phpdoc-fr/reference/pdo/setup.xml diff -u phpdoc-fr/reference/pdo/setup.xml:1.1 phpdoc-fr/reference/pdo/setup.xml:1.2 --- phpdoc-fr/reference/pdo/setup.xml:1.1 Fri Mar 28 23:52:19 2008 +++ phpdoc-fr/reference/pdo/setup.xml Sat Dec 27 18:40:48 2008 @@ -1,5 +1,5 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.2 $ --> <!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/pdo/transactions.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-fr/reference/pdo/transactions.xml diff -u phpdoc-fr/reference/pdo/transactions.xml:1.2 phpdoc-fr/reference/pdo/transactions.xml:1.3 --- phpdoc-fr/reference/pdo/transactions.xml:1.2 Mon May 26 10:55:12 2008 +++ phpdoc-fr/reference/pdo/transactions.xml Sat Dec 27 18:40:48 2008 @@ -1,73 +1,73 @@ -<?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> +<?xml version="1.0" encoding="iso-8859-1"?> +<!-- $Revision: 1.3 $ --> <!-- EN-Revision: 1.3 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="pdo.transactions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Transactions et validation automatique (autocommit)</title> <para> - Maintenant que vous êtes connecté via PDO, vous devez comprendre - comment PDO gère les transactions avant d'exécuter des requêtes. Si vous n'avez - jamais utilisé les transactions, elles offrent 4 fonctionnalités majeures : - Atomicité, Consistance, Isolation et Durabilité (ACID). En d'autres termes, - n'importe quel travail mené à bien dans une transaction, même s'il est effectué - par étapes, est garanti d'être appliqué à la base de données sans risque, et sans - interférence pour les autres connexions, quand il est validé. Le travail des transactions - peut également être automatiquement annulé à votre demande (en supposant que - vous n'avez encore rien validé), ce qui rend la gestion des erreurs bien plus + Maintenant que vous êtes connecté via PDO, vous devez comprendre + comment PDO gère les transactions avant d'exécuter des requêtes. Si vous n'avez + jamais utilisé les transactions, elles offrent 4 fonctionnalités majeures : + Atomicité, Consistance, Isolation et Durabilité (ACID). En d'autres termes, + n'importe quel travail mené à bien dans une transaction, même s'il est effectué + par étapes, est garanti d'être appliqué à la base de données sans risque, et sans + interférence pour les autres connexions, quand il est validé. Le travail des transactions + peut également être automatiquement annulé à votre demande (en supposant que + vous n'avez encore rien validé), ce qui rend la gestion des erreurs bien plus simple dans vos scripts. </para> <para> - Les transactions sont typiquement implémentées pour appliquer - toutes vos modifications en une seule fois ; ceci a le bel effet d'éprouver - drastiquement l'efficacité de vos mises à jour. Dans d'autres termes, + Les transactions sont typiquement implémentées pour appliquer + toutes vos modifications en une seule fois ; ceci a le bel effet d'éprouver + drastiquement l'efficacité de vos mises à jour. Dans d'autres termes, les transactions rendent vos scripts plus rapides et potentiellement plus - robustes (vous devez les utiliser correctement pour avoir ces bénéfices). + robustes (vous devez les utiliser correctement pour avoir ces bénéfices). </para> <para> - Malheureusement, toutes les bases de données ne supportent pas les transactions, - donc, PDO doit s'exécuter en mode "autocommit" lorsque vous ouvrez pour la première - fois la connexion. Le mode "autocommit" signifie que toutes les requêtes que vous - exécutez ont leurs transactions implicites, si la base de données le supporte ou - aucune transaction si la base de données ne les supporte pas. Si vous avez besoin - d'une transaction, vous devez utiliser la méthode <function>PDO::beginTransaction</function> - pour l'initialiser. Si le driver utilisé ne supporte pas les transactions, une exception - PDO sera lancée (en accord avec votre gestionnaire d'erreurs : ceci est toujours - une erreur sérieuse). Une fois que vous êtes dans une transaction, vous devez utiliser + Malheureusement, toutes les bases de données ne supportent pas les transactions, + donc, PDO doit s'exécuter en mode "autocommit" lorsque vous ouvrez pour la première + fois la connexion. Le mode "autocommit" signifie que toutes les requêtes que vous + exécutez ont leurs transactions implicites, si la base de données le supporte ou + aucune transaction si la base de données ne les supporte pas. Si vous avez besoin + d'une transaction, vous devez utiliser la méthode <function>PDO::beginTransaction</function> + pour l'initialiser. Si le driver utilisé ne supporte pas les transactions, une exception + PDO sera lancée (en accord avec votre gestionnaire d'erreurs : ceci est toujours + une erreur sérieuse). Une fois que vous êtes dans une transaction, vous devez utiliser la fonction <function>PDO::commit</function> ou la fonction <function>PDO::rollBack</function> - pour la terminer, suivant le succès de votre code durant la transaction. + pour la terminer, suivant le succès de votre code durant la transaction. </para> <para> Lorsque le script se termine ou lorsque la connexion est sur le point de se fermer, si vous avez une transaction en cours, PDO l'annulera automatiquement. - Ceci est une mesure de sécurité afin de garantir la consistance de vos données - dans le cas où le script se termine d'une façon inattendue. Si vous ne validez pas - explicitement la transaction, alors, on présume que quelque chose s'est mal passé - et l'annulation de la transaction intervient afin de garantir la sécurité de vos données. + Ceci est une mesure de sécurité afin de garantir la consistance de vos données + dans le cas où le script se termine d'une façon inattendue. Si vous ne validez pas + explicitement la transaction, alors, on présume que quelque chose s'est mal passé + et l'annulation de la transaction intervient afin de garantir la sécurité de vos données. </para> <warning> <para> - L'annulation automatique intervient si vous avez initialisé la transaction via + L'annulation automatique intervient si vous avez initialisé la transaction via <function>PDO::beginTransaction</function>. Si vous avez manuellement - exécuté une requête qui commence une transaction, PDO n'a aucun moyen de + exécuté une requête qui commence une transaction, PDO n'a aucun moyen de le savoir et donc, n'annulera pas automatiquement cette transaction si quelque - chose s'est mal passé. + chose s'est mal passé. </para> </warning> <para> <example> - <title>Exécution d'un groupe dans une transaction</title> + <title>Exécution d'un groupe dans une transaction</title> <para> - Dans l'exemple suivant, supposons que nous allons créer un jeu d'entrées - pour un nouvel employé, dont le numéro d'ID sera 23. - En plus des données basiques sur cette personne, nous devons également - lui enregistrer son salaire. Il est très simple d'effectuer deux mises à jour - séparées, mais en les enfermant dans les appels des fonctions + Dans l'exemple suivant, supposons que nous allons créer un jeu d'entrées + pour un nouvel employé, dont le numéro d'ID sera 23. + En plus des données basiques sur cette personne, nous devons également + lui enregistrer son salaire. Il est très simple d'effectuer deux mises à jour + séparées, mais en les enfermant dans les appels des fonctions <function>PDO::beginTransaction</function> et <function>PDO::commit</function>, nous garantissons que personne - ne pourra voir ces modifications tant qu'elles ne seront pas complètes. + ne pourra voir ces modifications tant qu'elles ne seront pas complètes. Si quelque chose tourne mal, le bloc de capture annulera toutes les - modifications effectuées depuis le début de la transaction et affichera + modifications effectuées depuis le début de la transaction et affichera un message d'erreur. </para> <programlisting role='php'> @@ -76,7 +76,7 @@ try { $dbh = new PDO('odbc:SAMPLE', 'db2inst1', 'ibmdb2', array(PDO::ATTR_PERSISTENT => true)); - echo "Connecté\n"; + echo "Connecté\n"; $dbh->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); $dbh->beginTransaction(); @@ -95,12 +95,12 @@ </example> </para> <para> - Vous n'êtes pas limité dans le nombre de mises à jour dans une transaction ; - vous pouvez également y effectuer des requêtes complexes et bien sûr, utiliser - ces informations pour construire d'autres mises à jour et requêtes ; durant l'activité - de la transaction, vous êtes garanti que personne d'autre ne peut effectuer des - modifications alors que vous êtes au milieu de vos modifications. En réalité, - ceci n'est pas 100% correct, mais cela reste une très bonne introduction aux + Vous n'êtes pas limité dans le nombre de mises à jour dans une transaction ; + vous pouvez également y effectuer des requêtes complexes et bien sûr, utiliser + ces informations pour construire d'autres mises à jour et requêtes ; durant l'activité + de la transaction, vous êtes garanti que personne d'autre ne peut effectuer des + modifications alors que vous êtes au milieu de vos modifications. En réalité, + ceci n'est pas 100% correct, mais cela reste une très bonne introduction aux transactions. </para> </chapter>
« previous php.doc.fr (#6178) next »