mirror/php-monolog
1
0
Fork 0
mirror of https://github.com/Seldaek/monolog.git synced 2025-08-10 23:24:02 +02:00
Code Issues Releases Wiki Activity

Clarify docblocks, fixes #142

Browse Source
This commit is contained in:
Jordi Boggiano
2013-01-06 20:25:29 +01:00
parent 63e3bfdf7e
commit 2909f89faa
1 changed files with 9 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
src/Monolog/Handler/HandlerInterface.php
View File

@@ -25,6 +25,10 @@ interface HandlerInterface
* *
* This is mostly done for performance reasons, to avoid calling processors for nothing. * This is mostly done for performance reasons, to avoid calling processors for nothing.
* *
* Handlers should still check the record levels within handle(), returning false in isHandling()
* is no guarantee that handle() will not be called, and isHandling() might not be called
* for a given record.
*
* @param array $record * @param array $record
* *
* @return Boolean * @return Boolean
@@ -34,7 +38,12 @@ interface HandlerInterface
/** /**
* Handles a record. * Handles a record.
* *
* All records may be passed to this method, and the handler should discard
* those that it does not want to handle.
*
* The return value of this function controls the bubbling process of the handler stack. * The return value of this function controls the bubbling process of the handler stack.
* Unless the bubbling is interrupted (by returning true), the Logger class will keep on
* calling further handlers in the stack with a given log record.
* *
* @param array $record The record to handle * @param array $record The record to handle
* @return Boolean True means that this handler handled the record, and that bubbling is not permitted. * @return Boolean True means that this handler handled the record, and that bubbling is not permitted.