mirror of
https://github.com/fofolee/uTools-Manuals.git
synced 2025-12-17 16:34:32 +08:00
0.0.1
This commit is contained in:
fofolee
246
docs/php/openlog.html
Normal file
246
docs/php/openlog.html
Normal file
@@ -0,0 +1,246 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
|
||||
<title>Open connection to system logger</title>
|
||||
</head>
|
||||
<body class="docs"><div id="layout">
|
||||
<div id="layout-content"><div id="function.openlog" class="refentry">
|
||||
<div class="refnamediv">
|
||||
<h1 class="refname">openlog</h1>
|
||||
<p class="verinfo">(PHP 4, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">openlog</span> — <span class="dc-title">Open connection to system logger</span></p>
|
||||
|
||||
</div>
|
||||
|
||||
<div class="refsect1 description" id="refsect1-function.openlog-description">
|
||||
<h3 class="title">说明</h3>
|
||||
<div class="methodsynopsis dc-description">
|
||||
<span class="methodname"><strong>openlog</strong></span>
|
||||
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$ident</code></span>
|
||||
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$option</code></span>
|
||||
, <span class="methodparam"><span class="type">int</span> <code class="parameter">$facility</code></span>
|
||||
) : <span class="type">bool</span></div>
|
||||
|
||||
<p class="para rdfs-comment">
|
||||
<span class="function"><strong>openlog()</strong></span> opens a connection to the system
|
||||
logger for a program.
|
||||
</p>
|
||||
<p class="para">
|
||||
The use of <span class="function"><strong>openlog()</strong></span> is optional. It
|
||||
will automatically be called by <span class="function"><a href="syslog.html" class="function">syslog()</a></span> if
|
||||
necessary, in which case <code class="parameter">ident</code> will default
|
||||
to <strong><code>FALSE</code></strong>.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 parameters" id="refsect1-function.openlog-parameters">
|
||||
<h3 class="title">参数</h3>
|
||||
<p class="para">
|
||||
<dl>
|
||||
|
||||
|
||||
<dt>
|
||||
<code class="parameter">ident</code></dt>
|
||||
|
||||
<dd>
|
||||
|
||||
<p class="para">
|
||||
The string <code class="parameter">ident</code> is added to each message.
|
||||
</p>
|
||||
</dd>
|
||||
|
||||
|
||||
|
||||
<dt>
|
||||
<code class="parameter">option</code></dt>
|
||||
|
||||
<dd>
|
||||
|
||||
<p class="para">
|
||||
The <code class="parameter">option</code> argument is used to indicate
|
||||
what logging options will be used when generating a log message.
|
||||
<table class="doctable table">
|
||||
<caption><strong><span class="function"><strong>openlog()</strong></span> Options</strong></caption>
|
||||
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Constant</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
|
||||
</thead>
|
||||
|
||||
<tbody class="tbody">
|
||||
<tr>
|
||||
<td><strong><code>LOG_CONS</code></strong></td>
|
||||
<td>
|
||||
if there is an error while sending data to the system logger,
|
||||
write directly to the system console
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_NDELAY</code></strong></td>
|
||||
<td>
|
||||
open the connection to the logger immediately
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_ODELAY</code></strong></td>
|
||||
<td>
|
||||
(default) delay opening the connection until the first
|
||||
message is logged
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_PERROR</code></strong></td>
|
||||
<td>print log message also to standard error</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_PID</code></strong></td>
|
||||
<td>include PID with each message</td>
|
||||
</tr>
|
||||
|
||||
</tbody>
|
||||
|
||||
</table>
|
||||
|
||||
You can use one or more of these options. When using multiple options
|
||||
you need to <em>OR</em> them, i.e. to open the connection
|
||||
immediately, write to the console and include the PID in each message,
|
||||
you will use: <em>LOG_CONS | LOG_NDELAY | LOG_PID</em>
|
||||
</p>
|
||||
</dd>
|
||||
|
||||
|
||||
|
||||
<dt>
|
||||
<code class="parameter">facility</code></dt>
|
||||
|
||||
<dd>
|
||||
|
||||
<p class="para">
|
||||
The <code class="parameter">facility</code> argument 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.
|
||||
<table class="doctable table">
|
||||
<caption><strong><span class="function"><strong>openlog()</strong></span> Facilities</strong></caption>
|
||||
|
||||
<thead>
|
||||
<tr>
|
||||
<th>Constant</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
|
||||
</thead>
|
||||
|
||||
<tbody class="tbody">
|
||||
<tr>
|
||||
<td><strong><code>LOG_AUTH</code></strong></td>
|
||||
<td>
|
||||
security/authorization messages (use
|
||||
<strong><code>LOG_AUTHPRIV</code></strong> instead
|
||||
in systems where that constant is defined)
|
||||
</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_AUTHPRIV</code></strong></td>
|
||||
<td>security/authorization messages (private)</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_CRON</code></strong></td>
|
||||
<td>clock daemon (cron and at)</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_DAEMON</code></strong></td>
|
||||
<td>other system daemons</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_KERN</code></strong></td>
|
||||
<td>kernel messages</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_LOCAL0</code></strong> ... <strong><code>LOG_LOCAL7</code></strong></td>
|
||||
<td>reserved for local use, these are not available in Windows</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_LPR</code></strong></td>
|
||||
<td>line printer subsystem</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_MAIL</code></strong></td>
|
||||
<td>mail subsystem</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_NEWS</code></strong></td>
|
||||
<td>USENET news subsystem</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_SYSLOG</code></strong></td>
|
||||
<td>messages generated internally by syslogd</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_USER</code></strong></td>
|
||||
<td>generic user-level messages</td>
|
||||
</tr>
|
||||
|
||||
<tr>
|
||||
<td><strong><code>LOG_UUCP</code></strong></td>
|
||||
<td>UUCP subsystem</td>
|
||||
</tr>
|
||||
|
||||
</tbody>
|
||||
|
||||
</table>
|
||||
|
||||
</p>
|
||||
<blockquote class="note"><p><strong class="note">Note</strong>:
|
||||
<p class="para">
|
||||
<strong><code>LOG_USER</code></strong> is the only valid log type under Windows
|
||||
operating systems
|
||||
</p>
|
||||
</p></blockquote>
|
||||
</dd>
|
||||
|
||||
|
||||
</dl>
|
||||
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 returnvalues" id="refsect1-function.openlog-returnvalues">
|
||||
<h3 class="title">返回值</h3>
|
||||
<p class="para">
|
||||
成功时返回 <strong><code>TRUE</code></strong>， 或者在失败时返回 <strong><code>FALSE</code></strong>。
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
<div class="refsect1 seealso" id="refsect1-function.openlog-seealso">
|
||||
<h3 class="title">参见</h3>
|
||||
<p class="para">
|
||||
<ul class="simplelist">
|
||||
<li class="member"><span class="function"><a href="syslog.html" class="function" rel="rdfs-seeAlso">syslog()</a> - Generate a system log message</span></li>
|
||||
<li class="member"><span class="function"><a href="closelog.html" class="function" rel="rdfs-seeAlso">closelog()</a> - 关闭系统日志链接</span></li>
|
||||
</ul>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
|
||||
</div></div></div></body></html>
|
||||
Reference in New Issue
Block a user