dams Wed Oct 24 18:14:02 2001 EDT Modified files: /phpdoc/fr/features cookies.xml persistent-connections.xml remote-files.xml connection-handling.xml Log: Keeping up with en tree. Minor typos corrected all at once.
Index: phpdoc/fr/features/cookies.xml diff -u phpdoc/fr/features/cookies.xml:1.5 phpdoc/fr/features/cookies.xml:1.6 --- phpdoc/fr/features/cookies.xml:1.5 Wed Feb 7 04:21:36 2001 +++ phpdoc/fr/features/cookies.xml Wed Oct 24 18:14:02 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.6 $ --> <chapter id="features.cookies"> <title>Cookies</title> <para> @@ -5,17 +7,17 @@ sont un mécanisme d'enregistrement d'informations sur le client, et de lecture de ces informations. Ce système permet d'authentifier et de suivre les visiteurs. Vous pouvez envoyer un cookie avec la commande - <function>setcookie</function>. Les cookies font partie de l'entête + <function>setcookie</function>. Les cookies font partie des en-têtes <acronym>HTTP</acronym>, ce qui impose que <function>setcookie</function> - soit appelé avant tout affichage sur le client. Ce sont les + soit appelée avant tout affichage de texte. Ce sont les mêmes limitations que pour <function>header</function>. </para> <para> Tous les cookies qui sont envoyés au client seront automatiquement retournés au script PHP, et transformés en variable, exactement comme pour GET et POST. Si vous souhaitez affecter plusieurs - valeurs à un seul cookie, ajoutez<emphasis>[]</emphasis> - au nom du cookie. Pour plus details, reportez vous à la fonction + valeurs à un seul cookie, ajoutez <emphasis>[]</emphasis> + au nom du cookie. Pour plus détails, reportez-vous à la fonction <function>setcookie</function>. </para> </chapter> Index: phpdoc/fr/features/persistent-connections.xml diff -u phpdoc/fr/features/persistent-connections.xml:1.4 phpdoc/fr/features/persistent-connections.xml:1.5 --- phpdoc/fr/features/persistent-connections.xml:1.4 Wed Feb 7 04:21:36 2001 +++ phpdoc/fr/features/persistent-connections.xml Wed Oct 24 18:14:02 2001 @@ -1,3 +1,5 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> <chapter id="features.persistent-connections"> <title>Connexions persistantes aux bases de données</title> <simpara> @@ -9,8 +11,8 @@ d'utilisateur et le même mot de passe), et si une telle connexion existe, elle est utilisée. Sinon, elle est créée. Une connexion identique est une connexion qui a ouvert le même - hôte, avec le même nom et même mot de passe (si - ils sont nécessaires). + hôte, avec le même nom et le même mot de passe (s'ils + sont nécessaires). </simpara> <simpara> Ceux qui ne sont pas rompus aux techniques des serveurs web et leur @@ -24,7 +26,7 @@ de plus que les connexions non persistantes. </simpara> <simpara> - Alors pourquoi? + Alors pourquoi les connexions persistantes? </simpara> <simpara> Cela s'explique par la manière avec laquelle les serveurs web @@ -34,8 +36,8 @@ <simpara> La première est d'utiliser PHP comme un CGI (Common Interface Gateway). Lorsque PHP fonctionne de cette manière, une instance de - l'interpréteur PHP est créée puis détruit - pour chaque page demandée. Etant donné qu'il est + l'interpréteur PHP est créée puis détruite + pour chaque page demandée. Etant donné que cet interpreteur est détruit après chaque requête, toutes les ressources acquises (comme une connexion à une base SQL), sont purement et simplement détruites. @@ -43,7 +45,7 @@ <simpara> La deuxième méthode, et de loin, la plus prisée, est d'exécuter PHP sous la forme d'un module sur un serveur - multi-process, ce qui revient à dire : Apache. Un tel serveur + multi-processus, ce qui revient à dire : Apache. Un tel serveur a typiquement un processus parent qui coordonne un ensemble de processus fils, qui servent les fichiers. Lorsque les requêtes parviennent depuis un client, elles sont transmises à un fils disponible. Cela signifie @@ -56,13 +58,13 @@ </simpara> <simpara> La dernière méthode est d'utiliser PHP sous la forme d'un - module de serveur multi-threads. Actuellement, PHP 4 support + module de serveur multi-threads. Actuellement, PHP 4 supporte ISAPI, WSAPI, et NSAPI (sous Windows), qui permettent tous d'utiliser - PHP comme un module sur un serveur multi-thread tel que Netscape - FastTrack, Microsoft's Internet Information Server (IIS), et + PHP comme un module sur un serveur multi-threads tel que Netscape + FastTrack (iPlanet), Microsoft's Internet Information Server (IIS), et O'Reilly's WebSite Pro. Le comportement est essentiellement le même - que pour les serveurs multi-process décrit précédemment. Notez que - SAPI n'est pas possible avec PHP 3. + que pour les serveurs multi-processus décrits précédemment. + Notez que SAPI n'est pas disponible avec PHP 3. </simpara> <simpara> Si les connexions persistantes n'ont aucune fonctionnalité de plus, @@ -85,16 +87,16 @@ Notez que les connexions persistantes ont quelques inconvénients si vous hébergez une base de données, dont le nombre maximal de connexion risque d'être atteint par les connexions persistantes. - Si votre base de données accepte jusqu'à 16 connections simultanées - et que, 17 processus essaient de se connecte, le dernier restera - sur la touche. Si il y a des erreurs dans les scripts qui ne permettent + Si votre base de données accepte jusqu'à 16 connexions + simultanées et que, 17 processus essaient de se connecter, + le dernier restera sur la touche. S'il y a des erreurs dans les scripts qui ne +permettent pas de fermer la connexion (par exemple, une boucle infinie), votre - serveur sera rapidement engorgé. Vérifier la documentation de votre + serveur sera rapidement engorgé. Vérifiez la documentation de votre base de données pour savoir comment elle traite les connexions inactives ou abandonnées. </simpara> <simpara> - Résumons nous : les connexions persistantes ont été + Résumons-nous : les connexions persistantes ont été définies pour avoir les mêmes fonctionnalités que les connexions non persistantes. Les deux types de connexions sont parfaitement interchangeables, et n'affecteront pas le Index: phpdoc/fr/features/remote-files.xml diff -u phpdoc/fr/features/remote-files.xml:1.4 phpdoc/fr/features/remote-files.xml:1.5 --- phpdoc/fr/features/remote-files.xml:1.4 Thu Feb 1 08:42:29 2001 +++ phpdoc/fr/features/remote-files.xml Wed Oct 24 18:14:02 2001 @@ -1,18 +1,21 @@ +<?xml encoding="iso-8859-1"?> +<!-- $Revision: 1.5 $ --> <chapter id="features.remote-files"> <title>Utilisation des fichiers à distance</title> <para> Aussi longtemps que le support de la fonction d'ouverture générique de fichiers ("URL fopen wrapper") est actif lorsque vous configurez PHP (il est inutile de - passer explicitement l'option <option>--disable-url-fopen-wrapper</option> + passer explicitement l'option + <option role="configure"><link +linkend="install.configure.disable-url-fopen-wrapper">--disable-url-fopen-wrapper</link></option> pour faire la configuration), vous pouvez utiliser des URLs - (HTTP et FTP) avec la plupart des fonctions qui utilisent un + (HTTP et FTP) avec la majorité des fonctions qui utilisent un nom de fichier comme paramètre, ceci incluant les expressions <function>require</function> et <function>include</function>. <note> <para> Vous ne pouvez pas utiliser les fichiers distants dans les expressions - <function>include</function> et <function>require</function> avec Windows. + <function>include</function> et <function>require</function> sous Windows. </para> </note> </para> @@ -27,7 +30,7 @@ <example> <title>Connaître le titre d'une page distante</title> <programlisting role="php"> -<?;php +<?php $file = fopen("http://www.php.net/", "r"); if (!$file) { echo "<p>Impossible d'ouvrir le fichier distant.\n"; @@ -35,7 +38,7 @@ } while (!feof($file)) { $line = fgets($file, 1024); - /* Cela ne fonctionne que site le titre est écrit sur une ligne.*/ + /* Cela ne fonctionne que si le titre est écrit sur une ligne.*/ if (eregi("<title>(.*)</title>", $line, $out)) { $title = $out[1]; break; @@ -53,16 +56,16 @@ fichier n'existait pas encore. Pour vous connecter avec un utilisateur autre qu'anonyme, vous devez spécifier un nom d'utilisateur (et certainement le mot de passe) dans l'URL, - comme par exemple 'ftp://user:[EMAIL PROTECTED]/path/to/file'. + comme par exemple 'ftp://user:password@ftp.example.com/path/to/file'. (Vous pouvez utiliser le même type de syntaxe pour accéder aux fichiers via <acronym>HTTP</acronym> lorsqu'ils nécessitent une - authentification basique.) + authentification basique). </para> <para> <example> <title>Stocker des données sur un serveur distant</title> <programlisting role="php"> -<?;php +<?php $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); if (!$file) { echo "<p>Impossible d'ouvrir un fichier distant en écriture.\n"; Index: phpdoc/fr/features/connection-handling.xml diff -u phpdoc/fr/features/connection-handling.xml:1.5 phpdoc/fr/features/connection-handling.xml:1.6 --- phpdoc/fr/features/connection-handling.xml:1.5 Sat Jul 7 18:21:58 2001 +++ phpdoc/fr/features/connection-handling.xml Wed Oct 24 18:14:02 2001 @@ -1,3 +1,4 @@ +<!-- $Revision: 1.6 $ --> <chapter id="features.connection-handling"> <title>Gestion des connexions</title> <note> @@ -25,7 +26,7 @@ statut TIMEOUT. </simpara> <simpara> - Vous pouvez en outre, décider si vous voulez que la + Vous pouvez en outre décider si vous voulez que la déconnexion d'un client provoque l'arrêt de votre script. Il est parfois pratique de terminer le script, même si le client n'est plus là pour recevoir les informations. @@ -39,8 +40,8 @@ l'utilisateur se déconnecte, le script sera terminé. La seule exception est si vous avez enregistré une fonction de fermeture, avec <function>register_shutdown_function</function>. - Avec une telle fonction, lorsque l'utilisateur interromp sa - requête, à la prochaîne exécution du script, + Avec une telle fonction, lorsque l'utilisateur interrompt sa + requête, à la prochaine exécution du script, PHP va s'apercevoir que le dernier script n'a pas été terminé, et il va déclencher la fonction de fermeture. Cette fonction sera aussi appelée à la fin du script, @@ -52,7 +53,7 @@ &true; si la connexion a été annulée. </simpara> <simpara> - Votre script peut aussi éxpirer après un laps de temps. + Votre script peut aussi expirer après un laps de temps. Par défaut, le délai est de 30 secondes. Cette valeur peut être changée en utilisant la directive PHP <parameter>max_execution_time</parameter> dans le fichier @@ -60,23 +61,23 @@ <parameter>php3_max_execution_time</parameter>, dans le fichier Apache <filename>.conf</filename> ou encore avec la fonction <function>set_time_limit</function>. - Lorsque le délai éxpire, le script est terminé, + Lorsque le délai expire, le script est terminé, et comme pour la déconnexion du client, une fonction de finalisation sera appelée. Dans cette fonction, vous - pouvez savoir si c'est le délai d'éxpiration qui a + pouvez savoir si c'est le délai d'expiration qui a causé la fin du script, en appelant la fonction <function>connection_timeout</function>. Cette fonction - retournera vrai si le délai d'éxpiration a + retournera vrai si le délai d'expiration a été dépassé. </simpara> <simpara> - Une chose à noter et que les deux cas ABORTED et TIMEOUT + Une chose à noter est que les deux cas ABORTED et TIMEOUT peuvent être appelés en même temps. Ceci est possible si vous demandez à PHP d'ignorer les déconnexions des utilisateurs. PHP va quand même noter le fait que l'utilisateur s'est déconnecté, mais le script va continuer. Puis, lorsqu'il atteint la limite de - temps, le script va éxpirer. A ce moment là, les deux + temps, le script va expirer. A ce moment-là, les deux fonctions <function>connection_timeout</function> et <function>connection_aborted</function> vont retourner &true;. Vous pouvez aussi vérifier les deux états en un