repo_zf1/documentation/manual/fr/module_specs/Zend_Log-Writers-Syslog.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 24249 -->
<!-- Reviewed: no -->
<sect2 id="zend.log.writers.syslog">
    <title>Ecrire dans lee journal du système</title>

    <para>
        <classname>Zend_Log_Writer_Syslog</classname> écrit les rapports de log dans le
        journal système (syslog). En interne, il utilise les fonctions <acronym>PHP</acronym>
        <methodname>openlog()</methodname>,
        <methodname>closelog()</methodname>, et
        <methodname>syslog()</methodname>.
    </para>

    <para>
        Un cas d'utilisation intéressant de <classname>Zend_Log_Writer_Syslog</classname>
        est le cluster de machines. La fonctionnalité de journal système permet de
        faire en sorte que chaque machine enregistre dans un fichier de journal centralisé,
        ce qui simplifie l'administration.
    </para>

    <para>
        Par défaut, tous les messages gérés sont préfixés par "Zend_Log". Si vous souhaitez
        changer ce nom, utilisez le constructeur ou l'accesseur:
    </para>

    <programlisting language="php"><![CDATA[
// A l'instanciation
$writer = new Zend_Log_Writer_Syslog(array('application' => 'FooBar'));

// Plus tard:
$writer->setApplicationName('BarBaz');
]]></programlisting>

    <para>
        Le journal système vous aidera aussi à identifier les messages
        par types d'application ("facility"), les programmes de journalisation système
        vont générer des fichiers journaux différents en fonction des types
        d'application, ce qui là encore, peut aider dans l'administration.
    </para>

    <para>
        Pour spécifier le type d'application, utilisez le constructeur ou l'accesseur.
        Cette option peut être l'une des constantes utilisées par
        <methodname>openlog()</methodname>, définies dans la page
        <ulink url="http://php.net/openlog">du manuel de openlog()</ulink>.
    </para>

    <programlisting language="php"><![CDATA[
// A l'instanciation
$writer = new Zend_Log_Writer_Syslog(array('facility' => LOG_AUTH));

// Plus tard
$writer->setFacility(LOG_USER);
]]></programlisting>

    <para>
        En utilisant l'objet de log, continuez d'utiliser les constantes de
        <classname>Zend_Log</classname>, elles vont être converties en leurs valeurs
        par <methodname>syslog()</methodname>.
    </para>
</sect2>