<<

NAME

        C4::Debug - Standardized, centralized, exported debug switches.

SYNOPSIS

        use C4::Debug;

DESCRIPTION

The purpose of this module is to centralize some of the "switches" that turn debugging off and on in Koha. Most often, this functionality will be provided via C4::Context. C4::Debug is separate to preserve the relatively stable state of Context, and because other code will use C4::Debug without invoking Context.

Although centralization is our intention, for logical and security reasons, several approaches to debugging need to be kept separate. Information useful to developers in one area will not necessarily be useful or even available to developers in another area.

For example, the designer of template-influenced javascript my want to be able to trigger javascript's alert function to display certain variable values, to verify the template selection is being performed correctly. For this purpose the presence of a javascript "debug" variable might be a good switch.

Meanwhile, where security coders (say, for LDAP Auth) will appreciate low level feedback about Authentication transactions, an environmental system variable might be a good switch. However, clearly we would not want to expose that same information (e.g., entire LDAP records) to the web interface based on a javascript variable (even if it were possible)!

All that is a long way of saying THERE ARE SECURITY IMPLICATIONS to turning on debugging in various parts of the system, so don't treat them all the same or confuse them.

VARIABLES / AREAS

$debug - System, general The general purpose debug switch.

How to Set $debug:

environmental variable DEBUG or KOHA_DEBUG. In bash, you might do:
        export KOHA_DEBUG=1;
        perl t/Auth.t;
Keep in mind that your webserver will not be running in the same environment as your shell. However, for development purposes, the same effect can be had by using Apache's SET_ENV command with ERROR_LOG enabled for your VirtualHost. Not intended for production systems.
You can force the value from perl directly, like:
        use C4::Debug;
        use C4::Dates;
        BEGIN { $C4::Debug::debug = 1; }
        # now any other dependencies that also use C4::Debug will have debugging ON.

$cgi_debug (CGI params) The web-based debug switch.

How to Set $cgi_debug:

From a web browser, for example by supplying a non-zero debug parameter (1 to 9):
        http://www.mylibrary.org/cgi-bin/koha/opac-search.pl?q=history&debug=1
Or in HTML, add a similar input parameter:
        <input type="hidden" name="debug" value="1" />
Or from shell (or Apache), set KOHA_CGI_DEBUG.

The former methods mean $cgi_debug is exposed. Do NOT use it to trigger any actions that you would not allow a (potentially anonymous) end user to perform. Dumping sensitive data, directory listings, or emailing yourself a test message would all be bad actions to tie to $cgi_debug.

OTHER SOURCES of Debug Switches

System Preferences

Database Debug

Debugging at the database level might be useful. Koha does not currently integrate any such capability.

CONVENTIONS

Debug values range from 0 to 9. At zero (the default), debugging is off.

AUTHOR

Joe Atzberger atz AT liblime DOT com

SEE ALSO

CGI(3)

C4::Context

<<