diff options
Diffstat (limited to 'inc/packages/Log.xml')
| -rwxr-xr-x | inc/packages/Log.xml | 315 |
1 files changed, 315 insertions, 0 deletions
diff --git a/inc/packages/Log.xml b/inc/packages/Log.xml new file mode 100755 index 00000000000..de16370c8bf --- /dev/null +++ b/inc/packages/Log.xml @@ -0,0 +1,315 @@ +<?xml version="1.0" encoding="ISO-8859-1" ?> +<!DOCTYPE package SYSTEM "http://pear.php.net/dtd/package-1.0"> +<package version="1.0"> + <name>Log</name> + <summary>Logging utilities</summary> + <description>The Log framework provides an abstracted logging system. It supports logging to console, file, syslog, SQL, Sqlite, mail and mcal targets. It also provides a subject - observer mechanism.</description> + <maintainers> + <maintainer> + <user>jon</user> + <name>Jon Parise</name> + <email>jon@php.net</email> + <role>lead</role> + </maintainer> + </maintainers> + <release> + <version>1.8.7</version> + <date>2004-12-20</date> + <license>PHP License</license> + <state>stable</state> + <notes>The Log package now supports logging arrays with a 'message' key. +The 'display' handler now preserves line breaks in its output. +An experimental new handler ('daemon') has been added.</notes> + <deps> + <dep type="pkg" rel="has" optional="yes">DB</dep> + <dep type="ext" rel="has" optional="yes">sqlite</dep> + <dep type="php" rel="ge" version="4.3.0" optional="no"/> + </deps> + <filelist> + <file role="doc" baseinstalldir="/" name="docs/guide.txt"/> + <file role="doc" baseinstalldir="/" name="docs/examples/composite.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/console.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/display.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/error_log.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/file.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/mail.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/null.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/observer_mail.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/pear_error_handler.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/php_error_handler.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/sql.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/sqlite.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/syslog.php"/> + <file role="doc" baseinstalldir="/" name="docs/examples/win.php"/> + <file role="php" baseinstalldir="/" name="Log/composite.php"/> + <file role="php" baseinstalldir="/" name="Log/console.php"/> + <file role="php" baseinstalldir="/" name="Log/daemon.php"/> + <file role="php" baseinstalldir="/" name="Log/display.php"/> + <file role="php" baseinstalldir="/" name="Log/error_log.php"/> + <file role="php" baseinstalldir="/" name="Log/file.php"/> + <file role="php" baseinstalldir="/" name="Log/mail.php"/> + <file role="php" baseinstalldir="/" name="Log/mcal.php"/> + <file role="php" baseinstalldir="/" name="Log/null.php"/> + <file role="php" baseinstalldir="/" name="Log/observer.php"/> + <file role="php" baseinstalldir="/" name="Log/sql.php"/> + <file role="php" baseinstalldir="/" name="Log/sqlite.php"/> + <file role="php" baseinstalldir="/" name="Log/syslog.php"/> + <file role="php" baseinstalldir="/" name="Log/win.php"/> + <file role="data" baseinstalldir="/" name="misc/log.sql"/> + <file role="test" baseinstalldir="/" name="tests/composite.phpt"/> + <file role="test" baseinstalldir="/" name="tests/console.phpt"/> + <file role="test" baseinstalldir="/" name="tests/display.phpt"/> + <file role="test" baseinstalldir="/" name="tests/error_log.phpt"/> + <file role="test" baseinstalldir="/" name="tests/extract.phpt"/> + <file role="test" baseinstalldir="/" name="tests/extract2.phpt"/> + <file role="test" baseinstalldir="/" name="tests/factory.phpt"/> + <file role="test" baseinstalldir="/" name="tests/null.phpt"/> + <file role="test" baseinstalldir="/" name="tests/priority.phpt"/> + <file role="test" baseinstalldir="/" name="tests/singleton.phpt"/> + <file role="test" baseinstalldir="/" name="tests/sqlite.phpt"/> + <file role="test" baseinstalldir="/" name="tests/sql_ident.phpt"/> + <file role="php" baseinstalldir="/" name="Log.php"/> + </filelist> + </release> + <changelog> + <release> + <version>1.8.7</version> + <date>2004-12-20</date> + <license>PHP License</license> + <state>stable</state> + <notes>The Log::_extractMessage() routine will now extract and use the value of an array's 'message' key if it exists. (Laurent Laville) +The 'display' handler now preserves line breaks in its output. (Bug 2606) +An experimental new syslog daemon log handler ('daemon') has been added to the Log distribution. (Bart van der Schans) +</notes> + </release> + <release> + <version>1.8.6</version> + <date>2004-09-08</date> + <license>PHP License</license> + <state>stable</state> + <notes>The maximum length of the 'sql' handler's 'ident' string is now configurable via the 'identLimit' configuration parameter. (Bug 2137) + +Different instances of the 'win' handler can now address their own output windows. (Bug 2212) +</notes> + </release> + <release> + <version>1.8.5</version> + <date>2004-08-09</date> + <license>PHP License</license> + <state>stable</state> + <notes>The 'sql' handler now enforces a maximum 'ident' length of 16 characters. + +The 'sql' handler can now use a user-defined sequence (via the 'sequence' configuration parameter). This allows each log table to use its own sequence. You will need to take appropriate steps to preserve your sequence numbering if that is important to your site; the ID sequence will be reinitialized to 0 the first time this updated handler is used. You may also need to explicitly drop the 'log_id_seq' sequence before using this new code. + +The 'composite' handler now properly closes all of its children when its close() method is called. It also guards against multiple calls to open(). (Bug 1947) +</notes> + </release> + <release> + <version>1.8.4</version> + <date>2004-02-16</date> + <license>PHP License</license> + <state>stable</state> + <notes>The Log package now requires PHP 4.3.0 or later. + +The _extractMessage() method no longer uses the serialize()'ed version of an event object if no string conversion method is available. Instead, the human-readable (via print_r()) representation of the object will be used. + +_extractMessage() can now handle arrays. Their human-readable representation will be used. + +Each Log instance now has a default priority level. This priority will be used by the log() method when no specific priority parameter is provided. It can be accessed using the new getPriority() and setPriority() methods. +</notes> + </release> + <release> + <version>1.8.3</version> + <date>2004-01-11</date> + <license>PHP License</license> + <state>stable</state> + <notes>The open() and close() methods now consistently return success or failure. Previously, some handlers' open() and close() methods did not return any result. Also, the log() methods will return failure when the handler cannot be opened. + +Bertrand Mansion contributed a new handler that logs using the Sqlite extension. +</notes> + </release> + <release> + <version>1.8.2</version> + <date>2004-01-01</date> + <license>PHP License</license> + <state>stable</state> + <notes>A new 'null' log handler that simply consumes log events has been added. The 'null' handler will still respect log masks and attached observers. + +The public Log API has grown a flush() method. This allows buffered log output to be explicitly flushed. At this time, the flush() method is only implemented by the console, file and mail handlers. + +New unit tests for the Factory and Singleton construction methods have been added. +</notes> + </release> + <release> + <version>1.8.1</version> + <date>2003-12-14</date> + <license>PHP License</license> + <state>stable</state> + <notes>The 'win' handler now handles newline sequences correctly (Bug 282). + +The Log_observer::factory() method has been updated to accept an optional associative array of configuration values, return the newly-created object by reference, and look for files named 'Log/observer_.php'. Backwards compatibility for the old-style conventions has been preserved. +</notes> + </release> + <release> + <version>1.8.0</version> + <date>2003-11-18</date> + <license>PHP License</license> + <state>stable</state> + <notes>The Log package now includes a users guide, example scripts and unit tests. + +A number of small improvements have been made to the 'win' log handler (based on suggestions from Paul Yanchenko). + +A new 'display' log handler has been added to the distribution. Contributed by Paul Yanchenko, this handler simply prints the error message back to the browser. It respects the 'error_prepend_string' and 'error_append_string' PHP INI values and is useful when using PEAR::setErrorHandling()'s PEAR_ERROR_CALLBACK mechanism. +</notes> + </release> + <release> + <version>1.7.1</version> + <date>2003-09-21</date> + <state>stable</state> + <notes>The mail handler now uses "\n" to terminate lines instead of "\r\n". + +The file handler's path creation routines now guard against potentially infinite recursion. + +It is now possible to pass an object to the logging methods. If the object offers a PEAR_Error-style getMessage() or PHP5 exception-style toString() method, it will be used to extract the message text. +</notes> + </release> + <release> + <version>1.7.0</version> + <date>2003-08-02</date> + <state>stable</state> + <notes>It is now possible to specific a specific mask that dictates exactly which levels will be logged. + +A number of convenient "shortcut" functions have been added for logging messages at specific log messages. + +Two new log handers have been added: the 'error_log' handler wraps PHP's native error_log() function; and the 'win' handler outputs log messages to a separate browser window. + +The file log handler has been completely rewritten based on suggestions from Roman Neuhauser. It no longer buffers log output in memory before writing to the log file. + +Greg Beaver submitted a change that allows callers to provide their own Log classes (that existing outside of the PEAR file hierarchy) by including them before invoking a factory() method. +</notes> + </release> + <release> + <version>1.6.7</version> + <date>2003-06-16</date> + <state>stable</state> + <notes>It is now possible to set the identification string for all of a composite's child instances. + +The preamble of the mail handler's message is now configurable. +</notes> + </release> + <release> + <version>1.6.5</version> + <date>2003-04-26</date> + <state>stable</state> + <notes>The mail log handler needs to register its own destructer now that the Log class no longer inherits from the PEAR base class. +</notes> + </release> + <release> + <version>1.6.4</version> + <date>2003-04-08</date> + <state>stable</state> + <notes>The Log classes no longer inherits from the PEAR base class. Not including the PEAR base class gives us smaller, faster Log objects. + +The Log_file class now registers its own destructor to ensure that the logfile is correctly closed upon shutdown. + +A ZendEngine 1 incompatibility was introduced in the previous release. This has been corrrected. +</notes> + </release> + <release> + <version>1.6.3</version> + <date>2003-04-07</date> + <state>stable</state> + <notes>A unique identifier is now stored inside each Log instance. Both the composite and subject-observer mechanisms use this identifier to index their object lists. + +The internals of the Log_observer system have been rewritten for general cleanliness. The external interface remains unchanged. + +The Log class now offers public setIdent() and getIdent() members for setting and getting the Log instance's identification string during the object's lifetime. +</notes> + </release> + <release> + <version>1.6.2</version> + <date>2003-04-06</date> + <state>stable</state> + <notes>In the Log_observer class, operate directly on the reference to the Log instance (instead of on a copy of the object). +</notes> + </release> + <release> + <version>1.6.1</version> + <date>2003-04-02</date> + <state>stable</state> + <notes>- Fix a typo that broke the Log_Observer class. +</notes> + </release> + <release> + <version>1.6.0</version> + <date>2003-02-17</date> + <state>stable</state> + <notes>- The SQL handler now uses sequences instead of timestamps as unique identifiers. +- The time format used by the file handler is now configurable. +</notes> + </release> + <release> + <version>1.5.3</version> + <date>2003-01-01</date> + <state>stable</state> + <notes>- Improved singleton()'s signature generation. +- The SQL handler no longer closes existing database connections. +- The log() method now returns a boolean result indicating success or failure. +</notes> + </release> + <release> + <version>1.5.2</version> + <date>2002-11-28</date> + <state>stable</state> + <notes>- Altered the singleton's "signature" construction to be shorter and more array-friendly. +</notes> + </release> + <release> + <version>1.5.1</version> + <date>2002-11-17</date> + <state>stable</state> + <notes>- The mail handler now implements a destructor to ensure close() is called. +- The syslog handler now requires $name to be a valid syslog facility. +</notes> + </release> + <release> + <version>1.5</version> + <date>2002-10-24</date> + <state>stable</state> + <notes>- Adding the ability to set the mode of the logfile in the Log_file. +- mail() failures in Log_mail are logged via error_log(). +- Replaced all remaining LOG_* constants with the PEAR_LOG_* versions. +</notes> + </release> + <release> + <version>1.4</version> + <date>2002-09-28</date> + <state>stable</state> + <notes>- Altered the format of the SQL logging table to use a TIMESTAMP field. +- The Log class now extends the PEAR base class. +- New file logger that keeps the log file open for the life of the request. +</notes> + </release> + <release> + <version>1.3</version> + <date>2002-09-15</date> + <state>stable</state> + <notes>Adding a mail logging target. +</notes> + </release> + <release> + <version>1.2</version> + <date>2002-07-24</date> + <state>stable</state> + <notes>Introduce the PEAR_LOG_* constants. +</notes> + </release> + <release> + <version>1.1</version> + <date>2002-04-12</date> + <state>stable</state> + <notes>Adding a new console logging target. +</notes> + </release> + </changelog> +</package> |