[doc-en] master: Document what syslog() uses when openlog() was not called (#6062)
| From: | Louis-Arnaud via GitHub | Date: | Wed, 11 Nov 2026 20:37:04 +0000 |
| Subject: | [doc-en] master: Document what syslog() uses when openlog() was not called (#6062) | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-23938@lists.php.net to get a copy of this message | ||
Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: lacatoire
Date: 2026-11-11T21:37:01+01:00
Commit: https://github.com/php/doc-en/commit/aa9be494d0b6bdd9ffd6a56abbc73bba22c13d17
Raw diff: https://github.com/php/doc-en/commit/aa9be494d0b6bdd9ffd6a56abbc73bba22c13d17.diff
Document what syslog() uses when openlog() was not called (#6062)
Changed paths:
M reference/network/functions/openlog.xml
Diff:
diff --git a/reference/network/functions/openlog.xml b/reference/network/functions/openlog.xml
index f5bf59c98fd4..f635bb944c67 100644
--- a/reference/network/functions/openlog.xml
+++ b/reference/network/functions/openlog.xml
@@ -19,10 +19,17 @@
logger for a program.
</para>
<para>
- The use of <function>openlog</function> is optional. It
- will automatically be called by <function>syslog</function> if
- necessary, in which case <parameter>prefix</parameter> will default
- to the empty string.
+ The use of <function>openlog</function> is optional. If it has not been
+ called, the connection is opened by the first message that is logged.
+ When that message comes from <function>syslog</function>, then in PHP 8.1
+ to 8.3, up to PHP 8.4.27 and up to PHP 8.5.12 the prefix and the facility
+ are left to the system (the prefix is usually the name of the program,
+ and <literal>php</literal> on Windows), and the
+ <link linkend="ini.syslog.ident">syslog.ident</link> and
+ <link linkend="ini.syslog.facility">syslog.facility</link> INI settings
+ are not used. When it comes from <literal>error_log</literal> or
+ <literal>mail.log</literal> set to <literal>syslog</literal>, those
+ settings are used.
</para>
</refsect1>