$Id: README,v 1.3 2000/12/04 00:33:49 jgoff Exp $ -------- Abstract -------- POE::Component::UserBase manages user authentication tasks for multiple sessions, and provides a convenient repository for persistent data for each user. It is used when you need to authenticate users of your POE application. It currently assumes that users cannot be logged in multiple times, but it does allow for a single user to exist in multiple domains. ------------ Requirements ------------ This module requires POE. This requirement is encoded in Makefile.PL. In addition, it requires Storable to maintain the persistent data. It can optionally use the DBI module if you wish to authenticate from a database of some sort. ------------------ Basic Installation ------------------ [Note: This section is written in advance of PoCo::UserBase's placement on the CPAN. These steps are wrong, and you will find no joy following them. Please read the Manual Installation section instead.] POE::Component::UserBase may be installed through the CPAN shell in the usual CPAN shell manner. In a modern CPAN shell, this typically is: $ perl -MCPAN -e 'install POE::Component::UserBase' You can also read this README from the CPAN shell: $ perl -MCPAN -e shell cpan> readme POE::Component::UserBase And you can install the component from the CPAN prompt as well: cpan> install POE::Component::UserBase ------------------- Manual Installation ------------------- POE::Component::UserBase can also be installed manually. The latest CPAN version can be found at or in a similarly named directory at your favorite CPAN mirror. Downloading and unpacking the distribution are left as exercises for the reader. To build and test it: perl Makefile.PL make test A sample program, samples/tutorial-chat.perl, implements a simple IRC-like server with authentication and persistent nicks. If you would like to see more details about its operation, edit it and set the DEBUG constant to any value Perl considers "true". When you're ready to install the component: make install It should now be ready to use. --------------------------- EOF: Thank you for reading. ---------------------------