v5:reference:logging
Table of Contents
Logging
ADOdb provides an internal debugging system that exposes the executed SQL commands, as well as other messages that can help when troubleshooting errors when, for example, trying to establish a connection to the database or an SQL statement fails.
The earliest that debugging can be started is after instantiating the driver but before connection.
Usage
Please refer to Debug Mode for details on usage.
Overriding The Default Logging Function
The default logging behavior is to send all messages to STDOUT, but the behavior may be modified by either:
- Defining a constant ADODB_OUTP which holds the name of the function that overrides the standard value
- A variable $ADODB_OUTP which is globalized and achieves the same as above. This function can be dynamically changed.
Function Definition
The overriding function must accept 2 arguments:
- A String which contains the message
- A boolean which indicates whether to throw a newline. This may be discarded based on how the function works
Example Function
DEFINE ('ADODB_OUTP','myLogger'); function myLogger($msg,$discard) { print "\nThis is my messsage: $msg"; }
v5/reference/logging.txt · Last modified: 2024/01/09 11:14 by dregad