cvs: phpdoc-fr /language/control-structures goto.xml /language/oop5 references.xml /language/predefined/iteratoraggregate getiterator.xml
/language/predefined/serializable serialize.xml unserialize.xml /reference/ibm_db2/functions db2-last-insert-id.xml db2-pclose.xml /reference/mssql
setup.xml /reference/stream/functions stream-context-get-default.xml stream-context-get-options.xml /reference/strings/functions strpos.xml
strripos.xml strstr.xml strtok.xml strtr.xml substr.xml vprintf.xml vsprintf.xml /reference/zlib ini.xml
| From: | Damien Seguy | Date: | Fri, 09 Jan 2009 21:27:50 +0000 |
| Subject: | cvs: phpdoc-fr /language/control-structures goto.xml /language/oop5 references.xml /language/predefined/iteratoraggregate getiterator.xml /language/predefined/serializable serialize.xml unserialize.xml /reference/ibm_db2/functions db2-last-insert-id.xml db2-pclose.xml /reference/mssql setup.xml /reference/stream/functions stream-context-get-default.xml stream-context-get-options.xml /reference/strings/functions strpos.xml strripos.xml strstr.xml strtok.xml strtr.xml substr.xml vprintf.xml vsprintf.xml /reference/zlib ini.xml |
||
| Groups: | php.doc.fr | ||
| Request: | Send a blank email to doc-fr+get-6318@lists.php.net to get a copy of this message | ||
dams Fri Jan 9 21:27:50 2009 UTC
Added files:
/phpdoc-fr/language/control-structures goto.xml
/phpdoc-fr/language/oop5 references.xml
/phpdoc-fr/language/predefined/iteratoraggregate getiterator.xml
/phpdoc-fr/language/predefined/serializable serialize.xml
unserialize.xml
/phpdoc-fr/reference/ibm_db2/functions db2-last-insert-id.xml
db2-pclose.xml
Modified files:
/phpdoc-fr/reference/mssql setup.xml
/phpdoc-fr/reference/stream/functions
stream-context-get-default.xml
stream-context-get-options.xml
/phpdoc-fr/reference/strings/functions strpos.xml strripos.xml
strstr.xml strtok.xml
strtr.xml substr.xml
vprintf.xml vsprintf.xml
/phpdoc-fr/reference/zlib ini.xml
Log:
sync with en
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mssql/setup.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/mssql/setup.xml diff -u phpdoc-fr/reference/mssql/setup.xml:1.4 phpdoc-fr/reference/mssql/setup.xml:1.5 --- phpdoc-fr/reference/mssql/setup.xml:1.4 Sat Jun 21 20:51:38 2008 +++ phpdoc-fr/reference/mssql/setup.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="mssql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -41,7 +41,18 @@ Sur les plates-formes où FreeTDS est utilisé (Linux), il n'y pas ce problème. </para> </note> - </section> + <note> + <para> + Sur Windows, si vous utilisez MSSQL 2005 ou plus récent, vous devez copier + la bibliothèque <literal>ntwdblib.dll</literal> dans le dossier où vous avez + installé PHP, et écraser celle qui s'y trouve. Ceci est dû à la version + qui est distribuée avec PHP : elle est ancienne et obsolète. Autrement, + vous pouvez utiliser <link linkend="book.uodbc">ODBC</link>, + <link linkend="ref.pdo-dblib">PDO_DBLIB</link> or + <link linkend="ref.pdo-odbc">PDO_ODBC</link> pour communiquer avec MSSQL. + </para> + </note> + </section> <!-- }}} --> <!-- {{{ Installation --> @@ -55,7 +66,26 @@ <!-- {{{ Resources --> <section xml:id="mssql.resources"> &reftitle.resources; - &no.resource; + <section xml:id="mssql.resources.link"> + <title>mssql link</title> + <para> + Un lien de connexion, retourné par les fonctions <function>mssql_connect</function> + et <function>mssql_pconnect</function>. + </para> + </section> + <section xml:id="mssql.resources.result"> + <title>mssql result</title> + <para> + Une ressource de résultat, retourné par <function>mssql_query</function> avec + une requête <literal>SELECT</literal>. + </para> + </section> + <section xml:id="mssql.resources.statement"> + <title>mssql statement</title> + <para> + Une commande préparée, retournée par <function>mssql_init</function>. + </para> + </section> </section> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-context-get-default.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-context-get-default.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.8 phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.9 --- phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.8 Tue Mar 25 00:09:32 2008 +++ phpdoc-fr/reference/stream/functions/stream-context-get-default.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-context-get-default" xmlns="http://docbook.org/ns/docbook"> @@ -10,11 +10,11 @@ </refnamediv> <refsect1> &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>stream_context_get_default</methodname> - <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <simpara> + <methodsynopsis> + <type>resource</type><methodname>stream_context_get_default</methodname> + <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <simpara> <function>stream_context_get_default</function> retourne le contexte par défaut qui est utilisé avec les fonctions de fichiers comme <function>fopen</function>, <function>file_get_contents</function>, etc, @@ -22,14 +22,45 @@ par défaut peuvent être spécifiées optionnellement avec la même syntaxe que pour <function>stream_context_create</function>. </simpara> - <simpara> - <parameter>options</parameter> doit être un tableau associatif de - tableaux associatifs, au format - <literal>$arr['wrapper']['option'] = $value</literal>. - </simpara> - <example> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <simpara> + <parameter>options</parameter> doit être un tableau associatif + de tableaux associatifs, au format + <literal>$arr['wrapper']['option'] = $value</literal>. + </simpara> + <note> + <para> + Depuis PHP 5.3.0, la fonction <function>stream_context_set_default</function> + peut être utilisée pour configurer le contexte par défaut. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Une <type>resource</type> de contexte de flux. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example xml:id="stream-context-get-default.example.basic"> <title>Exemple avec <function>stream_context_get_default</function></title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php $default_opts = array( @@ -67,16 +98,21 @@ ?> ]]> - </programlisting> - </example> - <simpara> - Voir aussi - <function>stream_context_create</function> et - les gestionnaires supportés par les contextes - (<xref linkend="wrappers"/>). - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; + <para> + <simplelist> + <member><function>stream_context_create</function></member> + <member>Liste des gestionnaires supportés avec les options de contexte (<xref linkend="wrappers"/>).</member> + </simplelist> + </para> + </refsect1><!-- }}} --> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-context-get-options.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-context-get-options.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.11 phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.12 --- phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.11 Tue Mar 25 00:09:32 2008 +++ phpdoc-fr/reference/stream/functions/stream-context-get-options.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-context-get-options" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -16,9 +16,67 @@ <simpara> <function>stream_context_get_options</function> retourne un tableau contenant la liste des options pour le flux ou le contexte - <parameter>stream|context</parameter>. + <parameter>stream_or_context</parameter>. </simpara> </refsect1> + + <refsect1 role="parameters"><!-- {{{ --> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>stream_or_context</parameter></term> + <listitem> + <para> + Le <type>stream</type> ou <type>context</type> dont il faut lire les options. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant les options. + </para> + </refsect1><!-- }}} --> + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; + <para> + <example xml:id="stream-context-get-options.example.basic"><!-- {{{ --> + <title>Exemple avec <function>stream_context_get_options</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$params = array("method" => "POST"); + +stream_context_get_default(array("http" => $params)); + +var_dump(stream_context_get_options(stream_context_get_default())); + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +array(1) { + ["http"]=> + array(1) { + ["method"]=> + string(4) "POST" + } +} +]]> + </screen> + </example><!-- }}} --> + </para> + </refsect1><!-- }}} --> + + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strpos.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/strpos.xml diff -u phpdoc-fr/reference/strings/functions/strpos.xml:1.18 phpdoc-fr/reference/strings/functions/strpos.xml:1.19 --- phpdoc-fr/reference/strings/functions/strpos.xml:1.18 Tue Jun 3 07:16:41 2008 +++ phpdoc-fr/reference/strings/functions/strpos.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpos"> @@ -78,7 +78,7 @@ &reftitle.examples; <para> <example> - <title>Exemple avec <function>strpos</function></title> + <title>Avec ===</title> <programlisting role="php"> <![CDATA[ <?php @@ -86,18 +86,49 @@ $findme = 'a'; $pos = strpos($mystring, $findme); -// Notez l'utilisation de ===. Un simple == ne donnerait pas le résultat escompté -// car la lettre 'a' est à la position 0 (la première). +// Notez notre utilisation de ===. == ne fonctionnerait pas comme attendu +// car la position de 'a' est la 0-ième (premier) caractère. if ($pos === false) { - echo "La chaîne '$findme' n'a pas été trouvée dans la chaîne '$mystring'"; + echo "La chaîne '$findme' ne se trouve pas dans la chaîne '$mystring'"; } else { - echo "La chaîne '$findme' a été trouvée dans la chaîne '$mystring'"; - echo " et à la position $pos"; + echo "La chaine '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et débute à la position $pos"; } +?> +]]> + </programlisting> + </example> + + <example> + <title>Avec !==</title> + <programlisting role="php"> +<![CDATA[ +<?php +$mystring = 'abc'; +$findme = 'a'; +$pos = strpos($mystring, $findme); -// On peut chercher le caractère, en ignorant tout avant une position +// Notez notre utilisation de !==. != ne fonctionnerait pas comme attendu +// car la position de 'a' est la 0-ième (premier) caractère. +if ($pos !== false) { + echo "La chaine '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et débute à la position $pos"; +} else { + echo "La chaîne '$findme' ne se trouve pas dans la chaîne '$mystring'"; +} +?> +]]> + </programlisting> + </example> + + <example> + <title>Utiliser un offset</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Nous pouvons chercher le caractère, et ignorer tout ce qui est avant l'offset $newstring = 'abcdef abcdef'; -$pos = strpos($newstring, 'a', 1); // $pos = 7, et non 0 +$pos = strpos($newstring, 'a', 1); // $pos = 7, non pas 0 ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strripos.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/strings/functions/strripos.xml diff -u phpdoc-fr/reference/strings/functions/strripos.xml:1.16 phpdoc-fr/reference/strings/functions/strripos.xml:1.17 --- phpdoc-fr/reference/strings/functions/strripos.xml:1.16 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strripos.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strripos"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strstr.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/strings/functions/strstr.xml diff -u phpdoc-fr/reference/strings/functions/strstr.xml:1.17 phpdoc-fr/reference/strings/functions/strstr.xml:1.18 --- phpdoc-fr/reference/strings/functions/strstr.xml:1.17 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strstr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr"> @@ -55,7 +55,7 @@ <listitem> <para> Si <parameter>needle</parameter> n'est pas une chaîne, elle - sera convertie en entier, et utilisée comme code ascii du caractère + sera convertie en entier, et utilisée comme code ASCII du caractère correspondant. </para> </listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strtok.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/strings/functions/strtok.xml diff -u phpdoc-fr/reference/strings/functions/strtok.xml:1.15 phpdoc-fr/reference/strings/functions/strtok.xml:1.16 --- phpdoc-fr/reference/strings/functions/strtok.xml:1.15 Tue Jun 3 07:16:41 2008 +++ phpdoc-fr/reference/strings/functions/strtok.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -16,6 +16,10 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>string</type><parameter>token</parameter></methodparam> </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>strtok</methodname> + <methodparam><type>string</type><parameter>token</parameter></methodparam> + </methodsynopsis> <para> <function>strtok</function> coupe la chaîne <parameter>str</parameter> en segment, chaque segment étant délimité par <parameter>token</parameter>. http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strtr.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/strtr.xml diff -u phpdoc-fr/reference/strings/functions/strtr.xml:1.18 phpdoc-fr/reference/strings/functions/strtr.xml:1.19 --- phpdoc-fr/reference/strings/functions/strtr.xml:1.18 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strtr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -160,6 +160,7 @@ <para> <simplelist> <member><function>ereg_replace</function></member> + <member><function>preg_replace</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/substr.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/substr.xml diff -u phpdoc-fr/reference/strings/functions/substr.xml:1.18 phpdoc-fr/reference/strings/functions/substr.xml:1.19 --- phpdoc-fr/reference/strings/functions/substr.xml:1.18 Sat Jun 7 07:56:50 2008 +++ phpdoc-fr/reference/strings/functions/substr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr"> @@ -53,6 +53,10 @@ de la fin de la chaîne <parameter>string</parameter>. </para> <para> + Si <parameter>string</parameter> est plus petit ou égal à + <parameter>start</parameter> caractères de long, &false; sera retourné. + </para> + <para> <example> <title>Exemple de <parameter>start</parameter> négatif</title> <programlisting role="php"> @@ -76,9 +80,7 @@ la chaîne retournée contiendra au plus <parameter>length</parameter> caractères, en commençant à partir du caractère <parameter>start</parameter> (en fonction de la taille de la chaîne - <parameter>string</parameter>). Si <parameter>string</parameter> est plus - petite que <parameter>start</parameter>, <function>substr</function> - retournera &false;. + <parameter>string</parameter>). </para> <para> Si <parameter>length</parameter> est fourni et négatif, alors le même http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/vprintf.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/strings/functions/vprintf.xml diff -u phpdoc-fr/reference/strings/functions/vprintf.xml:1.11 phpdoc-fr/reference/strings/functions/vprintf.xml:1.12 --- phpdoc-fr/reference/strings/functions/vprintf.xml:1.11 Sun May 25 09:00:35 2008 +++ phpdoc-fr/reference/strings/functions/vprintf.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf"> @@ -59,6 +59,22 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>vprintf</function> : entiers complétés avec des zéros</title> + <programlisting role="php"> +<![CDATA[ +<?php +vprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/vsprintf.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/strings/functions/vsprintf.xml diff -u phpdoc-fr/reference/strings/functions/vsprintf.xml:1.9 phpdoc-fr/reference/strings/functions/vsprintf.xml:1.10 --- phpdoc-fr/reference/strings/functions/vsprintf.xml:1.9 Sun May 25 09:00:35 2008 +++ phpdoc-fr/reference/strings/functions/vsprintf.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf"> @@ -57,6 +57,22 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>vsprintf</function> : entiers avec zéro initiaux</title> + <programlisting role="php"> +<![CDATA[ +<?php +print vsprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/zlib/ini.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-fr/reference/zlib/ini.xml diff -u phpdoc-fr/reference/zlib/ini.xml:1.20 phpdoc-fr/reference/zlib/ini.xml:1.21 --- phpdoc-fr/reference/zlib/ini.xml:1.20 Sat Jun 21 20:51:48 2008 +++ phpdoc-fr/reference/zlib/ini.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook"> @@ -24,19 +24,19 @@ </thead> <tbody> <row> - <entry>zlib.output_compression</entry> + <entry><link linkend="ini.zlib.output-compression">zlib.output_compression</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.0.5.</entry> </row> <row> - <entry>zlib.output_compression_level</entry> + <entry><link linkend="ini.zlib.output-compression-level">zlib.output_compression_level</link></entry> <entry>"-1"</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.3.0.</entry> </row> <row> - <entry>zlib.output_handler</entry> + <entry><link linkend="ini.zlib.output-handler">zlib.output_handler</link></entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.3.0.</entry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/control-structures/goto.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/control-structures/goto.xml +++ phpdoc-fr/language/control-structures/goto.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <sect1 xml:id="control-structures.goto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title><literal>goto</literal></title> <para> L'opérateur <literal>goto</literal> peut être utilisé pour continuer l'exécution du script à un autre point du programme. La cible est spécifiée par un label et un deux-point. Le <literal>goto</literal> est suivi de ce label. </para> <para> <example> <title>Exemple avec <literal>goto</literal></title> <programlisting role="php"> <![CDATA[ <?php goto a; echo 'Foo'; a: echo 'Bar'; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Bar ]]> </screen> </example> </para> <note> <para> L'opérateur <literal>goto</literal> est disponible depuis PHP 5.3. </para> </note> <warning> <para> Il n'est pas possible de continuer l'exécution dans une boucle ou une instruction switch. Une erreur fatale est alors émise. </para> </warning> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/oop5/references.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/oop5/references.xml +++ phpdoc-fr/language/oop5/references.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: yes --> <sect1 xml:id="language.oop5.references" xmlns="http://docbook.org/ns/docbook"> <title>Objets et références</title> <para> Un des pilier de la POO de PHP 5 est le fait que les "objets sont passés par référence par défaut". Ce n'est pas complètement vrai. Cette section rectifie cette généralisation avec quelques exemples. </para> <para> Une référence PHP est un alias, qui permet à deux variable différentes d'écrire dans la même valeur. Depuis PHP 5, une variable contenant un objet ne contient plus l'objet lui-même. Il contient un identifiant d'objet, ce qui permet aux accesseurs d'objets de trouver cet objet. Lorsque l'objet est utilisé comme argument, retourné par une fonction ou assigné à une autre variable, les différentes variables ne sont pas des alias : ils contiennent le même identifiant, qui pointe sur la même valeur. </para> <example> <title>Références et Objets</title> <programlisting role="php"> <![CDATA[ <?php class A { public $foo = 1; } $a = new A; $b = $a; // $a et $b sont des copies du même identifiant // ($a) = ($b) = <id> $b->foo = 2; echo $a->foo."\n"; $c = new A; $d = &$c; // $c et $d sont des références // ($c,$d) = <id> $d->foo = 2; echo $c->foo."\n"; $e = new A; function foo($obj) { // ($obj) = ($e) = <id> $obj->foo = 2; } foo($e); echo $e->foo."\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 2 2 2 ]]> </screen> </example> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml +++ phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="iteratoraggregate.getiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>IteratorAggregate::getIterator</refname> <refpurpose>Retourne un itérateur externe</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>Traversable</type><methodname>IteratorAggregate::getIterator</methodname> <void /> </methodsynopsis> <para> Retourne un itérateur externe. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; &no.function.parameters; </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Une instance d'un objet qui implémente un <classname>Iterator</classname> ou l'interface <classname>Traversable</classname>. </para> </refsect1> <refsect1 role="errors"><!-- {{{ --> &reftitle.errors; <para> Ãmet une <classname>Exception</classname> en cas d'échec. </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/serializable/serialize.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/serializable/serialize.xml +++ phpdoc-fr/language/predefined/serializable/serialize.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="serializable.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Serializable::serialize</refname> <refpurpose>Représentation linéaire de l'objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>string</type><methodname>Serializable::serialize</methodname> <void /> </methodsynopsis> <para> Retourne la représentation en chaîne de caractères de l'objet. </para> <note> <para> Cette méthode se comporte comme un <link linkend="language.oop5.decon.destructor">destructeur</link> de l'objet. La méthode <function>__destruct</function> <emphasis>ne sera pas</emphasis> appelée après cette méthode. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; &no.function.parameters; </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la représentation de l'objet en chaîne de caractères, ou bien &null; </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Ãmet une <classname>Exception</classname> si un autre type que &string; ou &null; est retourné. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="language.oop5.magic.sleep">__sleep()</link></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/serializable/unserialize.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/serializable/unserialize.xml +++ phpdoc-fr/language/predefined/serializable/unserialize.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="serializable.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Serializable::unserialize</refname> <refpurpose>Construit un objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>mixed</type><methodname>Serializable::unserialize</methodname> <methodparam><type>string</type><parameter>serialized</parameter></methodparam> </methodsynopsis> <para> Called during unserialization of the object. </para> <note> <para> Cette méthode se comporte comme un <link linkend="language.oop5.decon.constructor">constructeur</link> d'objet. La méthode <function>__construct</function> <emphasis>ne sera pas</emphasis> appelée après cette méthode. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>serialized</parameter></term> <listitem> <para> La représentation en chaîne de l'objet. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la valeur originale délinéarisée. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="language.oop5.magic.sleep">__wakeup()</link></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml +++ phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-last-insert-id"> <refnamediv> <refname>db2_last_insert_id</refname> <refpurpose>Retourne le dernier ID généré par la dernière requête d'insertion exécut sur la connexion en cours</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>db2_last_insert_id</methodname> <methodparam><type>resource</type><parameter>resource</parameter></methodparam> </methodsynopsis> <para> Retourne le dernier identifiant auto-généré par la dernière requête d'insertion pour la connexion en cours. </para> <para> Le résultat de cette fonction n'est pas affecté par les événements suivants : <itemizedlist> <listitem> <para> Une commande unique INSERT avec une clause VALUES pour une table qui ne dispose pas de colonne d'identitée. </para> </listitem> <listitem> <para> Une commande INSERT multiple avec clause VALUES. </para> </listitem> <listitem> <para> Une commande INSERT avec un SELECT. </para> </listitem> <listitem> <para> Une commande ROLLBACK TO SAVEPOINT. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>resource</parameter></term> <listitem> <para> Une ressource de connexion valide, créée par <function>db2_connect</function> ou <function>db2_pconnect</function>. La valeur de ce paramètre ne peut pas être une ressource de commande ou de résultat. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l'identifiant auto-généré qui a pu être exécuté correctement sur cette connexion. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example xml:id="db2_last_insert_id.example.basic"><!-- {{{ --> <title>Exemple avec <function>A db2_last_insert_id</function></title> <para> L'exemple suivant montre comment retourner un identifiant automatique </para> <programlisting role="php"> <![CDATA[ <?php $database = "SAMPLE"; $user = "db2inst1"; $password = "ibmdb2"; $conn = db2_connect($database, $user, $password); if($conn) { $createTable = "CREATE TABLE lastInsertID (id integer GENERATED BY DEFAULT AS IDENTITY, name varchar(20))"; $insertTable = "INSERT INTO lastInsertID (name) VALUES ('Temp Name')"; $stmt = @db2_exec($conn, $createTable); /* Checking for single row inserted. */ $stmt = db2_exec($conn, $insertTable); $ret = db2_last_insert_id($conn); if($ret) { echo "Dernier ID inséré : " . $ret . "\n"; } else { echo "Pas d'ID inséré récemment.\n"; } db2_close($conn); } else { echo "La connexion a échoué."; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Dernier ID généré : 1 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml +++ phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-pclose"> <refnamediv> <refname>db2_pclose</refname> <refpurpose>Ferme une connexion persistante à la base de données</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>db2_pclose</methodname> <methodparam><type>resource</type><parameter>resource</parameter></methodparam> </methodsynopsis> <para> Cette fonction ferme une connexion DB2, créée avec <function>db2_pconnect</function> et libère les ressources correspondances du serveur. <note> <para> Cette fonction n'est disponible sur i5/OS en réponse à des requêtes d'administration i5/OS. </para> </note> </para> <para> Si vous avez une connexion client DB2 persistante créée avec la fonction <function>db2_pconnect</function>, vous pouvez utiliser cette fonction pour fermer la connexion. Pour éviter des coûts de connexion significatifs, cette fonction ne doit être utilisée que dans de rares cas, où la connexion est devenue amorphe, ou que la connexion persistante ne sera plus utilisée pour un long moment. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> Une ressource de connexion active DB2. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example xml:id="db2_pclose.example.basic"><!-- {{{ --> <title>Fermer une connexion DB2 persistante</title> <para> L'exemple ci-dessous montre comment fermer une connexion sur un serveur IBM DB2 i5/OS. </para> <programlisting role="php"> <![CDATA[ <?php $conn = db2_pconnect('', '', ''); $rc = db2_pclose($conn); if ($rc) { echo "La connexion a été correctement fermée."; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ La connexion a été correctement fermée. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>db2_close</function></member> <member><function>db2_pconnect</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->
http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/mssql/setup.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-fr/reference/mssql/setup.xml diff -u phpdoc-fr/reference/mssql/setup.xml:1.4 phpdoc-fr/reference/mssql/setup.xml:1.5 --- phpdoc-fr/reference/mssql/setup.xml:1.4 Sat Jun 21 20:51:38 2008 +++ phpdoc-fr/reference/mssql/setup.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <chapter xml:id="mssql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -41,7 +41,18 @@ Sur les plates-formes où FreeTDS est utilisé (Linux), il n'y pas ce problème. </para> </note> - </section> + <note> + <para> + Sur Windows, si vous utilisez MSSQL 2005 ou plus récent, vous devez copier + la bibliothèque <literal>ntwdblib.dll</literal> dans le dossier où vous avez + installé PHP, et écraser celle qui s'y trouve. Ceci est dû à la version + qui est distribuée avec PHP : elle est ancienne et obsolète. Autrement, + vous pouvez utiliser <link linkend="book.uodbc">ODBC</link>, + <link linkend="ref.pdo-dblib">PDO_DBLIB</link> or + <link linkend="ref.pdo-odbc">PDO_ODBC</link> pour communiquer avec MSSQL. + </para> + </note> + </section> <!-- }}} --> <!-- {{{ Installation --> @@ -55,7 +66,26 @@ <!-- {{{ Resources --> <section xml:id="mssql.resources"> &reftitle.resources; - &no.resource; + <section xml:id="mssql.resources.link"> + <title>mssql link</title> + <para> + Un lien de connexion, retourné par les fonctions <function>mssql_connect</function> + et <function>mssql_pconnect</function>. + </para> + </section> + <section xml:id="mssql.resources.result"> + <title>mssql result</title> + <para> + Une ressource de résultat, retourné par <function>mssql_query</function> avec + une requête <literal>SELECT</literal>. + </para> + </section> + <section xml:id="mssql.resources.statement"> + <title>mssql statement</title> + <para> + Une commande préparée, retournée par <function>mssql_init</function>. + </para> + </section> </section> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-context-get-default.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-context-get-default.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.8 phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.9 --- phpdoc-fr/reference/stream/functions/stream-context-get-default.xml:1.8 Tue Mar 25 00:09:32 2008 +++ phpdoc-fr/reference/stream/functions/stream-context-get-default.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-context-get-default" xmlns="http://docbook.org/ns/docbook"> @@ -10,11 +10,11 @@ </refnamediv> <refsect1> &reftitle.description; - <methodsynopsis> - <type>resource</type><methodname>stream_context_get_default</methodname> - <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam> - </methodsynopsis> - <simpara> + <methodsynopsis> + <type>resource</type><methodname>stream_context_get_default</methodname> + <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam> + </methodsynopsis> + <simpara> <function>stream_context_get_default</function> retourne le contexte par défaut qui est utilisé avec les fonctions de fichiers comme <function>fopen</function>, <function>file_get_contents</function>, etc, @@ -22,14 +22,45 @@ par défaut peuvent être spécifiées optionnellement avec la même syntaxe que pour <function>stream_context_create</function>. </simpara> - <simpara> - <parameter>options</parameter> doit être un tableau associatif de - tableaux associatifs, au format - <literal>$arr['wrapper']['option'] = $value</literal>. - </simpara> - <example> + </refsect1> + + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>options</parameter></term> + <listitem> + <simpara> + <parameter>options</parameter> doit être un tableau associatif + de tableaux associatifs, au format + <literal>$arr['wrapper']['option'] = $value</literal>. + </simpara> + <note> + <para> + Depuis PHP 5.3.0, la fonction <function>stream_context_set_default</function> + peut être utilisée pour configurer le contexte par défaut. + </para> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + Une <type>resource</type> de contexte de flux. + </para> + </refsect1> + + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example xml:id="stream-context-get-default.example.basic"> <title>Exemple avec <function>stream_context_get_default</function></title> - <programlisting role="php"> + <programlisting role="php"> <![CDATA[ <?php $default_opts = array( @@ -67,16 +98,21 @@ ?> ]]> - </programlisting> - </example> - <simpara> - Voir aussi - <function>stream_context_create</function> et - les gestionnaires supportés par les contextes - (<xref linkend="wrappers"/>). - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> + + <refsect1 role="seealso"><!-- {{{ --> + &reftitle.seealso; + <para> + <simplelist> + <member><function>stream_context_create</function></member> + <member>Liste des gestionnaires supportés avec les options de contexte (<xref linkend="wrappers"/>).</member> + </simplelist> + </para> + </refsect1><!-- }}} --> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/stream/functions/stream-context-get-options.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/stream/functions/stream-context-get-options.xml diff -u phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.11 phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.12 --- phpdoc-fr/reference/stream/functions/stream-context-get-options.xml:1.11 Tue Mar 25 00:09:32 2008 +++ phpdoc-fr/reference/stream/functions/stream-context-get-options.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="function.stream-context-get-options" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -16,9 +16,67 @@ <simpara> <function>stream_context_get_options</function> retourne un tableau contenant la liste des options pour le flux ou le contexte - <parameter>stream|context</parameter>. + <parameter>stream_or_context</parameter>. </simpara> </refsect1> + + <refsect1 role="parameters"><!-- {{{ --> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>stream_or_context</parameter></term> + <listitem> + <para> + Le <type>stream</type> ou <type>context</type> dont il faut lire les options. + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1><!-- }}} --> + + <refsect1 role="returnvalues"><!-- {{{ --> + &reftitle.returnvalues; + <para> + Retourne un tableau associatif contenant les options. + </para> + </refsect1><!-- }}} --> + + <refsect1 role="examples"><!-- {{{ --> + &reftitle.examples; + <para> + <example xml:id="stream-context-get-options.example.basic"><!-- {{{ --> + <title>Exemple avec <function>stream_context_get_options</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$params = array("method" => "POST"); + +stream_context_get_default(array("http" => $params)); + +var_dump(stream_context_get_options(stream_context_get_default())); + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +array(1) { + ["http"]=> + array(1) { + ["method"]=> + string(4) "POST" + } +} +]]> + </screen> + </example><!-- }}} --> + </para> + </refsect1><!-- }}} --> + + </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strpos.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/strpos.xml diff -u phpdoc-fr/reference/strings/functions/strpos.xml:1.18 phpdoc-fr/reference/strings/functions/strpos.xml:1.19 --- phpdoc-fr/reference/strings/functions/strpos.xml:1.18 Tue Jun 3 07:16:41 2008 +++ phpdoc-fr/reference/strings/functions/strpos.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.15 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strpos"> @@ -78,7 +78,7 @@ &reftitle.examples; <para> <example> - <title>Exemple avec <function>strpos</function></title> + <title>Avec ===</title> <programlisting role="php"> <![CDATA[ <?php @@ -86,18 +86,49 @@ $findme = 'a'; $pos = strpos($mystring, $findme); -// Notez l'utilisation de ===. Un simple == ne donnerait pas le résultat escompté -// car la lettre 'a' est à la position 0 (la première). +// Notez notre utilisation de ===. == ne fonctionnerait pas comme attendu +// car la position de 'a' est la 0-ième (premier) caractère. if ($pos === false) { - echo "La chaîne '$findme' n'a pas été trouvée dans la chaîne '$mystring'"; + echo "La chaîne '$findme' ne se trouve pas dans la chaîne '$mystring'"; } else { - echo "La chaîne '$findme' a été trouvée dans la chaîne '$mystring'"; - echo " et à la position $pos"; + echo "La chaine '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et débute à la position $pos"; } +?> +]]> + </programlisting> + </example> + + <example> + <title>Avec !==</title> + <programlisting role="php"> +<![CDATA[ +<?php +$mystring = 'abc'; +$findme = 'a'; +$pos = strpos($mystring, $findme); -// On peut chercher le caractère, en ignorant tout avant une position +// Notez notre utilisation de !==. != ne fonctionnerait pas comme attendu +// car la position de 'a' est la 0-ième (premier) caractère. +if ($pos !== false) { + echo "La chaine '$findme' a été trouvée dans la chaîne '$mystring'"; + echo " et débute à la position $pos"; +} else { + echo "La chaîne '$findme' ne se trouve pas dans la chaîne '$mystring'"; +} +?> +]]> + </programlisting> + </example> + + <example> + <title>Utiliser un offset</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Nous pouvons chercher le caractère, et ignorer tout ce qui est avant l'offset $newstring = 'abcdef abcdef'; -$pos = strpos($newstring, 'a', 1); // $pos = 7, et non 0 +$pos = strpos($newstring, 'a', 1); // $pos = 7, non pas 0 ?> ]]> </programlisting> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strripos.xml?r1=1.16&r2=1.17&diff_format=u Index: phpdoc-fr/reference/strings/functions/strripos.xml diff -u phpdoc-fr/reference/strings/functions/strripos.xml:1.16 phpdoc-fr/reference/strings/functions/strripos.xml:1.17 --- phpdoc-fr/reference/strings/functions/strripos.xml:1.16 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strripos.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.16 $ --> -<!-- EN-Revision: 1.13 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.17 $ --> +<!-- EN-Revision: 1.14 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strripos"> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strstr.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc-fr/reference/strings/functions/strstr.xml diff -u phpdoc-fr/reference/strings/functions/strstr.xml:1.17 phpdoc-fr/reference/strings/functions/strstr.xml:1.18 --- phpdoc-fr/reference/strings/functions/strstr.xml:1.17 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strstr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.18 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strstr"> @@ -55,7 +55,7 @@ <listitem> <para> Si <parameter>needle</parameter> n'est pas une chaîne, elle - sera convertie en entier, et utilisée comme code ascii du caractère + sera convertie en entier, et utilisée comme code ASCII du caractère correspondant. </para> </listitem> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strtok.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc-fr/reference/strings/functions/strtok.xml diff -u phpdoc-fr/reference/strings/functions/strtok.xml:1.15 phpdoc-fr/reference/strings/functions/strtok.xml:1.16 --- phpdoc-fr/reference/strings/functions/strtok.xml:1.15 Tue Jun 3 07:16:41 2008 +++ phpdoc-fr/reference/strings/functions/strtok.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.16 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtok" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -16,6 +16,10 @@ <methodparam><type>string</type><parameter>str</parameter></methodparam> <methodparam><type>string</type><parameter>token</parameter></methodparam> </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>strtok</methodname> + <methodparam><type>string</type><parameter>token</parameter></methodparam> + </methodsynopsis> <para> <function>strtok</function> coupe la chaîne <parameter>str</parameter> en segment, chaque segment étant délimité par <parameter>token</parameter>. http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/strtr.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/strtr.xml diff -u phpdoc-fr/reference/strings/functions/strtr.xml:1.18 phpdoc-fr/reference/strings/functions/strtr.xml:1.19 --- phpdoc-fr/reference/strings/functions/strtr.xml:1.18 Thu Jun 5 10:48:49 2008 +++ phpdoc-fr/reference/strings/functions/strtr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.7 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.strtr" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -160,6 +160,7 @@ <para> <simplelist> <member><function>ereg_replace</function></member> + <member><function>preg_replace</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/substr.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-fr/reference/strings/functions/substr.xml diff -u phpdoc-fr/reference/strings/functions/substr.xml:1.18 phpdoc-fr/reference/strings/functions/substr.xml:1.19 --- phpdoc-fr/reference/strings/functions/substr.xml:1.18 Sat Jun 7 07:56:50 2008 +++ phpdoc-fr/reference/strings/functions/substr.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.17 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.18 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.substr"> @@ -53,6 +53,10 @@ de la fin de la chaîne <parameter>string</parameter>. </para> <para> + Si <parameter>string</parameter> est plus petit ou égal à + <parameter>start</parameter> caractères de long, &false; sera retourné. + </para> + <para> <example> <title>Exemple de <parameter>start</parameter> négatif</title> <programlisting role="php"> @@ -76,9 +80,7 @@ la chaîne retournée contiendra au plus <parameter>length</parameter> caractères, en commençant à partir du caractère <parameter>start</parameter> (en fonction de la taille de la chaîne - <parameter>string</parameter>). Si <parameter>string</parameter> est plus - petite que <parameter>start</parameter>, <function>substr</function> - retournera &false;. + <parameter>string</parameter>). </para> <para> Si <parameter>length</parameter> est fourni et négatif, alors le même http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/vprintf.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc-fr/reference/strings/functions/vprintf.xml diff -u phpdoc-fr/reference/strings/functions/vprintf.xml:1.11 phpdoc-fr/reference/strings/functions/vprintf.xml:1.12 --- phpdoc-fr/reference/strings/functions/vprintf.xml:1.11 Sun May 25 09:00:35 2008 +++ phpdoc-fr/reference/strings/functions/vprintf.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.12 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vprintf"> @@ -59,6 +59,22 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>vprintf</function> : entiers complétés avec des zéros</title> + <programlisting role="php"> +<![CDATA[ +<?php +vprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/strings/functions/vsprintf.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-fr/reference/strings/functions/vsprintf.xml diff -u phpdoc-fr/reference/strings/functions/vsprintf.xml:1.9 phpdoc-fr/reference/strings/functions/vsprintf.xml:1.10 --- phpdoc-fr/reference/strings/functions/vsprintf.xml:1.9 Sun May 25 09:00:35 2008 +++ phpdoc-fr/reference/strings/functions/vsprintf.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.vsprintf"> @@ -57,6 +57,22 @@ </para> </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title>Exemple avec <function>vsprintf</function> : entiers avec zéro initiaux</title> + <programlisting role="php"> +<![CDATA[ +<?php +print vsprintf("%04d-%02d-%02d", explode('-', '1988-8-1')); // 1988-08-01 +?> +]]> + </programlisting> + </example> + </para> + </refsect1> + <refsect1 role="seealso"> &reftitle.seealso; <para> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/zlib/ini.xml?r1=1.20&r2=1.21&diff_format=u Index: phpdoc-fr/reference/zlib/ini.xml diff -u phpdoc-fr/reference/zlib/ini.xml:1.20 phpdoc-fr/reference/zlib/ini.xml:1.21 --- phpdoc-fr/reference/zlib/ini.xml:1.20 Sat Jun 21 20:51:48 2008 +++ phpdoc-fr/reference/zlib/ini.xml Fri Jan 9 21:27:50 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.20 $ --> -<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready --> +<!-- $Revision: 1.21 $ --> +<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <section xml:id="zlib.configuration" xmlns="http://docbook.org/ns/docbook"> @@ -24,19 +24,19 @@ </thead> <tbody> <row> - <entry>zlib.output_compression</entry> + <entry><link linkend="ini.zlib.output-compression">zlib.output_compression</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.0.5.</entry> </row> <row> - <entry>zlib.output_compression_level</entry> + <entry><link linkend="ini.zlib.output-compression-level">zlib.output_compression_level</link></entry> <entry>"-1"</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.3.0.</entry> </row> <row> - <entry>zlib.output_handler</entry> + <entry><link linkend="ini.zlib.output-handler">zlib.output_handler</link></entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> <entry>Disponible depuis PHP 4.3.0.</entry> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/control-structures/goto.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/control-structures/goto.xml +++ phpdoc-fr/language/control-structures/goto.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <sect1 xml:id="control-structures.goto" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title><literal>goto</literal></title> <para> L'opérateur <literal>goto</literal> peut être utilisé pour continuer l'exécution du script à un autre point du programme. La cible est spécifiée par un label et un deux-point. Le <literal>goto</literal> est suivi de ce label. </para> <para> <example> <title>Exemple avec <literal>goto</literal></title> <programlisting role="php"> <![CDATA[ <?php goto a; echo 'Foo'; a: echo 'Bar'; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Bar ]]> </screen> </example> </para> <note> <para> L'opérateur <literal>goto</literal> est disponible depuis PHP 5.3. </para> </note> <warning> <para> Il n'est pas possible de continuer l'exécution dans une boucle ou une instruction switch. Une erreur fatale est alors émise. </para> </warning> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/oop5/references.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/oop5/references.xml +++ phpdoc-fr/language/oop5/references.xml <?xml version="1.0" encoding="iso-8859-1"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: yes --> <sect1 xml:id="language.oop5.references" xmlns="http://docbook.org/ns/docbook"> <title>Objets et références</title> <para> Un des pilier de la POO de PHP 5 est le fait que les "objets sont passés par référence par défaut". Ce n'est pas complètement vrai. Cette section rectifie cette généralisation avec quelques exemples. </para> <para> Une référence PHP est un alias, qui permet à deux variable différentes d'écrire dans la même valeur. Depuis PHP 5, une variable contenant un objet ne contient plus l'objet lui-même. Il contient un identifiant d'objet, ce qui permet aux accesseurs d'objets de trouver cet objet. Lorsque l'objet est utilisé comme argument, retourné par une fonction ou assigné à une autre variable, les différentes variables ne sont pas des alias : ils contiennent le même identifiant, qui pointe sur la même valeur. </para> <example> <title>Références et Objets</title> <programlisting role="php"> <![CDATA[ <?php class A { public $foo = 1; } $a = new A; $b = $a; // $a et $b sont des copies du même identifiant // ($a) = ($b) = <id> $b->foo = 2; echo $a->foo."\n"; $c = new A; $d = &$c; // $c et $d sont des références // ($c,$d) = <id> $d->foo = 2; echo $c->foo."\n"; $e = new A; function foo($obj) { // ($obj) = ($e) = <id> $obj->foo = 2; } foo($e); echo $e->foo."\n"; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 2 2 2 ]]> </screen> </example> </sect1> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml +++ phpdoc-fr/language/predefined/iteratoraggregate/getiterator.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: yannick Status: ready --> <!-- Reviewed: yes --> <refentry xml:id="iteratoraggregate.getiterator" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>IteratorAggregate::getIterator</refname> <refpurpose>Retourne un itérateur externe</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>Traversable</type><methodname>IteratorAggregate::getIterator</methodname> <void /> </methodsynopsis> <para> Retourne un itérateur externe. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; &no.function.parameters; </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Une instance d'un objet qui implémente un <classname>Iterator</classname> ou l'interface <classname>Traversable</classname>. </para> </refsect1> <refsect1 role="errors"><!-- {{{ --> &reftitle.errors; <para> Ãmet une <classname>Exception</classname> en cas d'échec. </para> </refsect1><!-- }}} --> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/serializable/serialize.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/serializable/serialize.xml +++ phpdoc-fr/language/predefined/serializable/serialize.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="serializable.serialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Serializable::serialize</refname> <refpurpose>Représentation linéaire de l'objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>string</type><methodname>Serializable::serialize</methodname> <void /> </methodsynopsis> <para> Retourne la représentation en chaîne de caractères de l'objet. </para> <note> <para> Cette méthode se comporte comme un <link linkend="language.oop5.decon.destructor">destructeur</link> de l'objet. La méthode <function>__destruct</function> <emphasis>ne sera pas</emphasis> appelée après cette méthode. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; &no.function.parameters; </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la représentation de l'objet en chaîne de caractères, ou bien &null; </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> Ãmet une <classname>Exception</classname> si un autre type que &string; ou &null; est retourné. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="language.oop5.magic.sleep">__sleep()</link></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/language/predefined/serializable/unserialize.xml?view=markup&rev=1.1 Index: phpdoc-fr/language/predefined/serializable/unserialize.xml +++ phpdoc-fr/language/predefined/serializable/unserialize.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xml:id="serializable.unserialize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>Serializable::unserialize</refname> <refpurpose>Construit un objet</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <modifier>abstract</modifier> <modifier>public</modifier> <type>mixed</type><methodname>Serializable::unserialize</methodname> <methodparam><type>string</type><parameter>serialized</parameter></methodparam> </methodsynopsis> <para> Called during unserialization of the object. </para> <note> <para> Cette méthode se comporte comme un <link linkend="language.oop5.decon.constructor">constructeur</link> d'objet. La méthode <function>__construct</function> <emphasis>ne sera pas</emphasis> appelée après cette méthode. </para> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>serialized</parameter></term> <listitem> <para> La représentation en chaîne de l'objet. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne la valeur originale délinéarisée. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="language.oop5.magic.sleep">__wakeup()</link></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml +++ phpdoc-fr/reference/ibm_db2/functions/db2-last-insert-id.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-last-insert-id"> <refnamediv> <refname>db2_last_insert_id</refname> <refpurpose>Retourne le dernier ID généré par la dernière requête d'insertion exécut sur la connexion en cours</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>int</type><methodname>db2_last_insert_id</methodname> <methodparam><type>resource</type><parameter>resource</parameter></methodparam> </methodsynopsis> <para> Retourne le dernier identifiant auto-généré par la dernière requête d'insertion pour la connexion en cours. </para> <para> Le résultat de cette fonction n'est pas affecté par les événements suivants : <itemizedlist> <listitem> <para> Une commande unique INSERT avec une clause VALUES pour une table qui ne dispose pas de colonne d'identitée. </para> </listitem> <listitem> <para> Une commande INSERT multiple avec clause VALUES. </para> </listitem> <listitem> <para> Une commande INSERT avec un SELECT. </para> </listitem> <listitem> <para> Une commande ROLLBACK TO SAVEPOINT. </para> </listitem> </itemizedlist> </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>resource</parameter></term> <listitem> <para> Une ressource de connexion valide, créée par <function>db2_connect</function> ou <function>db2_pconnect</function>. La valeur de ce paramètre ne peut pas être une ressource de commande ou de résultat. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> Retourne l'identifiant auto-généré qui a pu être exécuté correctement sur cette connexion. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example xml:id="db2_last_insert_id.example.basic"><!-- {{{ --> <title>Exemple avec <function>A db2_last_insert_id</function></title> <para> L'exemple suivant montre comment retourner un identifiant automatique </para> <programlisting role="php"> <![CDATA[ <?php $database = "SAMPLE"; $user = "db2inst1"; $password = "ibmdb2"; $conn = db2_connect($database, $user, $password); if($conn) { $createTable = "CREATE TABLE lastInsertID (id integer GENERATED BY DEFAULT AS IDENTITY, name varchar(20))"; $insertTable = "INSERT INTO lastInsertID (name) VALUES ('Temp Name')"; $stmt = @db2_exec($conn, $createTable); /* Checking for single row inserted. */ $stmt = db2_exec($conn, $insertTable); $ret = db2_last_insert_id($conn); if($ret) { echo "Dernier ID inséré : " . $ret . "\n"; } else { echo "Pas d'ID inséré récemment.\n"; } db2_close($conn); } else { echo "La connexion a échoué."; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ Dernier ID généré : 1 ]]> </screen> </example> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml?view=markup&rev=1.1 Index: phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml +++ phpdoc-fr/reference/ibm_db2/functions/db2-pclose.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: dams Status: ready --> <!-- Reviewed: no --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.db2-pclose"> <refnamediv> <refname>db2_pclose</refname> <refpurpose>Ferme une connexion persistante à la base de données</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>db2_pclose</methodname> <methodparam><type>resource</type><parameter>resource</parameter></methodparam> </methodsynopsis> <para> Cette fonction ferme une connexion DB2, créée avec <function>db2_pconnect</function> et libère les ressources correspondances du serveur. <note> <para> Cette fonction n'est disponible sur i5/OS en réponse à des requêtes d'administration i5/OS. </para> </note> </para> <para> Si vous avez une connexion client DB2 persistante créée avec la fonction <function>db2_pconnect</function>, vous pouvez utiliser cette fonction pour fermer la connexion. Pour éviter des coûts de connexion significatifs, cette fonction ne doit être utilisée que dans de rares cas, où la connexion est devenue amorphe, ou que la connexion persistante ne sera plus utilisée pour un long moment. </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> Une ressource de connexion active DB2. </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example xml:id="db2_pclose.example.basic"><!-- {{{ --> <title>Fermer une connexion DB2 persistante</title> <para> L'exemple ci-dessous montre comment fermer une connexion sur un serveur IBM DB2 i5/OS. </para> <programlisting role="php"> <![CDATA[ <?php $conn = db2_pconnect('', '', ''); $rc = db2_pclose($conn); if ($rc) { echo "La connexion a été correctement fermée."; } ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ La connexion a été correctement fermée. ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>db2_close</function></member> <member><function>db2_pconnect</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->