mirror of
https://github.com/php/doc-fr.git
synced 2026-03-24 07:02:06 +01:00
359 lines
13 KiB
XML
359 lines
13 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<!-- $Revision$ -->
|
|
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: pierrick Status: ready -->
|
|
<!-- Reviewed: no -->
|
|
|
|
<chapter xml:id="wincache.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
|
&reftitle.setup;
|
|
|
|
<section xml:id="wincache.requirements">
|
|
&reftitle.required;
|
|
<para>
|
|
L'extension est actuellement uniquement supportée sur les configurations suivantes :
|
|
</para>
|
|
<simpara>Windows OS:</simpara>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<simpara>Windows XP SP3 avec IIS 5.1 et l'<link xlink:href="&url.iis.fastcgi.downloads;">Extension FastCGI</link></simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Windows Server 2003 avec IIS 6.0 et l'<link xlink:href="&url.iis.fastcgi.downloads;">Extension FastCGI</link></simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Windows Vista SP1 avec IIS 7.0 et le module FastCGI</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Windows Server 2008 avec IIS 7.0 et le module FastCGI</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Windows 7 avec IIS 7.5 et le module FastCGI</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>Windows Server 2008 R2 avec IIS 7.5 et le module FastCGI</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<simpara>PHP:</simpara>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<simpara>PHP 5.2.X, Non-thread-safe build</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>PHP 5.3 X86, Non-thread-safe VC9 build</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<note>
|
|
<simpara>
|
|
L'extension WinCache peut uniquement être utilisée lorsque IIS est configuré pour exécuter PHP via FastCGI.
|
|
</simpara>
|
|
</note>
|
|
</section>
|
|
<section xml:id="wincache.installation">
|
|
&reftitle.install;
|
|
<para>
|
|
&pecl.moved;
|
|
</para>
|
|
<para>
|
|
&pecl.info;
|
|
<link xlink:href="&url.pecl.package;wincache">&url.pecl.package;wincache</link>.
|
|
</para>
|
|
<para>
|
|
Il y a deux packages pour cette extension: un package est pour les versions PHP 5.2.X,
|
|
et l'autre package est pour PHP 5.3.X. Choisissez le package approprié à la version PHP
|
|
utilisée.
|
|
</para>
|
|
<para>
|
|
Pour installer et activer l'extension, suivez ces étapes :
|
|
</para>
|
|
<procedure>
|
|
<step>
|
|
<simpara>
|
|
Décompressez le package dans un endroit temporaire.
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Copiez le fichier <filename>php_wincache.dll</filename> dans le dossier d'extensions PHP.
|
|
En général, ce dossier se nomme "ext" et est situé dans le même dossier avec tous les
|
|
fichiers binaires PHP. Par exemple : <filename>C:\Program Files\PHP\ext</filename>.
|
|
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Avec un éditeur de texte, ouvrez le fichier php.ini, qui se trouve généralement dans le même
|
|
dossier que tous les fichiers binaires PHP. Par exemple :
|
|
<filename>C:\Program Files\PHP\php.ini</filename>.
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Ajouter la ligne suivante à la fin du fichier php.ini :
|
|
<literal>extension = php_wincache.dll</literal>.
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Enregistrez et fermez le fichier <filename>php.ini</filename>.
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Redémarrez le pool d'application IIS pour que PHP récupère les changements de
|
|
configuration. Pour vérifier que l'extension a été activée, créez un fichier nommé
|
|
<filename>phpinfo.php</filename> contenant un appel à la fonction
|
|
<link linkend="function.phpinfo">phpinfo</link>.
|
|
</simpara>
|
|
</step>
|
|
<step>
|
|
<simpara>
|
|
Sauvez le fichier <filename>phpinfo.php</filename> dans le répertoire racine d'un
|
|
site Web IIS qui utilise PHP, puis ouvrez un navigateur et faites une requête sur
|
|
http://localhost/phpinfo.php. Cherchez une section appelée <literal>wincache</literal>
|
|
dans la page retournée. Si l'extension est activée, alors la sortie de
|
|
<link linkend="function.phpinfo">phpinfo</link> listera les paramètres de configuration
|
|
fournis par WinCache.
|
|
</simpara>
|
|
</step>
|
|
</procedure>
|
|
<note>
|
|
<simpara>
|
|
Ne pas oublier de supprimer le fichier <filename>phpinfo.php</filename> du répertoire
|
|
racine après avoir vérifié que l'extension a été activée.
|
|
</simpara>
|
|
</note>
|
|
</section>
|
|
&reference.wincache.ini;
|
|
|
|
<section xml:id="wincache.stats">
|
|
<title>Script de statistiques WinCache</title>
|
|
<para>
|
|
Le package d'installation pour WinCache inclut un script PHP,
|
|
<filename>wincache.php</filename>, qui peut être utilisé pour obtenir des informations et des
|
|
statistiques sur le cache.
|
|
</para>
|
|
<para>
|
|
Si l'extension WinCache a été installée via l'installeur de Microsoft Web Platform,
|
|
alors ce script se trouve dans
|
|
<filename>%SystemDrive%\Program Files\IIS\Windows Cache for PHP\</filename>.
|
|
Sur une version 64 bits du système d'exploitation Windows Server, le script se trouve dans
|
|
<filename>%SystemDrive%\Program Files (x86)\IIS\Windows Cache for PHP</filename>.
|
|
Si l'extension a été installée manuellement, alors le fichier <filename>wincache.php</filename>
|
|
sera situé dans le même dossier à partir duquel le contenu du package d'installation a été extrait.
|
|
</para>
|
|
<para>
|
|
Pour utiliser <filename>wincache.php</filename>, copiez-le dans le dossier racine d'un site Web ou
|
|
dans n'importe quel sous-dossier. Pour protéger le script, ouvrez-le dans n'importe quel éditeur et
|
|
remplacez les valeurs des constantes <emphasis>USERNAME</emphasis> et <emphasis>PASSWORD</emphasis>.
|
|
Si n'importe quel autre authentification IIS est activée sur le serveur, alors suivez les instructions
|
|
dans les commentaires :
|
|
<example>
|
|
<title>Configuration de l'authentification pour <filename>wincache.php</filename></title>
|
|
<programlisting role="php">
|
|
<![CDATA[
|
|
<?php
|
|
/**
|
|
* ======================== CONFIGURATION SETTINGS ==============================
|
|
* If you do not want to use authentication for this page, set USE_AUTHENTICATION to 0.
|
|
* If you use authentication then replace the default password.
|
|
*/
|
|
define('USE_AUTHENTICATION', 1);
|
|
define('USERNAME', 'wincache');
|
|
define('PASSWORD', 'wincache');
|
|
|
|
/**
|
|
* The Basic PHP authentication will work only when IIS is configured to support
|
|
* Anonymous Authentication' and nothing else. If IIS is configured to support/use
|
|
* any other kind of authentication like Basic/Negotiate/Digest etc, this will not work.
|
|
* In that case use the array below to define the names of users in your
|
|
* domain/network/workgroup which you want to grant access to.
|
|
*/
|
|
$user_allowed = array('DOMAIN\user1', 'DOMAIN\user2', 'DOMAIN\user3');
|
|
|
|
/**
|
|
* If the array contains string 'all', then all the users authenticated by IIS
|
|
* will have access to the page. Uncomment the below line and comment above line
|
|
* to grant access to all users who gets authenticated by IIS.
|
|
*/
|
|
/* $user_allowed = array('all'); */
|
|
|
|
/** ===================== END OF CONFIGURATION SETTINGS ========================== */
|
|
?>
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
<note>
|
|
<simpara>
|
|
Protégez toujours le script <filename>wincache.php</filename> en utilisant soit
|
|
le mécanisme d'authentification intégré ou le mécanisme d'authentification du serveur.
|
|
Laisser ce script non protégé peut compromettre la sécurité de l'application web
|
|
et du serveur.
|
|
</simpara>
|
|
</note>
|
|
</para>
|
|
</section>
|
|
<section xml:id="wincache.sessionhandler">
|
|
<title>WinCache Session Handler</title>
|
|
<para>
|
|
Le gestionnaire de session WinCache (disponible depuis WinCache 1.1.0) peut être utilisé
|
|
pour configurer PHP pour stocker les données de session dans la mémoire partagée du cache de session.
|
|
L'utilisation de la mémoire partagée au lieu de la session par défaut aide à améliorer les performances
|
|
des applications PHP qui stockent de grandes quantités de données dans des objets de session.
|
|
Le cache de session Wincache utilise des fichiers basés sur la mémoire partagée, ce qui
|
|
assure que les données de session ne seront pas perdues lors du recyclage de la file
|
|
d'attente des applications IIS.
|
|
</para>
|
|
<para>
|
|
Pour configurer PHP pour utiliser le gestionnaire de session WinCache mettez le paramètre
|
|
<link linkend="ini.session.save-handler">session.save_handler</link> du fichier
|
|
<filename>php.ini</filename> à <emphasis>wincache</emphasis>.
|
|
Par défaut, l'endroit où sont stockés les fichiers temporaires sous Windows est utilisé
|
|
pour stocker les données de session. Pour changer cet endroit, utiliser la directive
|
|
<link linkend="ini.session.save-path">session.save_path</link>.
|
|
<example>
|
|
<title>Activer le gestionnaire de session WinCache</title>
|
|
<programlisting role="php.ini">
|
|
<![CDATA[
|
|
session.save_handler = wincache
|
|
session.save_path = C:\inetpub\temp\session\
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
</section>
|
|
<section xml:id="wincache.reroutes">
|
|
<title>WinCache Functions Reroutes</title>
|
|
<para>
|
|
<emphasis>NOTE:</emphasis>
|
|
<link linkend="ini.wincache.rerouteini">wincache.rerouteini</link>
|
|
a été retiré avec WinCache 1.3.7.0. Cela a été remplacé par le reroutage
|
|
automatique de fonction. Voir :
|
|
<link linkend="ini.wincache.reroute_enabled">wincache.reroute_enabled</link>
|
|
</para>
|
|
<para>
|
|
Les fonctionnalités WinCache de re routages de fonctions (disponibles
|
|
depuis WinCache 1.2.0, retirée depuis WinCache 1.3.7.0) peuvent être utilisées pour remplacer des fonctions
|
|
PHP natives par leur équivalent optimisé pour des cas particuliers. L'extension
|
|
Wincache inclut des implémentations de fonctions PHP optimisées pour Windows,
|
|
notamment dans les cas d'accès réseau ou système de fichiers.
|
|
Les fonctions suivantes sont concernées :
|
|
</para>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.file-exists">file_exists</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.file-get-contents">file_get_contents</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.readfile">readfile</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.is-readable">is_readable</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.is-writable">is_writable</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.is-dir">is_dir</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.realpath">realpath</link>
|
|
</simpara>
|
|
</listitem>
|
|
<listitem>
|
|
<simpara>
|
|
<link linkend="function.filesize">filesize</link>
|
|
</simpara>
|
|
</listitem>
|
|
</itemizedlist>
|
|
<para>
|
|
Pour configurer le re routage de fonctions avec Wincache, utiliser le fichier
|
|
<filename>reroute.ini</filename> inclus dans le paquet. Copiez-le dans le dossier
|
|
où se trouve <filename>php.ini</filename>. Après, ajoutez wincache.rerouteini dans
|
|
<filename>php.ini</filename> et précisez le chemin absolu ou relatif vers
|
|
<filename>reroute.ini</filename>.
|
|
<example>
|
|
<title>Activation des fonctionnalités de re routage des fonctions de WinCache</title>
|
|
<programlisting role="php.ini">
|
|
<![CDATA[
|
|
wincache.rerouteini = C:\PHP\reroute.ini
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
<note>
|
|
<simpara>
|
|
Si activé, il est recommandé d'augmenter la taille du cache des fichiers. Ceci peut être
|
|
fait en utilisant le paramètre <link linkend="ini.wincache.fcachesize">wincache.fcachesize</link>.
|
|
</simpara>
|
|
</note>
|
|
<para>
|
|
Le fichier <filename>reroute.ini</filename> contient la correspondance entre la fonction PHP native et
|
|
l'équivalent Wincache. Chaque ligne dans le fichier définit une correspondance. Voici la syntaxe:
|
|
</para>
|
|
<simpara>
|
|
<literal><PHP function name>:[<number of function parameters>]=<wincache function name></literal>
|
|
</simpara>
|
|
<para>
|
|
Un exemple de fichier est donné plus bas. Dans cet exemple, les appels aux fonctions PHP
|
|
<function>file_get_contents</function> seront remplacés par <function>wincache_file_get_contents</function>
|
|
seulement si le nombre de paramètres passés à la fonction est inférieur ou égal à deux. C'est utile de
|
|
préciser le nombre de paramètres lorsque la fonction de remplacement n'est pas conçue pour tous les
|
|
utiliser.
|
|
<example>
|
|
<title>Reroute.ini</title>
|
|
<programlisting role="php.ini">
|
|
<![CDATA[
|
|
[FunctionRerouteList]
|
|
file_exists=wincache_file_exists
|
|
file_get_contents:2=wincache_file_get_contents
|
|
readfile:2=wincache_readfile
|
|
is_readable=wincache_is_readable
|
|
is_writable=wincache_is_writable
|
|
is_writeable=wincache_is_writable
|
|
is_file=wincache_is_file
|
|
is_dir=wincache_is_dir
|
|
realpath=wincache_realpath
|
|
filesize=wincache_filesize
|
|
]]>
|
|
</programlisting>
|
|
</example>
|
|
</para>
|
|
</section>
|
|
</chapter>
|
|
|
|
<!-- 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:"~/.phpdoc/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
|
|
-->
|
|
|