openlog
(PHP 4, PHP 5)
openlog — システムのロガーへの接続をオープンする
説明
bool openlog
( string
$ident
, int $option
, int $facility
)openlog() は、プログラムによるシステムロガーへの接続をオープンします。
openlog() の使用は必須ではありません。この関数は、
必要に応じて syslog() により自動的に呼び出されます。
この場合、ident のデフォルト値は
FALSE となります。
パラメータ
-
ident -
文字列
identが、各メッセージに追加されます。 -
option -
option引数は、 ログメッセージの生成時に使用されるロギング用オプションを指定します。
このオプションを一つまたは複数設定することが可能です。 複数のオプションを使用する場合、その論理和を指定します。 つまり、直ちに接続をオープンし、コンソールに書き込み、 各メッセージに PID を含めるには、 LOG_CONS | LOG_NDELAY | LOG_PID とします。openlog() のオプション 定数 説明 LOG_CONSシステムロガーにデータが送信される間にエラーが発生した場合、 直接、システムコンソールに書き込まれます。 LOG_NDELAY直ちにロガーへの接続をオープンします。 LOG_ODELAY(デフォルト) 最初のメッセージがロギングされるまで接続のオープンを遅延します。 LOG_PERROR標準エラー出力にもログメッセージを出力します。 LOG_PID各メッセージに PID も含めます。 -
facility -
引数
facilityには、 ロギングを行う際のメッセージ型を指定します。これにより、 (使用するシステムの syslog の設定に関して) 異なった facility を有するメッセージをどのように処理するかを指定できるようになります。openlog() の機能 定数 説明 LOG_AUTHセキュリティ/認証用メッセージ (定数 LOG_AUTHPRIVが定義されているシステムでは、代わりにそれを使用してください)LOG_AUTHPRIVセキュリティ/認証 メッセージ (プライベート) LOG_CRONクロックデーモン (cron や at) LOG_DAEMON他のシステムデーモン LOG_KERNカーネルメッセージ LOG_LOCAL0...LOG_LOCAL7ローカルでの使用のために確保されているもので、Windows では使用できません LOG_LPRラインプリンタサブシステム LOG_MAILメールサブシステム LOG_NEWSUSENET ニュース サブシステム LOG_SYSLOGsyslogd で内部的に生成されたメッセージ LOG_USER一般的なユーザーレベルのメッセージ LOG_UUCPUUCP サブシステム 注意:
Windows 環境で使用できるのは LOG_USER だけです。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。