logging-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ihabu...@apache.org
Subject svn commit: r1180134 [38/43] - in /logging/site/trunk/docs/log4php: ./ apidocs/ apidocs/log4php/ apidocs/log4php/appenders/ apidocs/log4php/configurators/ apidocs/log4php/filters/ apidocs/log4php/helpers/ apidocs/log4php/layouts/ apidocs/log4php/render...
Date Fri, 07 Oct 2011 18:26:14 GMT
Modified: logging/site/trunk/docs/log4php/docs/appender/appender.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4php/docs/appender/appender.html?rev=1180134&r1=1180133&r2=1180134&view=diff
==============================================================================
--- logging/site/trunk/docs/log4php/docs/appender/appender.html (original)
+++ logging/site/trunk/docs/log4php/docs/appender/appender.html Fri Oct  7 18:26:07 2011
@@ -1,19 +1,34 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Aug 30, 2011 -->
+<!-- Generated by Apache Maven Doxia at Oct 7, 2011 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <title>Apache log4php - Appenders</title>
+    <title>Appenders</title>
     <style type="text/css" media="all">
       @import url("../../css/maven-base.css");
       @import url("../../css/maven-theme.css");
       @import url("../../css/site.css");
     </style>
     <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20110830" />
+    <meta name="Date-Revision-yyyymmdd" content="20111007" />
     <meta http-equiv="Content-Language" content="en" />
         
-        </head>
+          <!-- Google Analytics -->
+    <script type="text/javascript">
+    
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-26177991-1']);
+      _gaq.push (['_gat._anonymizeIp']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
   <body class="composite">
     <div id="banner">
                                       <a href="../../../" id="bannerLeft">
@@ -27,15 +42,15 @@
             
         
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2011-08-30</span>
-                  &nbsp;| <span id="projectVersion">Version: 2.1.0</span>
+        <span id="publishDate">Last Published: 2011-10-07</span>
+                  &nbsp;| <span id="projectVersion">Version: 2.1.1-SNAPSHOT</span>
                           |                           <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
         &gt;
-                          <a href="http://logging.apache.org" class="externalLink" title="Logging">Logging</a>
+                          <a href="../../.." title="Logging">Logging</a>
         &gt;
-                          <a href="http://logging.apache.org/log4php" class="externalLink" title="log4php">log4php</a>
+                          <a href="../.././" title="log4php">log4php</a>
         &gt;
-    Apache log4php - Appenders
+    Appenders
               </div>
             <div class="xright">        
         
@@ -197,28 +212,28 @@ log4php.appender.secundus.file = /var/lo
 log4php.logger.main = DEBUG, primus, secundus
 </pre></div><p>This configuration file defines two appenders: <i>primus</i> and <i>secundus</i>, and links them to a logger named <i>main</i>. </p><p>Now, when a logging request is issued to the <i>main</i> logger:</p><div class="source"><pre>$logger = Logger::getLogger('main');
 $logger-&gt;info(&quot;Log this.&quot;);
-</pre></div><p>The logger will forward this logging requests to all appenders which are linked with it. In our example, the output will be written both to console and to the file.</p></div><div class="section"><h3><a name="Appender_Reference">Appender Reference</a><a name="Appender_Reference"></a></h3><p>The following appenders are included with log4php.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Destination</th></tr><tr class="b"><td align="left"><a href="#LoggerAppenderEcho">LoggerAppenderEcho</a></td><td align="left">Console, using the PHP <b>echo</b> command.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderConsole">LoggerAppenderConsole</a></td><td align="left">STDOUT or STDERR</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderFile">LoggerAppenderFile</a></td><td align="left">A file.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderDailyFile">LoggerAppenderDailyFile</a></td>
 <td align="left">A file (new file each day).</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderRollingFile">LoggerAppenderRollingFile</a></td><td align="left">A file (new file when a specified size has been reached).</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderMail">LoggerAppenderMail</a></td><td align="left">Sends the log via email. The entire log is sent in one email.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderMailEvent">LoggerAppenderMailEvent</a></td><td align="left">Sends the log via email. Each log entry is sent in individual emails.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderMongoDB">LoggerAppenderMongoDB</a></td><td align="left">MongoDB.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderNull">LoggerAppenderNull</a></td><td align="left">Ignores all log events.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderPDO">LoggerAppenderPDO</a></td><td align="left">Database.
 </td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderPhp">LoggerAppenderPhp</a></td><td align="left">Creates a PHP user-level message using the PHP <b>trigger_error</b> function.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderSocket">LoggerAppenderSocket</a></td><td align="left">A network socket.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderSyslog">LoggerAppenderSyslog</a></td><td align="left">Syslog.</td></tr></table><div class="section"><h4><a name="LoggerAppenderEcho">LoggerAppenderEcho</a><a name="LoggerAppenderEcho"></a></h4><p>The LoggerAppenderEcho appender writes logging events using PHP's <a class="externalLink" href="http://php.net/manual/en/function.echo.php">echo</a> function. Echo outputs may be buffered.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th al
 ign="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">htmlLineBreaks</td><td align="center">No</td><td align="left">false</td><td align="left">If set to true, a &lt;br /&gt; element will be inserted before each line break in the logged message.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderEcho&quot;&gt;
+</pre></div><p>The logger will forward this logging requests to all appenders which are linked with it. In our example, the output will be written both to console and to the file.</p></div><div class="section"><h3><a name="Appender_Reference">Appender Reference</a></h3><p>The following appenders are included with log4php.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Destination</th></tr><tr class="b"><td align="left"><a href="#LoggerAppenderEcho">LoggerAppenderEcho</a></td><td align="left">Console, using the PHP <b>echo</b> command.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderConsole">LoggerAppenderConsole</a></td><td align="left">STDOUT or STDERR</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderFile">LoggerAppenderFile</a></td><td align="left">A file.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderDailyFile">LoggerAppenderDailyFile</a></td><td align="left">A file (new file
  each day).</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderRollingFile">LoggerAppenderRollingFile</a></td><td align="left">A file (new file when a specified size has been reached).</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderMail">LoggerAppenderMail</a></td><td align="left">Sends the log via email. The entire log is sent in one email.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderMailEvent">LoggerAppenderMailEvent</a></td><td align="left">Sends the log via email. Each log entry is sent in individual emails.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderMongoDB">LoggerAppenderMongoDB</a></td><td align="left">MongoDB.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderNull">LoggerAppenderNull</a></td><td align="left">Ignores all log events.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderPDO">LoggerAppenderPDO</a></td><td align="left">Database.</td></tr><tr class="b"><td align
 ="left"><a href="#LoggerAppenderPhp">LoggerAppenderPhp</a></td><td align="left">Creates a PHP user-level message using the PHP <b>trigger_error</b> function.</td></tr><tr class="a"><td align="left"><a href="#LoggerAppenderSocket">LoggerAppenderSocket</a></td><td align="left">A network socket.</td></tr><tr class="b"><td align="left"><a href="#LoggerAppenderSyslog">LoggerAppenderSyslog</a></td><td align="left">Syslog.</td></tr></table><div class="section"><h4><a name="LoggerAppenderEcho">LoggerAppenderEcho</a></h4><p>The LoggerAppenderEcho appender writes logging events using PHP's <a class="externalLink" href="http://php.net/manual/en/function.echo.php">echo</a> function. Echo outputs may be buffered.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr
 ><tr class="b"><td align="left">htmlLineBreaks</td><td align="center">No</td><td align="left">false</td><td align="left">If set to true, a &lt;br /&gt; element will be inserted before each line break in the logged message.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderEcho&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;htmlLineBreaks&quot; value=&quot;true&quot; /&gt;
 &lt;/appender&gt;
 </pre></div><p>Configuration via ini file:</p><div class="source"><pre>log4php.appender.default = LoggerAppenderEcho
 log4php.appender.default.layout = LoggerLayoutTTCC
 log4php.appender.default.htmlLineBreaks = &quot;true&quot;
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderConsole">LoggerAppenderConsole</a><a name="LoggerAppenderConsole"></a></h4><p>The LoggerAppenderConsoler appender writes logging events to the STDOUT (php://stdout) or STDERR (php://stderr) stream. Defaults to STDOUT.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">target</td><td align="center">No</td><td align="left">stdout</td><td align="left">Sets the otuput stream to which this appender should write to. Possible values are &quot;stdout&quot; for standard output stream and &quot;stderr&quot; for standard error stream.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div clas
 s="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderConsole&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderConsole">LoggerAppenderConsole</a></h4><p>The LoggerAppenderConsoler appender writes logging events to the STDOUT (php://stdout) or STDERR (php://stderr) stream. Defaults to STDOUT.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">target</td><td align="center">No</td><td align="left">stdout</td><td align="left">Sets the otuput stream to which this appender should write to. Possible values are &quot;stdout&quot; for standard output stream and &quot;stderr&quot; for standard error stream.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&q
 uot;default&quot; class=&quot;LoggerAppenderConsole&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;target&quot; value=&quot;STDOUT&quot; /&gt;
 &lt;/appender&gt;
 </pre></div><p>Configuration via ini file:</p><div class="source"><pre>log4php.appender.console = LoggerAppenderConsole
 log4php.appender.console.target = STDOUT
 log4php.appender.console.layout = LoggerLayoutTTCC
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderFile">LoggerAppenderFile</a><a name="LoggerAppenderFile"></a></h4><p>The LoggerAppenderFile writes logging events to a file.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Path to the target file.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) or truncate the file before writing (&quot;false&quot;).</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</
 p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderFile&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderFile">LoggerAppenderFile</a></h4><p>The LoggerAppenderFile writes logging events to a file.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Path to the target file.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) or truncate the file before writing (&quot;false&quot;).</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;ap
 pender name=&quot;default&quot; class=&quot;LoggerAppenderFile&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;file&quot; value=&quot;target/examples/file.log&quot; /&gt;
 &lt;/appender&gt;
 </pre></div><p>Configuration via ini file:</p><div class="source"><pre>log4php.appender.default = LoggerAppenderFile
 log4php.appender.default.file = target/examples/file.log
 log4php.appender.default.layout = LoggerLayoutTTCC
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderDailyFile">LoggerAppenderDailyFile</a><a name="LoggerAppenderDailyFile"></a></h4><p>The LoggerAppenderDailyFile writes logging events to a specified file. The file is rolled over once a day. That means, for each day a new file is created.</p><p>The path specified in the <i>file</i> parameter should contain the string '%s' which will be substituted with the current date when logging. The <i>datePattern</i> parameter determines how the date will be formatted. It follows the formatting rules used by <a class="externalLink" href="http://php.net/manual/en/function.date.php">PHP's date function</a>.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file<
 /td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Path to the target file. Should contain a '%s' which gets substituted by the date.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) or truncate the file before writing (&quot;false&quot;).</td></tr><tr class="b"><td align="left">datePattern</td><td align="center">No</td><td align="left">Ymd</td><td align="left">Date format for the date in the file path.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderDailyFile&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderDailyFile">LoggerAppenderDailyFile</a></h4><p>The LoggerAppenderDailyFile writes logging events to a specified file. The file is rolled over once a day. That means, for each day a new file is created.</p><p>The path specified in the <i>file</i> parameter should contain the string '%s' which will be substituted with the current date when logging. The <i>datePattern</i> parameter determines how the date will be formatted. It follows the formatting rules used by <a class="externalLink" href="http://php.net/manual/en/function.date.php">PHP's date function</a>.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file</td><td align="center"><b>Yes</b></td>
 <td align="left">-</td><td align="left">Path to the target file. Should contain a '%s' which gets substituted by the date.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) or truncate the file before writing (&quot;false&quot;).</td></tr><tr class="b"><td align="left">datePattern</td><td align="center">No</td><td align="left">Ymd</td><td align="left">Date format for the date in the file path.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderDailyFile&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;datePattern&quot; value=&quot;Y-m-d&quot; /&gt;
     &lt;param name=&quot;file&quot; value=&quot;/var/log/daily_%s.log&quot; /&gt;
@@ -227,7 +242,7 @@ log4php.appender.default.layout = Logger
 log4php.appender.default.layout = LoggerLayoutTTCC
 log4php.appender.default.datePattern = Y-m-d
 log4php.appender.default.file = /var/log/daily_%s.log
-</pre></div><p>Let's say, for example, that today is May 5th 2010. Using the above configuration, LoggerAppenderDailyFile will log to <i>/var/log/daily_2010-05-05.log</i></p></div></div><div class="section"><h4><a name="LoggerAppenderRollingFile">LoggerAppenderRollingFile</a><a name="LoggerAppenderRollingFile"></a></h4><p>The LoggerAppenderDailyFile appender writes logging events to a file. The file is rolled over after a specified size has been reached. </p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Path to the target file.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) o
 r truncate the file before writing (&quot;false&quot;).</td></tr><tr class="b"><td align="left">datePattern</td><td align="center">No</td><td align="left">Ymd</td><td align="left">Date format for the date in the file path.</td></tr><tr class="a"><td align="left">maxBackupIndex</td><td align="center">No</td><td align="left">1</td><td align="left">Maximum number of backup files to keep.</td></tr><tr class="b"><td align="left">maxFileSize</td><td align="center">No</td><td align="left">10MB</td><td align="left">Maximum allowed file size (in bytes) before rolling over. Suffixes &quot;KB&quot;, &quot;MB&quot; and &quot;GB&quot; are allowed. 10KB = 10240 bytes, etc.</td></tr></table><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderRollingFile&quot;&gt;
+</pre></div><p>Let's say, for example, that today is May 5th 2010. Using the above configuration, LoggerAppenderDailyFile will log to <i>/var/log/daily_2010-05-05.log</i></p></div></div><div class="section"><h4><a name="LoggerAppenderRollingFile">LoggerAppenderRollingFile</a></h4><p>The LoggerAppenderDailyFile appender writes logging events to a file. The file is rolled over after a specified size has been reached. </p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">file</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Path to the target file.</td></tr><tr class="a"><td align="left">append</td><td align="center">No</td><td align="left">true</td><td align="left">Defines if the appender should append to the end of the file (&quot;true&quot;) or truncate the file before writing (&quo
 t;false&quot;).</td></tr><tr class="b"><td align="left">datePattern</td><td align="center">No</td><td align="left">Ymd</td><td align="left">Date format for the date in the file path.</td></tr><tr class="a"><td align="left">maxBackupIndex</td><td align="center">No</td><td align="left">1</td><td align="left">Maximum number of backup files to keep.</td></tr><tr class="b"><td align="left">maxFileSize</td><td align="center">No</td><td align="left">10MB</td><td align="left">Maximum allowed file size (in bytes) before rolling over. Suffixes &quot;KB&quot;, &quot;MB&quot; and &quot;GB&quot; are allowed. 10KB = 10240 bytes, etc.</td></tr></table><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderRollingFile&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;file&quot; value=&quot;target/examples/appender_rollingfile.log&quot; /&gt;
     &lt;param name=&quot;maxFileSize&quot; value=&quot;10MB&quot; /&gt;
@@ -238,7 +253,7 @@ log4php.appender.default.layout = Logger
 log4php.appender.default.file = target/examples/appender_rollingfile.log
 log4php.appender.default.maxFileSize = 10MB
 log4php.appender.default.maxBackupIndex = 3
-</pre></div><p>The resulting filenames are appender_rollingfile.log, appender_rollingfile.log.1, appender_rollingfile.log.2 and so on.</p></div></div><div class="section"><h4><a name="LoggerAppenderMail">LoggerAppenderMail</a><a name="LoggerAppenderMail"></a></h4><p>The LoggerAppenderMail appends log events via email. </p><p>This appender will not send individual emails for each logging requests, but will collect them in a buffer and send them all in a single email once the appender is closed. </p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">to</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address to which the log will be sent</td></tr><tr class="a"><td align="left">from</td><td 
 align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address of the sender</td></tr><tr class="b"><td align="left">subject</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Subject of the mail</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMail&quot;&gt;
+</pre></div><p>The resulting filenames are appender_rollingfile.log, appender_rollingfile.log.1, appender_rollingfile.log.2 and so on.</p></div></div><div class="section"><h4><a name="LoggerAppenderMail">LoggerAppenderMail</a></h4><p>The LoggerAppenderMail appends log events via email. </p><p>This appender will not send individual emails for each logging requests, but will collect them in a buffer and send them all in a single email once the appender is closed. </p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">to</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address to which the log will be sent</td></tr><tr class="a"><td align="left">from</td><td align="center"><b>Yes</b></td><td
  align="left">-</td><td align="left">Email address of the sender</td></tr><tr class="b"><td align="left">subject</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Subject of the mail</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMail&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;from&quot; value=&quot;someone@example.com&quot; /&gt;
     &lt;param name=&quot;to&quot; value=&quot;root@localhost&quot; /&gt;
@@ -249,7 +264,7 @@ log4php.appender.default.layout = Logger
 log4php.appender.default.from = someone@example.com
 log4php.appender.default.to = root@localhost
 log4php.appender.default.subject = log4php test
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderMailEvent">LoggerAppenderMailEvent</a><a name="LoggerAppenderMailEvent"></a></h4><p>The LoggerAppenderMailEvent appends log events to mail.</p><p>This appender is similar to the LoggerAppenderMail appender, except that it sends each each log event in an individual email message at the time when it occurs.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">to</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address to which the log will be sent</td></tr><tr class="a"><td align="left">from</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address of the sender</td></tr><tr class="b">
 <td align="left">subject</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Subject of the mail</td></tr><tr class="a"><td align="left">smtpHost</td><td align="center">No</td><td align="left">ini_get('SMTP')</td><td align="left">Used to override the SMTP server used for sending the email. <b>Only works on Windows</b></td></tr><tr class="b"><td align="left">port</td><td align="center">No</td><td align="left">25</td><td align="left">Used to override the default SMTP server port. <b>Only works on Windows</b></td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMailEvent&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderMailEvent">LoggerAppenderMailEvent</a></h4><p>The LoggerAppenderMailEvent appends log events to mail.</p><p>This appender is similar to the LoggerAppenderMail appender, except that it sends each each log event in an individual email message at the time when it occurs.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">to</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address to which the log will be sent</td></tr><tr class="a"><td align="left">from</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Email address of the sender</td></tr><tr class="b"><td align="left">subject</td><td align
 ="center"><b>Yes</b></td><td align="left">-</td><td align="left">Subject of the mail</td></tr><tr class="a"><td align="left">smtpHost</td><td align="center">No</td><td align="left">ini_get('SMTP')</td><td align="left">Used to override the SMTP server used for sending the email. <b>Only works on Windows</b></td></tr><tr class="b"><td align="left">port</td><td align="center">No</td><td align="left">25</td><td align="left">Used to override the default SMTP server port. <b>Only works on Windows</b></td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMailEvent&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
     &lt;param name=&quot;from&quot; value=&quot;someone@example.com&quot; /&gt;
     &lt;param name=&quot;to&quot; value=&quot;root@localhost&quot; /&gt;
@@ -260,7 +275,7 @@ log4php.appender.default.layout = Logger
 log4php.appender.default.from = someone@example.com
 log4php.appender.default.to = root@localhost
 log4php.appender.default.subject = log4php test
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderMongoDB">LoggerAppenderMongoDB</a><a name="LoggerAppenderMongoDB"></a></h4><p>The LoggerAppenderMongoDB appends log events to a mongoDB instance.</p><p><a class="externalLink" href="http://www.mongodb.org/">MongoDB</a> is a scalable, high-performance, open source, document-oriented database.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">host</td><td align="center">No</td><td align="left">mongodb://localhost</td><td align="left">Server on which mongodb instance is located.</td></tr><tr class="a"><td align="left">port</td><td align="center">No</td><td align="left">27017</td><td align="left">Port on which the instance is bound.</td></tr><tr class=
 "b"><td align="left">databaseName</td><td align="center">No</td><td align="left">log4php_mongodb</td><td align="left">Name of the database to which to log.</td></tr><tr class="a"><td align="left">collectionName</td><td align="center">No</td><td align="left">logs</td><td align="left">Name of the collection within the given database.</td></tr><tr class="b"><td align="left">username</td><td align="center">No</td><td align="left">-</td><td align="left">Username used to connect to the database.</td></tr><tr class="a"><td align="left">password</td><td align="center">No</td><td align="left">-</td><td align="left">Password used to connect to the database.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMongoDB&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderMongoDB">LoggerAppenderMongoDB</a></h4><p>The LoggerAppenderMongoDB appends log events to a mongoDB instance.</p><p><a class="externalLink" href="http://www.mongodb.org/">MongoDB</a> is a scalable, high-performance, open source, document-oriented database.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">host</td><td align="center">No</td><td align="left">mongodb://localhost</td><td align="left">Server on which mongodb instance is located.</td></tr><tr class="a"><td align="left">port</td><td align="center">No</td><td align="left">27017</td><td align="left">Port on which the instance is bound.</td></tr><tr class="b"><td align="left">databaseName</t
 d><td align="center">No</td><td align="left">log4php_mongodb</td><td align="left">Name of the database to which to log.</td></tr><tr class="a"><td align="left">collectionName</td><td align="center">No</td><td align="left">logs</td><td align="left">Name of the collection within the given database.</td></tr><tr class="b"><td align="left">username</td><td align="center">No</td><td align="left">-</td><td align="left">Username used to connect to the database.</td></tr><tr class="a"><td align="left">password</td><td align="center">No</td><td align="left">-</td><td align="left">Password used to connect to the database.</td></tr></table></div><div class="section"><h5>Examples<a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderMongoDB&quot;&gt;
     &lt;param name=&quot;host&quot; value=&quot;mongodb://myhost.com&quot; /&gt;
     &lt;param name=&quot;username&quot; value=&quot;logger&quot; /&gt;
     &lt;param name=&quot;password&quot; value=&quot;secret&quot; /&gt;
@@ -269,9 +284,9 @@ log4php.appender.default.subject = log4p
 log4php.appender.default.host = mongodb://myhost.com
 log4php.appender.default.username = logger
 log4php.appender.default.password = secret
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderNull">LoggerAppenderNull</a><a name="LoggerAppenderNull"></a></h4><p>The LoggerAppenderNull appender ignores all log events.</p><p>This appender does not use a layout and has no configurable parameters.</p><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderNull&quot; /&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderNull">LoggerAppenderNull</a></h4><p>The LoggerAppenderNull appender ignores all log events.</p><p>This appender does not use a layout and has no configurable parameters.</p><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderNull&quot; /&gt;
 </pre></div><p>Configuration via ini file:</p><div class="source"><pre>log4php.appender.default = LoggerAppenderNull
-</pre></div></div><div class="section"><h4><a name="LoggerAppenderPDO">LoggerAppenderPDO</a><a name="LoggerAppenderPDO"></a></h4><p>The LoggerAppenderPDO appender logs to a database using the PHP's <a class="externalLink" href="http://php.net/manual/en/book.pdo.php">PDO extension</a>.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">dsn</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The Data Source Name (DSN) used to connect to the database.</td></tr><tr class="a"><td align="left">user</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Username used to connect to the database.</td></tr><tr class="b"><td align="left">password</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Password used to connect to the database.</td></t
 r><tr class="a"><td align="left">createTable</td><td align="center">No</td><td align="left">true</td><td align="left">Create the table if it does not exist? (&quot;true&quot; or &quot;false&quot;)</td></tr><tr class="b"><td align="left">table</td><td align="center">No</td><td align="left">log4php_log</td><td align="left">Name of the table to which log entries should be inserted.</td></tr><tr class="a"><td align="left">insertSql</td><td align="center">No</td><td align="left"><i>see below</i></td><td align="left">SQL query used to insert a log event.</td></tr><tr class="b"><td align="left">insertPattern</td><td align="center">No</td><td align="left"><i>see below</i></td><td align="left">A comma separated list of <i>LoggerPatternLayout</i> format strings used in <i>insertSql</i> parameter.</td></tr></table><p>Parameters <i>dsn</i>, <i>user</i> and <i>password</i> are used by PDO to connect to the database which will be used for logging. For available database drivers and corres
 ponding DSN format, please see the <a class="externalLink" href="http://www.php.net/manual/en/pdo.drivers.php">PDO driver documentation</a>.</p><div class="section"><h5>Advanced configuration <a name="Advanced_configuration"></a></h5><p>Parameters <i>insertSql</i> and <i>insertPattern</i> can be used to change how events are inserted into the database. By manipulating them, it is possible to use a custom table structure to suit your needs.</p><div class="source"><pre>  WARNING: Change these settings only if you are sure what you are doing.
+</pre></div></div><div class="section"><h4><a name="LoggerAppenderPDO">LoggerAppenderPDO</a></h4><p>The LoggerAppenderPDO appender logs to a database using the PHP's <a class="externalLink" href="http://php.net/manual/en/book.pdo.php">PDO extension</a>.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">dsn</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The Data Source Name (DSN) used to connect to the database.</td></tr><tr class="a"><td align="left">user</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Username used to connect to the database.</td></tr><tr class="b"><td align="left">password</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Password used to connect to the database.</td></tr><tr class="a"><td align="left"
 >createTable</td><td align="center">No</td><td align="left">true</td><td align="left">Create the table if it does not exist? (&quot;true&quot; or &quot;false&quot;)</td></tr><tr class="b"><td align="left">table</td><td align="center">No</td><td align="left">log4php_log</td><td align="left">Name of the table to which log entries should be inserted.</td></tr><tr class="a"><td align="left">insertSql</td><td align="center">No</td><td align="left"><i>see below</i></td><td align="left">SQL query used to insert a log event.</td></tr><tr class="b"><td align="left">insertPattern</td><td align="center">No</td><td align="left"><i>see below</i></td><td align="left">A comma separated list of <i>LoggerPatternLayout</i> format strings used in <i>insertSql</i> parameter.</td></tr></table><p>Parameters <i>dsn</i>, <i>user</i> and <i>password</i> are used by PDO to connect to the database which will be used for logging. For available database drivers and corresponding DSN format, please see t
 he <a class="externalLink" href="http://www.php.net/manual/en/pdo.drivers.php">PDO driver documentation</a>.</p><div class="section"><h5>Advanced configuration <a name="Advanced_configuration"></a></h5><p>Parameters <i>insertSql</i> and <i>insertPattern</i> can be used to change how events are inserted into the database. By manipulating them, it is possible to use a custom table structure to suit your needs.</p><div class="source"><pre>  WARNING: Change these settings only if you are sure what you are doing.
 </pre></div><p>By default their values are:</p><table border="1" class="bodyTable"><tr class="a"><td align="left">insertSql</td><td align="left">INSERT INTO __TABLE__ (timestamp, logger, level, message, thread, file, line) VALUES (?, ?, ?, ?, ?, ?, ?)</td></tr><tr class="b"><td align="left">insertPattern</td><td align="left">%d,%c,%p,%m,%t,%F,%L</td></tr></table><p>The string <i>__TABLE__</i> in <i>insertSql</i> will be replaced with the table name defined in the <i>table</i> parameter. Question marks in the <i>insertSql</i> will be replaced by evaluated <i>LoggerPatternLayout</i> format strings defined in <i>insertPattern</i>. See LoggerPatternLayout documentation for format string description.</p></div><div class="section"><h5>Example 1<a name="Example_1"></a></h5><p>The simplest example is connecting to an SQLite database which does not require any authentication.</p><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&qu
 ot;LoggerAppenderPDO&quot;&gt;
     &lt;param name=&quot;dsn&quot; value=&quot;sqlite:target/appender_pdo.sqlite&quot; /&gt;
 &lt;/appender&gt;
@@ -307,12 +322,12 @@ log4php.appender.default.table = my_log
  +-------------------------+--------+-------+--------------+--------+------------------------------------------------------------------+------+
  | 2009-09-08 02:31:48,532 | root   | FATAL | Hello World! | 21858  | /srv/home/james/workspace/log4php/src/examples/php/appender_pdo. | 24   |
  +-------------------------+--------+-------+--------------+--------+------------------------------------------------------------------+------+
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderPhp">LoggerAppenderPhp</a><a name="LoggerAppenderPhp"></a></h4><p>The LoggerAppenderPhp appender logs events by creating a PHP user-level message using the php function <a class="externalLink" href="http://www.php.net/manual/en/function.trigger-error.php">trigger_error</a>.</p><p>The message type depends on the event's severity level:</p><ul><li><i>E_USER_NOTICE</i> is used when the event's level is equal to or less than INFO</li><li><i>E_USER_WARNING</i> is used when the event's level is equal to WARN</li><li><i>E_USER_ERROR</i> is used when the event's level is equal to or greater than ERROR</li></ul><p>This appender has no configurable parameters.</p><div class="section"><h5>Example<a name="Example"></a></h5><p>Configuration via xml file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderPhp&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderPhp">LoggerAppenderPhp</a></h4><p>The LoggerAppenderPhp appender logs events by creating a PHP user-level message using the php function <a class="externalLink" href="http://www.php.net/manual/en/function.trigger-error.php">trigger_error</a>.</p><p>The message type depends on the event's severity level:</p><ul><li><i>E_USER_NOTICE</i> is used when the event's level is equal to or less than INFO</li><li><i>E_USER_WARNING</i> is used when the event's level is equal to WARN</li><li><i>E_USER_ERROR</i> is used when the event's level is equal to or greater than ERROR</li></ul><p>This appender has no configurable parameters.</p><div class="section"><h5>Example<a name="Example"></a></h5><p>Configuration via xml file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderPhp&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutTTCC&quot; /&gt;
 &lt;/appender&gt;
 </pre></div><p>Configuration via ini file:</p><div class="source"><pre>log4php.appender.default = LoggerAppenderPhp
 log4php.appender.default.layout = LoggerLayoutTTCC
-</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderSocket">LoggerAppenderSocket</a><a name="LoggerAppenderSocket"></a></h4><p>The LoggerAppenderSocket appender serializes log events and sends them to a network socket.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">remoteHost</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Target host. On how to define a remote hostname see <a class="externalLink" href="http://php.net/manual/en/function.fsockopen.php">fsockopen() documentation</a>.</td></tr><tr class="a"><td align="left">port</td><td align="center">No</td><td align="left">4446</td><td align="left">Target port of the socket.</td></tr><tr class="b"><td align="left">timeout</td><td align="center">No</td><td align="left">30</td><td align="left">Timeout in ms</
 td></tr><tr class="a"><td align="left">useXml</td><td align="center">No</td><td align="left">false</td><td align="left">If set to &quot;true&quot; the appender will sent the event formatted in XML, if set to &quot;false&quot; the appender will send the event as a serialized PHP object.</td></tr><tr class="b"><td align="left">locationInfo</td><td align="center">No</td><td align="left">false</td><td align="left">Whether location info is included for the XML event format. Ignored if XML format is not used.</td></tr><tr class="a"><td align="left">log4jNamespace</td><td align="center">No</td><td align="left">false</td><td align="left">In XML format, <i>log4php</i> namespace is used by default. If this parameter is set to true, <i>log4j</i> namespace will be used instead.</td></tr></table><div class="section"><h5>Example 1<a name="Example_1"></a></h5><p>In this example, log events are sent to localhost:4242, using serialized objects format. The host will recieve a serialized Logge
 rLoggingEvent object. </p><p>Configuration via xml file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderSocket&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerAppenderSocket">LoggerAppenderSocket</a></h4><p>The LoggerAppenderSocket appender serializes log events and sends them to a network socket.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">remoteHost</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">Target host. On how to define a remote hostname see <a class="externalLink" href="http://php.net/manual/en/function.fsockopen.php">fsockopen() documentation</a>.</td></tr><tr class="a"><td align="left">port</td><td align="center">No</td><td align="left">4446</td><td align="left">Target port of the socket.</td></tr><tr class="b"><td align="left">timeout</td><td align="center">No</td><td align="left">30</td><td align="left">Timeout in ms</td></tr><tr class="a"><td align="le
 ft">useXml</td><td align="center">No</td><td align="left">false</td><td align="left">If set to &quot;true&quot; the appender will sent the event formatted in XML, if set to &quot;false&quot; the appender will send the event as a serialized PHP object.</td></tr><tr class="b"><td align="left">locationInfo</td><td align="center">No</td><td align="left">false</td><td align="left">Whether location info is included for the XML event format. Ignored if XML format is not used.</td></tr><tr class="a"><td align="left">log4jNamespace</td><td align="center">No</td><td align="left">false</td><td align="left">In XML format, <i>log4php</i> namespace is used by default. If this parameter is set to true, <i>log4j</i> namespace will be used instead.</td></tr></table><div class="section"><h5>Example 1<a name="Example_1"></a></h5><p>In this example, log events are sent to localhost:4242, using serialized objects format. The host will recieve a serialized LoggerLoggingEvent object. </p><p>Config
 uration via xml file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderSocket&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutSimple&quot; /&gt;
     &lt;param name=&quot;remoteHost&quot; value=&quot;localhost&quot; /&gt;
     &lt;param name=&quot;port&quot; value=&quot;4242&quot; /&gt;
@@ -340,8 +355,9 @@ log4php.appender.default.locationInfo = 
     &lt;log4php:message&gt;&lt;![CDATA[Hello World!]]&gt;&lt;/log4php:message&gt;
     &lt;log4php:locationInfo class=&quot;main&quot; file=&quot;D:\Projects\php-devel\org.apache.log4php\src\examples\php\appender_socket.php&quot; line=&quot;23&quot; method=&quot;main&quot; /&gt;
 &lt;/log4php:event&gt;
-</pre></div><p>If <i>locationInfo</i> was set to false, the <i>log4php:locationInfo</i> would not be present. </p><p>If <i>log4jNamespace</i> was set to true, all elements would be prefixed by <i>log4j:</i> instead <i>log4php:</i>.</p></div></div><div class="section"><h4><a name="LoggerAppenderSyslog">LoggerAppenderSyslog</a><a name="LoggerAppenderSyslog"></a></h4><p>The LoggerAppenderSyslog logs events to the syslog.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">ident</td><td align="center">No</td><td align="left">Log4PHP Syslog-Event</td><td align="left">A string which will identify your appender.</td></tr><tr class="a"><td align="left">overridePriority</td><td align="center">No</td><td align="left">false</td><td align="left">If set to true, all messages will be sent to the syslog using the priority sp
 ecified in the <i>priority</i> parameter. Otherwise, the pririty will depend on the level of the event being logged. See below.</td></tr><tr class="b"><td align="left">priority</td><td align="center">No/Yes</td><td align="left">-</td><td align="left">The syslog priority to use when overriding priority. This setting is required if <i>overridePriority</i> is set to true.</td></tr><tr class="a"><td align="left">facility</td><td align="center">No</td><td align="left">USER</td><td align="left">The syslog facility. Identifies the part of the system from which the event originated. See below.</td></tr><tr class="b"><td align="left">option</td><td align="center">No</td><td align="left">PID &#xa0;u007C CONS</td><td align="left">Syslog options. See below.</td></tr></table><div class="section"><h5>Priorities<a name="Priorities"></a></h5><p>The <i>priority</i> is the syslog equivalent of the log4php level. Here's a list of priorities available in syslog and the equivalent log4php levels
 .</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Priority</th><th align="left">Description</th><th align="left">Equivalent level</th></tr><tr class="b"><td align="left">EMERG</td><td align="left">System is unusable</td><td align="left">-</td></tr><tr class="a"><td align="left">ALERT</td><td align="left">Action must be taken immediately</td><td align="left">FATAL</td></tr><tr class="b"><td align="left">CRIT</td><td align="left">Critical conditions</td><td align="left">-</td></tr><tr class="a"><td align="left">ERR</td><td align="left">Error conditions</td><td align="left">ERROR</td></tr><tr class="b"><td align="left">WARNING</td><td align="left">Warning conditions</td><td align="left">WARN</td></tr><tr class="a"><td align="left">NOTICE</td><td align="left">Normal, but significant, condition</td><td align="left">-</td></tr><tr class="b"><td align="left">INFO</td><td align="left">Informational message</td><td align="left">INFO</td></tr><tr class="a"><td al
 ign="left">DEBUG</td><td align="left">Debug-level message</td><td align="left">DEBUG, TRACE</td></tr></table><p>This means that messages with level FATAL will be logged using the syslog's ALERT priority; ERROR message will use ERR priority, etc.</p><p>Note that there is no priority below DEBUG, therefore both TRACE and DEBUG level mesages will be logged using the DEBUG syslog priority. </p></div><div class="section"><h5>Facilities<a name="Facilities"></a></h5><p>The <i>facility</i> parameter is used to specify what type of program is logging the message. This allows you to specify (in your machine's syslog configuration) how messages coming from different facilities will be handled. </p><p>The following facilities are available:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left">KERN</td><td align="left">Kernel messages</td></tr><tr class="a"><td align="left">USER</td><td align="
 left">Generic user-level messages</td></tr><tr class="b"><td align="left">MAIL</td><td align="left">Mail system</td></tr><tr class="a"><td align="left">DAEMON</td><td align="left">System daemons</td></tr><tr class="b"><td align="left">AUTH</td><td align="left">Security/authorization messages</td></tr><tr class="a"><td align="left">SYSLOG</td><td align="left">Messages generated internally by syslogd</td></tr><tr class="b"><td align="left">LPR</td><td align="left">Line printer subsystem</td></tr><tr class="a"><td align="left">NEWS</td><td align="left">Network news subsystem</td></tr><tr class="b"><td align="left">UUCP</td><td align="left">UUCP subsystem</td></tr><tr class="a"><td align="left">CRON</td><td align="left">Clock daemon</td></tr><tr class="b"><td align="left">AUTHPRIV</td><td align="left">Security/authorization messages (private)</td></tr><tr class="a"><td align="left">LOCAL0</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL1<
 /td><td align="left">Reserved for local use</td></tr><tr class="a"><td align="left">LOCAL2</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL3</td><td align="left">Reserved for local use</td></tr><tr class="a"><td align="left">LOCAL4</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL5</td><td align="left">Reserved for local use</td></tr><tr class="a"><td align="left">LOCAL6</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL7</td><td align="left">Reserved for local use</td></tr></table><div class="source"><pre>  Note: USER is the only available facility under Windows operating systems.
-</pre></div></div><div class="section"><h5>Options<a name="Options"></a></h5><p>The following additional options may be defined via the <i>option</i> parameter:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left">CONS</td><td align="left">If there is an error while sending data to the system logger, write directly to the system console</td></tr><tr class="a"><td align="left">NDELAY</td><td align="left">Open the connection to the logger immediately.</td></tr><tr class="b"><td align="left">ODELAY</td><td align="left">Delay opening the connection until the first message is logged (default).</td></tr><tr class="a"><td align="left">PERROR</td><td align="left">Print log messages also to standard error.</td></tr><tr class="b"><td align="left">PID</td><td align="left">Include the PID with each message.</td></tr></table><p>Multiple options may be set by separating them with a &quot;|&quot;
 . For exampe &quot;CONS|PID|NODELAY&quot;.</p></div><div class="section"><h5>Examples <a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderSyslog&quot;&gt;
+</pre></div><p>If <i>locationInfo</i> was set to false, the <i>log4php:locationInfo</i> would not be present. </p><p>If <i>log4jNamespace</i> was set to true, all elements would be prefixed by <i>log4j:</i> instead <i>log4php:</i>.</p></div></div><div class="section"><h4><a name="LoggerAppenderSyslog">LoggerAppenderSyslog</a></h4><p>The LoggerAppenderSyslog logs events to the syslog.</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">ident</td><td align="center">No</td><td align="left">Apache log4php</td><td align="left">A string which will identify your appender.</td></tr><tr class="a"><td align="left">overridePriority</td><td align="center">No</td><td align="left">false</td><td align="left">If set to true, all messages will be sent to the syslog using the priority specified in the <i>priority</i> parameter.
  Otherwise, the pririty will depend on the level of the event being logged. See below.</td></tr><tr class="b"><td align="left">priority</td><td align="center">No/Yes</td><td align="left">-</td><td align="left">The syslog priority to use when overriding priority. This setting is required if <i>overridePriority</i> is set to true.</td></tr><tr class="a"><td align="left">facility</td><td align="center">No</td><td align="left">USER</td><td align="left">The syslog facility. Identifies the part of the system from which the event originated. See below.</td></tr><tr class="b"><td align="left">option</td><td align="center">No</td><td align="left">PID &#xa0;u007C CONS</td><td align="left">Syslog options. See below.</td></tr></table><div class="section"><h5>Priorities<a name="Priorities"></a></h5><p>The <i>priority</i> is the syslog equivalent of the log4php level. Here's a list of priorities available in syslog and the equivalent log4php levels.</p><table border="1" class="bodyTable">
 <tr class="a"><th align="left">Priority</th><th align="left">Description</th><th align="left">Equivalent level</th></tr><tr class="b"><td align="left">EMERG</td><td align="left">System is unusable</td><td align="left">-</td></tr><tr class="a"><td align="left">ALERT</td><td align="left">Action must be taken immediately</td><td align="left">FATAL</td></tr><tr class="b"><td align="left">CRIT</td><td align="left">Critical conditions</td><td align="left">-</td></tr><tr class="a"><td align="left">ERR</td><td align="left">Error conditions</td><td align="left">ERROR</td></tr><tr class="b"><td align="left">WARNING</td><td align="left">Warning conditions</td><td align="left">WARN</td></tr><tr class="a"><td align="left">NOTICE</td><td align="left">Normal, but significant, condition</td><td align="left">-</td></tr><tr class="b"><td align="left">INFO</td><td align="left">Informational message</td><td align="left">INFO</td></tr><tr class="a"><td align="left">DEBUG</td><td align="left">Deb
 ug-level message</td><td align="left">DEBUG, TRACE</td></tr></table><p>This means that messages with level FATAL will be logged using the syslog's ALERT priority; ERROR message will use ERR priority, etc.</p><p>Note that there is no priority below DEBUG, therefore both TRACE and DEBUG level mesages will be logged using the DEBUG syslog priority. </p></div><div class="section"><h5>Facilities<a name="Facilities"></a></h5><p>The <i>facility</i> parameter is used to specify what type of program is logging the message. This allows you to specify (in your machine's syslog configuration) how messages coming from different facilities will be handled. </p><p>The following facilities are available:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left">KERN</td><td align="left">Kernel messages</td></tr><tr class="a"><td align="left">USER</td><td align="left">Generic user-level messages</td></t
 r><tr class="b"><td align="left">MAIL</td><td align="left">Mail system</td></tr><tr class="a"><td align="left">DAEMON</td><td align="left">System daemons</td></tr><tr class="b"><td align="left">AUTH</td><td align="left">Security/authorization messages</td></tr><tr class="a"><td align="left">SYSLOG</td><td align="left">Messages generated internally by syslogd</td></tr><tr class="b"><td align="left">LPR</td><td align="left">Line printer subsystem</td></tr><tr class="a"><td align="left">NEWS</td><td align="left">Network news subsystem</td></tr><tr class="b"><td align="left">UUCP</td><td align="left">UUCP subsystem</td></tr><tr class="a"><td align="left">CRON</td><td align="left">Clock daemon</td></tr><tr class="b"><td align="left">AUTHPRIV</td><td align="left">Security/authorization messages (private)</td></tr><tr class="a"><td align="left">LOCAL0</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL1</td><td align="left">Reserved for local u
 se</td></tr><tr class="a"><td align="left">LOCAL2</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL3</td><td align="left">Reserved for local use</td></tr><tr class="a"><td align="left">LOCAL4</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL5</td><td align="left">Reserved for local use</td></tr><tr class="a"><td align="left">LOCAL6</td><td align="left">Reserved for local use</td></tr><tr class="b"><td align="left">LOCAL7</td><td align="left">Reserved for local use</td></tr></table><div class="source"><pre>  Note: USER is the only available facility under Windows operating systems.
+</pre></div></div><div class="section"><h5>Options<a name="Options"></a></h5><p>The following additional options may be defined via the <i>option</i> parameter:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left">CONS</td><td align="left">If there is an error while sending data to the system logger, write directly to the system console</td></tr><tr class="a"><td align="left">NDELAY</td><td align="left">Open the connection to the logger immediately.</td></tr><tr class="b"><td align="left">ODELAY</td><td align="left">Delay opening the connection until the first message is logged (default).</td></tr><tr class="a"><td align="left">PERROR</td><td align="left">Print log messages also to standard error.</td></tr><tr class="b"><td align="left">PID</td><td align="left">Include the PID with each message.</td></tr></table><p>Multiple options may be set by separating them with a pipe characte
 r. For exampe &quot;CONS|PID|NODELAY&quot;.</p><div class="source"><pre>NOTE: when setting multiple options in an INI file, be sure to put the options string in quotes. Otherwise they will not be parsed correctly.
+</pre></div></div><div class="section"><h5>Examples <a name="Examples"></a></h5><p>Configuration via XML file:</p><div class="source"><pre>&lt;appender name=&quot;default&quot; class=&quot;LoggerAppenderSyslog&quot;&gt;
     &lt;layout class=&quot;LoggerLayoutSimple&quot; /&gt;
     &lt;param name=&quot;ident&quot; value=&quot;log4php-test&quot; /&gt;
     &lt;param name=&quot;facility&quot; value=&quot;LOCAL0&quot; /&gt;
@@ -351,7 +367,7 @@ log4php.appender.default.locationInfo = 
 log4php.appender.default.layout = LoggerLayoutSimple
 log4php.appender.default.ident = log4php-test
 log4php.appender.default.facility = LOCAL0
-log4php.appender.default.options = NDELAY|PID
+log4php.appender.default.options = &quot;NDELAY|PID&quot;
 </pre></div></div></div></div></div>
       </div>
     </div>
@@ -364,7 +380,7 @@ log4php.appender.default.options = NDELA
                         <a href="http://www.apache.org">Apache Software Foundation</a>.
                   
         
-       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>. Please read the <a href="privacy-policy.html">privacy policy</a></div><br />
         <div class="xright">Apache log4php, Apache, log4php, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
         <div class="clear">
       </div>

Modified: logging/site/trunk/docs/log4php/docs/appender/filter.html
URL: http://svn.apache.org/viewvc/logging/site/trunk/docs/log4php/docs/appender/filter.html?rev=1180134&r1=1180133&r2=1180134&view=diff
==============================================================================
--- logging/site/trunk/docs/log4php/docs/appender/filter.html (original)
+++ logging/site/trunk/docs/log4php/docs/appender/filter.html Fri Oct  7 18:26:07 2011
@@ -1,19 +1,34 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<!-- Generated by Apache Maven Doxia at Aug 30, 2011 -->
+<!-- Generated by Apache Maven Doxia at Oct 7, 2011 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <title>Apache log4php - Appender Filters</title>
+    <title>Appender Filters</title>
     <style type="text/css" media="all">
       @import url("../../css/maven-base.css");
       @import url("../../css/maven-theme.css");
       @import url("../../css/site.css");
     </style>
     <link rel="stylesheet" href="../../css/print.css" type="text/css" media="print" />
-    <meta name="Date-Revision-yyyymmdd" content="20110830" />
+    <meta name="Date-Revision-yyyymmdd" content="20111007" />
     <meta http-equiv="Content-Language" content="en" />
         
-        </head>
+          <!-- Google Analytics -->
+    <script type="text/javascript">
+    
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-26177991-1']);
+      _gaq.push (['_gat._anonymizeIp']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+    </head>
   <body class="composite">
     <div id="banner">
                                       <a href="../../../" id="bannerLeft">
@@ -27,15 +42,15 @@
             
         
                 <div class="xleft">
-        <span id="publishDate">Last Published: 2011-08-30</span>
-                  &nbsp;| <span id="projectVersion">Version: 2.1.0</span>
+        <span id="publishDate">Last Published: 2011-10-07</span>
+                  &nbsp;| <span id="projectVersion">Version: 2.1.1-SNAPSHOT</span>
                           |                           <a href="http://www.apache.org/" class="externalLink" title="Apache">Apache</a>
         &gt;
-                          <a href="http://logging.apache.org" class="externalLink" title="Logging">Logging</a>
+                          <a href="../../.." title="Logging">Logging</a>
         &gt;
-                          <a href="http://logging.apache.org/log4php" class="externalLink" title="log4php">log4php</a>
+                          <a href="../.././" title="log4php">log4php</a>
         &gt;
-    Apache log4php - Appender Filters
+    Appender Filters
               </div>
             <div class="xright">        
         
@@ -193,15 +208,15 @@
         &lt;appender_ref ref=&quot;defualt&quot; /&gt;
     &lt;/root&gt;
 &lt;/log4php:configuration&gt;
-</pre></div><p>In this example, there are two filters defined for the <i>default</i> appender.</p><p>The first filter (LoggerFilterStringMatch) searches for the string &quot;interesting&quot; in the logging event's message. If the string is found, the filter will ACCEPT the logging event, and the event will be logged. If the string is not found, the filter will remain NEUTRAL, and the event will be passed on to the next filter.</p><p>The second filter (LoggerFilterLevelRange) ACCEPTS all events which have a level between DEBUG and ERROR (in other words, levels DEBUG, INFO, WARN and ERROR). It DENIES all other events.</p><p>Therefore, this filter configuration will log events which which have a level between DEBUG and ERROR, except of theose which have the string &quot;interesting&quot; in the message. Those will be logged regardless of their level. </p></div><div class="section"><h3>Filter reference<a name="Filter_reference"></a></h3><p>The following filters are available in
  log4php:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left"><a href="#LoggerFilterDenyAll">LoggerFilterDenyAll</a></td><td align="left">Denies all logging events.</td></tr><tr class="a"><td align="left"><a href="#LoggerFilterLevelMatch">LoggerFilterLevelMatch</a></td><td align="left">Filters based on logging event level.</td></tr><tr class="b"><td align="left"><a href="#LoggerFilterLevelRange">LoggerFilterLevelRange</a></td><td align="left">Filters based on logging event level range.</td></tr><tr class="a"><td align="left"><a href="#LoggerFilterStringMatch">LoggerFilterStringMatch</a></td><td align="left">Filters by searching for a string in the logging event message.</td></tr></table><div class="section"><h4><a name="LoggerFilterDenyAll">LoggerFilterDenyAll</a><a name="LoggerFilterDenyAll"></a></h4><p>This filters simply denies all logging events. It has no configurable paramet
 ers.</p></div><div class="section"><h4><a name="LoggerFilterLevelMatch">LoggerFilterLevelMatch</a><a name="LoggerFilterLevelMatch"></a></h4><p>This filter accepts the specified logger level or denys it.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">levelToMatch</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The level to match</td></tr><tr class="a"><td align="left">acceptOnMatch</td><td align="center">No</td><td align="left">true</td><td align="left">If true, the matching log level is accepted, denied otherwise</td></tr></table></div><div class="section"><h5>Example<a name="Example"></a></h5><div class="source"><pre>&lt;filter class=&quot;LoggerFilterLevelMatch&quot;&gt;
+</pre></div><p>In this example, there are two filters defined for the <i>default</i> appender.</p><p>The first filter (LoggerFilterStringMatch) searches for the string &quot;interesting&quot; in the logging event's message. If the string is found, the filter will ACCEPT the logging event, and the event will be logged. If the string is not found, the filter will remain NEUTRAL, and the event will be passed on to the next filter.</p><p>The second filter (LoggerFilterLevelRange) ACCEPTS all events which have a level between DEBUG and ERROR (in other words, levels DEBUG, INFO, WARN and ERROR). It DENIES all other events.</p><p>Therefore, this filter configuration will log events which which have a level between DEBUG and ERROR, except of theose which have the string &quot;interesting&quot; in the message. Those will be logged regardless of their level. </p></div><div class="section"><h3>Filter reference<a name="Filter_reference"></a></h3><p>The following filters are available in
  log4php:</p><table border="1" class="bodyTable"><tr class="a"><th align="left">Name</th><th align="left">Description</th></tr><tr class="b"><td align="left"><a href="#LoggerFilterDenyAll">LoggerFilterDenyAll</a></td><td align="left">Denies all logging events.</td></tr><tr class="a"><td align="left"><a href="#LoggerFilterLevelMatch">LoggerFilterLevelMatch</a></td><td align="left">Filters based on logging event level.</td></tr><tr class="b"><td align="left"><a href="#LoggerFilterLevelRange">LoggerFilterLevelRange</a></td><td align="left">Filters based on logging event level range.</td></tr><tr class="a"><td align="left"><a href="#LoggerFilterStringMatch">LoggerFilterStringMatch</a></td><td align="left">Filters by searching for a string in the logging event message.</td></tr></table><div class="section"><h4><a name="LoggerFilterDenyAll">LoggerFilterDenyAll</a></h4><p>This filters simply denies all logging events. It has no configurable parameters.</p></div><div class="section"
 ><h4><a name="LoggerFilterLevelMatch">LoggerFilterLevelMatch</a></h4><p>This filter accepts the specified logger level or denys it.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">levelToMatch</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The level to match</td></tr><tr class="a"><td align="left">acceptOnMatch</td><td align="center">No</td><td align="left">true</td><td align="left">If true, the matching log level is accepted, denied otherwise</td></tr></table></div><div class="section"><h5>Example<a name="Example"></a></h5><div class="source"><pre>&lt;filter class=&quot;LoggerFilterLevelMatch&quot;&gt;
     &lt;param name=&quot;levelToMatch&quot; value=&quot;debug&quot; /&gt;
     &lt;param name=&quot;acceptOnMatch&quot; value=&quot;false&quot; /&gt;
 &lt;/filter&gt;
-</pre></div></div></div><div class="section"><h4><a name="LoggerFilterLevelRange">LoggerFilterLevelRange</a><a name="LoggerFilterLevelRange"></a></h4><p>This filter accepts or denies logging events if their log level is within the specified range.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">levelMin</td><td align="center">No</td><td align="left">-</td><td align="left">The minimum level to log. If set, levels lower than this will be denied.</td></tr><tr class="a"><td align="left">levelMax</td><td align="center">No</td><td align="left">-</td><td align="left">The maximum level to log. If set, levels higher than this will be denied.</td></tr><tr class="b"><td align="left">acceptOnMatch</td><td align="center">No</td><
 td align="left">true</td><td align="left">If true, the matching log level is accepted, denied otherwise.</td></tr></table></div><div class="section"><h5>Example<a name="Example"></a></h5><div class="source"><pre>&lt;filter class=&quot;LoggerFilterLevelRange&quot;&gt;
+</pre></div></div></div><div class="section"><h4><a name="LoggerFilterLevelRange">LoggerFilterLevelRange</a></h4><p>This filter accepts or denies logging events if their log level is within the specified range.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">levelMin</td><td align="center">No</td><td align="left">-</td><td align="left">The minimum level to log. If set, levels lower than this will be denied.</td></tr><tr class="a"><td align="left">levelMax</td><td align="center">No</td><td align="left">-</td><td align="left">The maximum level to log. If set, levels higher than this will be denied.</td></tr><tr class="b"><td align="left">acceptOnMatch</td><td align="center">No</td><td align="left">true</td><td align="l
 eft">If true, the matching log level is accepted, denied otherwise.</td></tr></table></div><div class="section"><h5>Example<a name="Example"></a></h5><div class="source"><pre>&lt;filter class=&quot;LoggerFilterLevelRange&quot;&gt;
     &lt;param name=&quot;levelMax&quot; value=&quot;warn&quot; /&gt;
     &lt;param name=&quot;acceptOnMatch&quot; value=&quot;false&quot; /&gt;
 &lt;/filter&gt;
-</pre></div><p>This configuration denies levels greater than WARN.</p></div></div><div class="section"><h4><a name="LoggerFilterStringMatch">LoggerFilterStringMatch</a><a name="LoggerFilterStringMatch"></a></h4><p>This filter allows or denies logging events if their message contains a given string.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">stringToMatch</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The string to match.</td></tr><tr class="a"><td align="left">acceptOnMatch</td><td align="center">No</td><td align="left">true</td><td align="left">If set to true, the matching events are accepted, denied otherwise.</td></tr></table></div><div class="section"><h5>Example<a name="Exampl
 e"></a></h5><div class="source"><pre>&lt;filter class=&quot;LoggerFilterStringMatch&quot;&gt;
+</pre></div><p>This configuration denies levels greater than WARN.</p></div></div><div class="section"><h4><a name="LoggerFilterStringMatch">LoggerFilterStringMatch</a></h4><p>This filter allows or denies logging events if their message contains a given string.</p><div class="section"><h5>Configurable parameters<a name="Configurable_parameters"></a></h5><table border="1" class="bodyTable"><tr class="a"><th align="left">Parameter</th><th align="center">Required</th><th align="left">Default value</th><th align="left">Description</th></tr><tr class="b"><td align="left">stringToMatch</td><td align="center"><b>Yes</b></td><td align="left">-</td><td align="left">The string to match.</td></tr><tr class="a"><td align="left">acceptOnMatch</td><td align="center">No</td><td align="left">true</td><td align="left">If set to true, the matching events are accepted, denied otherwise.</td></tr></table></div><div class="section"><h5>Example<a name="Example"></a></h5><div class="source"><pre>&
 lt;filter class=&quot;LoggerFilterStringMatch&quot;&gt;
     &lt;param name=&quot;StringToMatch&quot; value=&quot;not-interesting&quot; /&gt;
     &lt;param name=&quot;AcceptOnMatch&quot; value=&quot;false&quot; /&gt;
 &lt;/filter&gt;
@@ -217,7 +232,7 @@
                         <a href="http://www.apache.org">Apache Software Foundation</a>.
                   
         
-       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>.</div><br />
+       Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache Software License, Version 2.0</a>. Please read the <a href="privacy-policy.html">privacy policy</a></div><br />
         <div class="xright">Apache log4php, Apache, log4php, the Apache feather logo, the Apache Logging Services project logo and the Built by Maven logo are trademarks of The Apache Software Foundation.</div>
         <div class="clear">
       </div>



Mime
View raw message