<!DOCTYPE html SYSTEM "about:legacy-compat">
<html lang="fr"><head><META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="width=device-width, initial-scale=1" name="viewport">
<!--
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
              This file is generated from xml source: DO NOT EDIT
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
      -->
<title>mod_xml2enc - Serveur HTTP Apache Version 2.4</title>
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet">
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size">
<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"><link rel="stylesheet" type="text/css" href="../style/css/prettify.css">
<script src="../style/scripts/prettify.min.js">
</script>

<link href="../images/favicon.png" rel="shortcut icon"></head>
<body>
<div id="page-header">
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p>
<p class="apache">Serveur HTTP Apache Version 2.4</p>
<img alt="" src="../images/feather.png"></div>
<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif"></a></div>
<div id="path">
<a href="https://www.apache.org/">Apache</a> &gt; <a href="https://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="https://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.4</a> &gt; <a href="./">Modules</a></div>
<div id="page-content">
<div id="preamble"><h1>Module Apache mod_xml2enc</h1>
<button aria-label="Toggle language list" class="lang-toggle"><svg xmlns="http://www.w3.org/2000/svg" stroke-width="2" stroke="currentColor" fill="none" viewBox="0 0 24 24" height="16" width="16"><circle r="10" cy="12" cx="12"/><line y2="12" x2="22" y1="12" x1="2"/><path d="M12 2a15.3 15.3 0 0 1 4 10 15.3 15.3 0 0 1-4 10 15.3 15.3 0 0 1-4-10 15.3 15.3 0 0 1 4-10z"/></svg></button>
<div class="toplang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_xml2enc.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_xml2enc.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div>
<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Support avanc&eacute; de l'internationalisation et des jeux de
caract&egrave;res pour les modules de filtrage bas&eacute;s sur libxml2</td></tr>
<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur&nbsp;de&nbsp;Module:</a></th><td>xml2enc_module</td></tr>
<tr><th><a href="module-dict.html#SourceFile">Fichier&nbsp;Source:</a></th><td>mod_xml2enc.c</td></tr>
<tr><th><a href="module-dict.html#Compatibility">Compatibilit&eacute;:</a></th><td>Disponible depuis la version 2.4 du serveur HTTP Apache.
Disponible en tant que module tiers dans les versions 2.2.x</td></tr></table>
<h3>Sommaire</h3>

    <p>Ce module fournit un support avanc&eacute; de l'internationalisation
    pour les modules de filtrage supportant les balises (markup-aware)
    comme <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code>. Il est capable de d&eacute;tecter
    automatiquement l'encodage des donn&eacute;es en entr&eacute;e et de s'assurer
    qu'elle sont trait&eacute;es correctement par l'interpr&eacute;teur <a href="http://xmlsoft.org/">libxml2</a>, y compris la conversion en
    Unicode (UTF-8) si n&eacute;cessaire. Il peut aussi convertir les donn&eacute;es
    dans l'encodage de votre choix apr&egrave;s le traitement des balises, et
    s'assurera que le <var>jeu de caract&egrave;res</var> appropri&eacute; sera d&eacute;fini
    dans l'en-t&ecirc;te HTTP <var>Content-Type</var>.</p>
</div>
<div id="quickview"><h3>Sujets</h3>
<ul id="topics">
<li><img alt="" src="../images/down.gif"> <a href="#usage">Utilisation</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#api">API de programmation</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#sniffing">D&eacute;tection et encodage</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#output">Codage en sortie</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#alias">Codages non support&eacute;s</a></li>
</ul><h3 class="directives">Directives</h3>
<ul id="toc">
<li><img alt="" src="../images/down.gif"> <a href="#xml2encalias">xml2EncAlias</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#xml2encdefault">xml2EncDefault</a></li>
<li><img alt="" src="../images/down.gif"> <a href="#xml2startparse">xml2StartParse</a></li>
</ul>
<h3>Traitement des bugs</h3><ul class="seealso"><li><a href="https://www.apache.org/dist/httpd/CHANGES_2.4">Journal des modifications de httpd</a></li><li><a href="https://bz.apache.org/bugzilla/buglist.cgi?bug_status=__open__&amp;list_id=144532&amp;product=Apache%20httpd-2&amp;query_format=specific&amp;order=changeddate%20DESC%2Cpriority%2Cbug_severity&amp;component=mod_xml2enc">Probl&egrave;mes connus</a></li><li><a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2&amp;component=mod_xml2enc">Signaler un bug</a></li></ul></div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="usage">Utilisation <a title="Lien permanent" href="#usage" class="permalink">&para;</a></h2>
    <p>Il existe deux sc&eacute;narios d'utilisation : le cas des modules
    programm&eacute;s pour travailler avec mod_xml2enc ; et les autres :</p>
    <dl>
    <dt>Modules de filtrages programm&eacute;s pour mod_xml2enc</dt><dd>
    <p>Les modules comme <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code> versions 3.1 et
    sup&eacute;rieures utilisent la fonction optionnelle
    <code>xml2enc_charset</code> pour d&eacute;terminer la valeur de l'argument
    "jeu de caract&egrave;res" &agrave; transmettre &agrave; l'interpr&eacute;teur libxml2, et
    disposent de la fonction optionnelle <code>xml2enc_filter</code>
    pour effectuer un encodage ult&eacute;rieur &eacute;ventuel. L'utilisation de
    mod_xml2enc avec un module pr&eacute;programm&eacute; &agrave; cet effet ne n&eacute;cessite
    aucune configuration : ce dernier configurera mod_xml2enc pour vous
    (sachant que vous pouvez tout de m&ecirc;me le personnaliser via les
    directives de configuration ci-dessous).</p>
    </dd>
    <dt>Modules de filtrages non programm&eacute;s pour mod_xml2enc</dt><dd>
    <p>Pour utiliser mod_xml2enc avec un module bas&eacute; sur libxml2 qui n'a
    pas &eacute;t&eacute; explicitement programm&eacute; pour mod_xml2enc, vous devrez
    configurer la cha&icirc;ne de filtrage vous-m&ecirc;me. Ainsi, pour utiliser
    mod_xml2enc avec un filtre <strong>foo</strong> fourni par un module
    <strong>mod_foo</strong> et pour
    am&eacute;liorer le support i18n de ce dernier avec HTML et XML, vous
    pouvez utiliser les directives suivantes :</p>
    <pre><code>
    FilterProvider iconv    xml2enc Content-Type $text/html
    FilterProvider iconv    xml2enc Content-Type $xml
    FilterProvider markup   foo Content-Type $text/html
    FilterProvider markup   foo Content-Type $xml
    FilterChain     iconv markup
    </code></pre>
    <p><strong>mod_foo</strong> supportera alors tout jeu de caract&egrave;re support&eacute; soit par
    libxml2, soit par apr_xlate/iconv, soit par les deux.</p>
    </dd></dl>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="api">API de programmation <a title="Lien permanent" href="#api" class="permalink">&para;</a></h2>
    <p>Les programmeurs de modules de filtrage bas&eacute;s sur libxml2 sont
    encourag&eacute;s &agrave; les pr&eacute;programmer pour mod_xml2enc, afin de fournir un
    support i18n solide aux utilisateurs sans avoir &agrave; r&eacute;inventer la
    roue. L'API de programmation est d&eacute;crite dans
    <var>mod_xml2enc.h</var>, et <code class="module"><a href="../mod/mod_proxy_html.html">mod_proxy_html</a></code> est un
    exemple de son utilisation.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="sniffing">D&eacute;tection et encodage <a title="Lien permanent" href="#sniffing" class="permalink">&para;</a></h2>
    <p>A la diff&eacute;rence de <code class="module"><a href="../mod/mod_charset_lite.html">mod_charset_lite</a></code>, mod_xml2enc
    est con&ccedil;u pour travailler avec des donn&eacute;es dont l'encodage ne peut
    pas &ecirc;tre connu, et donc configur&eacute;, &agrave; l'avance. Il utilise donc les
    techniques de 'reniflage' suivantes pour d&eacute;tecter le type d'encodage
    des donn&eacute;es HTTP :</p>
    <ol>
        <li>Si l'en-t&ecirc;te HTTP <var>Content-Type</var> contient un
	param&egrave;tre <var>charset</var>, c'est ce dernier qui sera utilis&eacute;.</li>
        <li>Si les donn&eacute;es commancent par une balise XML concernant
	l'ordre des octets (BOM) ou par une d&eacute;claration d'encodage XML,
	c'est celle-ci qui sera utilis&eacute;e.</li>
        <li>Si un type d'encodage est d&eacute;clar&eacute; dans un &eacute;l&eacute;ment HTML
	<code>&lt;META&gt;</code>, c'est ce dernier qui sera utilis&eacute;.</li>
        <li>Si aucun des &eacute;l&eacute;ments pr&eacute;c&eacute;dents n'est trouv&eacute;, c'est la
	valeur par d&eacute;faut d&eacute;finie par la directive
	<code class="directive">xml2EncDefault</code> qui sera utilis&eacute;e.</li>
    </ol>
    <p>Les conditions sont test&eacute;es dans cet ordre . D&egrave;s qu'une r&egrave;gle
    s'applique, elle est utilis&eacute;e et la d&eacute;tection est termin&eacute;e.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="output">Codage en sortie <a title="Lien permanent" href="#output" class="permalink">&para;</a></h2>
<p><a href="http://xmlsoft.org/">libxml2</a> utilise toujours UTF-8
(Unicode) en interne, et les modules de filtrage bas&eacute;s sur libxml2
utiliseront cet encodage en sortie par d&eacute;faut. mod_xml2enc peut modifier
l'encodage en sortie via l'API, mais il n'y a actuellement aucun moyen de le
configurer directement.</p>
<p>La modification de l'encodage en sortie ne devrait (du moins en th&eacute;orie)
jamais &ecirc;tre n&eacute;cessaire, et est m&ecirc;me d&eacute;conseill&eacute;e &agrave; cause de la charge de
traitement suppl&eacute;mentaire impos&eacute;e au serveur par une conversion non
n&eacute;cessaire.</p>
</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="section">
<h2 id="alias">Codages non support&eacute;s <a title="Lien permanent" href="#alias" class="permalink">&para;</a></h2>
<p>Si vous travaillez avec des encodages non support&eacute;s par aucune des
m&eacute;thodes de conversion disponibles sur votre plateforme, vous pouvez
tout de m&ecirc;me leur associer un alias vers un code support&eacute; via la
directive <code class="directive">xml2EncAlias</code>.</p>
</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="xml2encalias">Directive <span id="xml2EncAlias">xml2EncAlias</span> <a title="Lien permanent" href="#xml2encalias" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D&eacute;finit des alias pour les valeurs d'encodage</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>xml2EncAlias <var>jeu-de-caract&egrave;res alias [alias ...]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_xml2enc</td></tr>
</table>
    <p>Cette directive de niveau serveur permet de d&eacute;finir un ou
    plusieurs alias pour un encodage. Elle permet au support d'encodage de
    libxml2 de traiter en interne des encodages non reconnus par libxml2
    en utilisant la table de conversion pour un encodage reconnu. Elle
    permet d'atteindre deux objectifs : supporter des jeux (ou noms) de
    caract&egrave;res non reconnus par libxml2 ou iconv, et &eacute;viter une
    conversion pour un encodage lorsque cela n'est pas n&eacute;cessaire.</p>

</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="xml2encdefault">Directive <span id="xml2EncDefault">xml2EncDefault</span> <a title="Lien permanent" href="#xml2encdefault" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>D&eacute;finit un encodage par d&eacute;faut &agrave; utiliser lorsqu'aucune
information ne peut &ecirc;tre <a href="#sniffing">automatiquement d&eacute;tect&eacute;e</a></td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>xml2EncDefault <var>nom</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_xml2enc</td></tr>
</table>
    <p>Si vous traitez des donn&eacute;es dont l'encodage est connu, mais ne
    contenant aucune information &agrave; propos de ce dernier, vous pouvez
    d&eacute;finir une valeur par d&eacute;faut afin d'aider mod_xml2enc &agrave; traiter
    correctement les donn&eacute;es. Par exemple, pour d&eacute;finir la valeur par
    d&eacute;faut Latin1 (<var>iso-8859-1</var>) specifi&eacute;e dans HTTP/1.0,
    utilisez :</p>
    <pre class="prettyprint lang-config">xml2EncDefault iso-8859-1</pre>


</div>
<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif"></a></div>
<div class="directive-section"><h2 id="xml2startparse">Directive <span id="xml2StartParse">xml2StartParse</span> <a title="Lien permanent" href="#xml2startparse" class="permalink">&para;</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Indique &agrave; l'interpr&eacute;teur &agrave; partir de quelle balise il doit
commencer son traitement.</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>xml2StartParse <var>&eacute;l&eacute;ment [&eacute;l&eacute;ment ...]</var></code></td></tr>
<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration globale, serveur virtuel, r&eacute;pertoire, .htaccess</td></tr>
<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_xml2enc</td></tr>
</table>
    <p>Cette directive permet de sp&eacute;cifier &agrave; partir de quelle balise,
    parmi les &eacute;l&eacute;ments sp&eacute;cifi&eacute;s, l'interpr&eacute;teur de balise doit
    commencer son traitement. Ccei permet de contourner le probl&egrave;me des
    serveurs d'arri&egrave;re-plan qui ins&egrave;rent des &eacute;l&eacute;ments non conformes en
    d&eacute;but de donn&eacute;es, ce qui a pour effet de perturber l'interpr&eacute;teur (<a href="http://bahumbug.wordpress.com/2006/10/12/mod_proxy_html-revisited/">voir un exemple ici</a>).</p>
    <p>Elle ne doit &ecirc;tre utilis&eacute;e ni pour les documents XML, ni pour les
    documents HTML correctement format&eacute;s.</p>

</div>
</div>
<div class="bottomlang">
<p><span>Langues Disponibles: </span><a href="../en/mod/mod_xml2enc.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
<a href="../fr/mod/mod_xml2enc.html" title="Fran&ccedil;ais">&nbsp;fr&nbsp;</a></p>
</div><div id="footer">
<p class="apache">Copyright 2026 The Apache Software Foundation.<br>Autoris&eacute; sous <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.html">Directives</a> | <a href="https://cwiki.apache.org/confluence/display/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a> | <a href="https://bz.apache.org/bugzilla/enter_bug.cgi?product=Apache%20httpd-2">Signaler un bug</a></p></div><script><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
    prettyPrint();
}
var langToggle = document.querySelector('.lang-toggle');
var topLang = document.querySelector('.toplang');
if (langToggle && topLang) {
    langToggle.addEventListener('click', function() { topLang.classList.toggle('open'); });
}
var qv = document.getElementById('quickview');
if (qv) {
    document.body.appendChild(qv);
    var qvBtn = document.createElement('button');
    qvBtn.className = 'qv-toggle';
    qvBtn.setAttribute('aria-label', 'Toggle page navigation');
    qvBtn.innerHTML = '&#9776;';
    document.body.appendChild(qvBtn);
    qvBtn.addEventListener('click', function() {
        var isOpen = qv.classList.toggle('open');
        if (isOpen) {
            qv.style.top = window.scrollY + 10 + 'px';
        }
    });
    window.addEventListener('scroll', function() { qv.classList.remove('open'); });
}
//--><!]]></script>
</body></html>