cvs: phpdoc /fr/features connection-handling.xml cookies.xml persistent-connections.xml remote-files.xml

From: Date: Wed, 24 Oct 2001 22:14:02 +0000
Subject: cvs: phpdoc /fr/features connection-handling.xml cookies.xml persistent-connections.xml remote-files.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969338207@lists.php.net to get a copy of this message
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&eacute;canisme d'enregistrement d'informations sur le client, et de lecture de ces informations. Ce syst&egrave;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&ecirc;te + <function>setcookie</function>. Les cookies font partie des en-t&ecirc;tes <acronym>HTTP</acronym>, ce qui impose que <function>setcookie</function> - soit appel&eacute; avant tout affichage sur le client. Ce sont les + soit appel&eacute;e avant tout affichage de texte. Ce sont les m&ecirc;mes limitations que pour <function>header</function>. </para> <para> Tous les cookies qui sont envoy&eacute;s au client seront automatiquement retourn&eacute;s au script PHP, et transform&eacute;s en variable, exactement comme pour GET et POST. Si vous souhaitez affecter plusieurs - valeurs &agrave; un seul cookie, ajoutez<emphasis>[]</emphasis> - au nom du cookie. Pour plus details, reportez vous &agrave; la fonction + valeurs &agrave; un seul cookie, ajoutez <emphasis>[]</emphasis> + au nom du cookie. Pour plus d&eacute;tails, reportez-vous &agrave; 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&eacute;es</title> <simpara> @@ -9,8 +11,8 @@ d'utilisateur et le m&ecirc;me mot de passe), et si une telle connexion existe, elle est utilis&eacute;e. Sinon, elle est cr&eacute;&eacute;e. Une connexion identique est une connexion qui a ouvert le m&ecirc;me - h&ocirc;te, avec le m&ecirc;me nom et m&ecirc;me mot de passe (si - ils sont n&eacute;cessaires). + h&ocirc;te, avec le m&ecirc;me nom et le m&ecirc;me mot de passe (s'ils + sont n&eacute;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&egrave;re avec laquelle les serveurs web @@ -34,8 +36,8 @@ <simpara> La premi&egrave;re est d'utiliser PHP comme un CGI (Common Interface Gateway). Lorsque PHP fonctionne de cette mani&egrave;re, une instance de - l'interpr&eacute;teur PHP est cr&eacute;&eacute;e puis d&eacute;truit - pour chaque page demand&eacute;e. Etant donn&eacute; qu'il est + l'interpr&eacute;teur PHP est cr&eacute;&eacute;e puis d&eacute;truite + pour chaque page demand&eacute;e. Etant donn&eacute; que cet interpreteur est d&eacute;truit apr&egrave;s chaque requ&ecirc;te, toutes les ressources acquises (comme une connexion &agrave; une base SQL), sont purement et simplement d&eacute;truites. @@ -43,7 +45,7 @@ <simpara> La deuxi&egrave;me m&eacute;thode, et de loin, la plus pris&eacute;e, est d'ex&eacute;cuter PHP sous la forme d'un module sur un serveur - multi-process, ce qui revient &agrave; dire : Apache. Un tel serveur + multi-processus, ce qui revient &agrave; dire : Apache. Un tel serveur a typiquement un processus parent qui coordonne un ensemble de processus fils, qui servent les fichiers. Lorsque les requ&ecirc;tes parviennent depuis un client, elles sont transmises &agrave; un fils disponible. Cela signifie @@ -56,13 +58,13 @@ </simpara> <simpara> La derni&egrave;re m&eacute;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&ecirc;me - que pour les serveurs multi-process d&eacute;crit pr&eacute;c&eacute;demment. Notez que - SAPI n'est pas possible avec PHP 3. + que pour les serveurs multi-processus d&eacute;crits pr&eacute;c&eacute;demment. + Notez que SAPI n'est pas disponible avec PHP 3. </simpara> <simpara> Si les connexions persistantes n'ont aucune fonctionnalit&eacute; de plus, @@ -85,16 +87,16 @@ Notez que les connexions persistantes ont quelques inconv&eacute;nients si vous h&eacute;bergez une base de donn&eacute;es, dont le nombre maximal de connexion risque d'&ecirc;tre atteint par les connexions persistantes. - Si votre base de donn&eacute;es accepte jusqu'&agrave; 16 connections simultan&eacute;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&eacute;es accepte jusqu'&agrave; 16 connexions + simultan&eacute;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&eacute;. V&eacute;rifier la documentation de votre + serveur sera rapidement engorg&eacute;. V&eacute;rifiez la documentation de votre base de donn&eacute;es pour savoir comment elle traite les connexions inactives ou abandonn&eacute;es. </simpara> <simpara> - R&eacute;sumons nous : les connexions persistantes ont &eacute;t&eacute; + R&eacute;sumons-nous : les connexions persistantes ont &eacute;t&eacute; d&eacute;finies pour avoir les m&ecirc;mes fonctionnalit&eacute;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 &agrave; distance</title> <para> Aussi longtemps que le support de la fonction d'ouverture g&eacute;n&eacute;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&eacute; des fonctions qui utilisent un nom de fichier comme param&egrave;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&icirc;tre le titre d'une page distante</title> <programlisting role="php"> -&lt?;php +&lt;?php $file = fopen("http://www.php.net/", "r"); if (!$file) { echo "&lt;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 &eacute;crit sur une ligne.*/ + /* Cela ne fonctionne que si le titre est &eacute;crit sur une ligne.*/ if (eregi("&lt;title>(.*)&lt;/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&eacute;cifier un nom d'utilisateur (et certainement le mot de passe) dans l'URL, - comme par exemple 'ftp://user:password@ftp.example.com/path/to/file'. + comme par exemple 'ftp://user:password&#64;ftp.example.com/path/to/file'. (Vous pouvez utiliser le m&ecirc;me type de syntaxe pour acc&eacute;der aux fichiers via <acronym>HTTP</acronym> lorsqu'ils n&eacute;cessitent une - authentification basique.) + authentification basique). </para> <para> <example> <title>Stocker des donn&eacute;es sur un serveur distant</title> <programlisting role="php"> -&lt?;php +&lt;?php $file = fopen("ftp://ftp.php.net/incoming/outputfile", "w"); if (!$file) { echo "&lt;p>Impossible d'ouvrir un fichier distant en &eacute;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&eacute;cider si vous voulez que la + Vous pouvez en outre d&eacute;cider si vous voulez que la d&eacute;connexion d'un client provoque l'arr&ecirc;t de votre script. Il est parfois pratique de terminer le script, m&ecirc;me si le client n'est plus l&agrave; pour recevoir les informations. @@ -39,8 +40,8 @@ l'utilisateur se d&eacute;connecte, le script sera termin&eacute;. La seule exception est si vous avez enregistr&eacute; une fonction de fermeture, avec <function>register_shutdown_function</function>. - Avec une telle fonction, lorsque l'utilisateur interromp sa - requ&ecirc;te, &agrave; la procha&icirc;ne ex&eacute;cution du script, + Avec une telle fonction, lorsque l'utilisateur interrompt sa + requ&ecirc;te, &agrave; la prochaine ex&eacute;cution du script, PHP va s'apercevoir que le dernier script n'a pas &eacute;t&eacute; termin&eacute;, et il va d&eacute;clencher la fonction de fermeture. Cette fonction sera aussi appel&eacute;e &agrave; la fin du script, @@ -52,7 +53,7 @@ &true; si la connexion a &eacute;t&eacute; annul&eacute;e. </simpara> <simpara> - Votre script peut aussi &eacute;xpirer apr&egrave;s un laps de temps. + Votre script peut aussi expirer apr&egrave;s un laps de temps. Par d&eacute;faut, le d&eacute;lai est de 30 secondes. Cette valeur peut &ecirc;tre chang&eacute;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&eacute;lai &eacute;xpire, le script est termin&eacute;, + Lorsque le d&eacute;lai expire, le script est termin&eacute;, et comme pour la d&eacute;connexion du client, une fonction de finalisation sera appel&eacute;e. Dans cette fonction, vous - pouvez savoir si c'est le d&eacute;lai d'&eacute;xpiration qui a + pouvez savoir si c'est le d&eacute;lai d'expiration qui a caus&eacute; la fin du script, en appelant la fonction <function>connection_timeout</function>. Cette fonction - retournera vrai si le d&eacute;lai d'&eacute;xpiration a + retournera vrai si le d&eacute;lai d'expiration a &eacute;t&eacute; d&eacute;pass&eacute;. </simpara> <simpara> - Une chose &agrave; noter et que les deux cas ABORTED et TIMEOUT + Une chose &agrave; noter est que les deux cas ABORTED et TIMEOUT peuvent &ecirc;tre appel&eacute;s en m&ecirc;me temps. Ceci est possible si vous demandez &agrave; PHP d'ignorer les d&eacute;connexions des utilisateurs. PHP va quand m&ecirc;me noter le fait que l'utilisateur s'est d&eacute;connect&eacute;, mais le script va continuer. Puis, lorsqu'il atteint la limite de - temps, le script va &eacute;xpirer. A ce moment l&agrave;, les deux + temps, le script va expirer. A ce moment-l&agrave;, les deux fonctions <function>connection_timeout</function> et <function>connection_aborted</function> vont retourner &true;. Vous pouvez aussi v&eacute;rifier les deux &eacute;tats en un
« previous php.doc (#969338207) next »