mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-15 08:28:54 +00:00
Document the changes to syslog.filter
* Documenting the changes to syslog.filter https://github.com/php/php-src/pull/4265 restored the previous handling of multi-line log messages by adding `syslog.filter=raw`. * Highlight the fact that line splitting is happening in all of the three original modes, but not in "raw". * Add "raw" to syslog section of 7.3 migration guide Closes GH-589.
This commit is contained in:
parent
e86cd44003
commit
477c5f97a6
3 changed files with 26 additions and 7 deletions
|
@ -46,9 +46,12 @@
|
|||
<term><link linkend="ini.syslog.filter">syslog.filter</link></term>
|
||||
<listitem>
|
||||
<simpara>
|
||||
Specifies the filter type to filter the logged messages. There are three
|
||||
Specifies the filter type to filter the logged messages, with the
|
||||
supported filter types - <literal>all</literal>,
|
||||
<literal>no-ctrl</literal> and <literal>ascii</literal>.
|
||||
Starting with PHP 7.3.8, <literal>raw</literal> is also available,
|
||||
restoring the way syslog behaved in previous PHP versions.
|
||||
This filter will also affect calls to <function>syslog</function>.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
|
|
@ -526,21 +526,36 @@
|
|||
<para>
|
||||
Specifies the filter type to filter the logged messages. Allowed
|
||||
characters are passed unmodified; all others are written in their
|
||||
hexadecimal representation prefixed with <literal>\x</literal>. There are
|
||||
three supported filter types:
|
||||
hexadecimal representation prefixed with <literal>\x</literal>.
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara><literal>all</literal> – all characters</simpara>
|
||||
<simpara><literal>all</literal> – the logged string will be split
|
||||
at newline characters, and all characters are passed unaltered
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara><literal>no-ctrl</literal> – all characters except control characters</simpara>
|
||||
<simpara><literal>ascii</literal> – the logged string will be split
|
||||
at newline characters, and any non-printable 7-bit ASCII characters will be escaped
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara><literal>ascii</literal> – all printable ASCII characters and <literal>NL</literal></simpara>
|
||||
<simpara><literal>no-ctrl</literal> – the logged string will be split
|
||||
at newline characters, and any non-printable characters will be escaped
|
||||
</simpara>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<simpara><literal>raw</literal> – all characters are passed to the system
|
||||
logger unaltered, without splitting at newlines (identical to PHP before 7.3)
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
Only effective if <link linkend="ini.error-log">error_log</link> is set to "syslog".
|
||||
This setting will affect logging via <link linkend="ini.error-log">error_log</link> set to "syslog" and calls to <function>syslog</function>.
|
||||
</para>
|
||||
<note>
|
||||
<para>
|
||||
The <literal>raw</literal> filter type is available as of PHP 7.3.8 and PHP 7.4.0.
|
||||
</para>
|
||||
</note>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
|
|
@ -161,6 +161,7 @@ closelog();
|
|||
<simplelist>
|
||||
<member><function>openlog</function></member>
|
||||
<member><function>closelog</function></member>
|
||||
<member><link linkend="ini.syslog.filter">syslog.filter</link> INI setting (starting with PHP 7.3)</member>
|
||||
</simplelist>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
|
Loading…
Reference in a new issue