Sergei G - 2012-05-30

uLogin Setup with External References

uLogin 0.4 code tree is desgined to be used by a single application. These instructions show how uLogin can be configured to be located in a shared directory referenced by multiple web applications.

Note: Reusing a single code instance of uLogin in multiple web applications is not supported by the author. The steps provided on this page might work, but are not officially supported. However, the author does by default support and even encourage the installation outside of the application's web directory, if used by a single application. In this case, the steps provided here are unnecessary.

Environment Configuration

Ussing the following environment configuration:

Directory Referenced As Description
~/extsw/ulogin-0.4/ $uLoginRoot ulogin zip content
~/extsw/ulogin-0.4/ulogin/ $uLoginLib ulogin PHP code directory
~/domain/ $webApp web application root directory
~/domain/includes $webLib web application directory included in PHP search path

Every time you see the variable referenced in this document it should be replaced with content from the table above.

$uLoginLib directory structure is produced by extracting distribution zip file.

You PHP include path must have $webLib directory added to include_path. It can be done in $webApp/.htaccess with:

php_value include_path "./includes:"

The idea is to create a softlink to ulogin library in includes directory:

cd $webLib
ln -s $uLoginLib

uLogin uses configuraiton files dispersed across its $uLogiLib directory tree. We have to disable these files by renaming them:

mv $uLoginLib/config.inc.php $uLoginLib/config.inc.php.sample
mv $uLoginLib/pdo/config.inc.php $uLoginLib/pdo/config.inc.php.sample

We now need to reproduce these files in our web application directory tree:

cp $uLoginLib/config.inc.php.sample $webLib/config.inc.php
mkdir $webLib/pdo
cp $uLoginLib/pdo/config.inc.php.sample $webLib/pdo/config.inc.php

Update content of config.inc.php files to match your configuration.

You are done.

 

Last edit: ultim 2012-06-02