NAME
Apache::CIPP - Use CIPP embedded HTML Pages with mod_perl
SYNOPSIS
# Advise Apache to use Apache::CIPP as the request
# handler for this Location
SetHandler "perl-script"
PerlHandler Apache::CIPP
# directory for caching of preprocessed CIPP programs
# (this must be writable by the webserver user)
PerlSetVar cache_dir /tmp/cipp_cache
# what language do you prefer for error messages?
# (EN=English, DE=German)
PerlSetVar lang EN
# debugging infos to error log?
PerlSetVar debug 1
# used databases
# (comma separated, whitespace is ignored)
PerlSetVar databases "zyn, foo"
# default database
PerlSetVar default_db zyn
# configuration for the database named 'zyn'
# (please refer to the DBI documentation for details)
PerlSetVar db_zyn_data_source dbi:mysql:zyn
PerlSetVar db_zyn_user my_username1
PerlSetVar db_zyn_password my_password1
PerlSetVar db_zyn_auto_commit 1
# configuration for the database named 'foo'
PerlSetVar db_foo_data_source dbi:Oracle:foo
PerlSetVar db_foo_user my_username2
PerlSetVar db_foo_password my_password2
PerlSetVar db_foo_auto_commit 0
DESCRIPTION
This module enables you to use the powerful CIPP HTML embedding
language together with the Apache webserver. It is based on
mod_perl and works as a request handler. So you can
transparently use CIPP pages everywhere on your webserver.
WHAT IS CIPP?
CIPP is a Perl module for translating CIPP sources to pure Perl
programs. CIPP defines a HTML embedding language also called
CIPP which has powerful features for CGI and database
developers.
Many standard CGI and database operations (and much more) are
covered by CIPP, so the developer does not need to code them
again and again.
CIPP is not part of this distribution, please download it from
CPAN.
SIMPLE CIPP EXAMPLE
To give you some imagination of what you can do with CIPP: here
is a (really) simple example of using CIPP in a HTML source to
retrieve some information from a database. Think this as a HTML
page which is "executed" on the fly by your Apache webserver.
Note: there is no code to connect to the database. This is done
implicitely. The configuration is taken from the Apache
configuration file(s).
# print table of users who match the given parameter
tiny litte CIPP example
Users matching '$search_name'
CONFIGURATION
Place the configuration options listed in the SYNOPSIS into your
Apache configuration file(s) (e.g. httpd.conf). The SYNOPSIS
example configures all files with the suffix .cipp to be handled
by Apache::CIPP. Please refer to the Apache documentation for
details about configuring your webserver.
The CIPP PDF documentation contains some more explantation of
the Apache::CIPP configuration parameters. Also CGI::CIPP
explains them briefly. You can download the documentation and
CGI::CIPP from CPAN.
DOWNLOAD Apache::CIPP
Apache::CIPP and friends can be downloaded from CPAN
$CPAN/modules/by-authors/id/J/JR/JRED/
INSTALLING Apache::CIPP
perl Makefile.PL
make
make test
make install
AUTHOR
Joern Reder
COPYRIGHT
Copyright 1998-1999 Joern Reder, All Rights Reserved
This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
SEE ALSO
perl(1), CIPP(3pm), CGI::CIPP(3pm), CIPP::Manual(3pm)