17515512: JanRain php-openid library included, normalization fix

git-svn-id: http://xe-core.googlecode.com/svn/sandbox@5137 201d5d3c-b55e-5fd7-737f-ddc643e51545

modules/member/php-openid-1.2.3/README

@@ -0,0 +1,122 @@
+
+PHP OpenID
+----------
+
+This is the PHP OpenID library by JanRain, Inc.  You can visit our
+website for more information about this package and other OpenID
+implementations and tools:
+
+  http://www.openidenabled.com/
+
+GETTING STARTED
+===============
+
+First, run the 'examples/detect.php' script either from the command
+line or via the web.  It will generate a report of any system
+configuration changes necessary to run the library.
+
+INSTALLATION
+============
+
+You will need PHP 4.3.0 or greater to use this library.  We have
+tested the library Linux on PHP 4.3.0, 4.4.1, 5.0.5, and 5.1.1.  We
+have tested the library on Windows XP on PHP 4.4.4.
+
+Follow these steps:
+
+1. Install dependencies.
+
+   - Enable either the GMP extension or Bcmath extension. (GMP is
+     STRONGLY recommended because it's MUCH faster!)  This is
+     required.
+
+   - Enable the CURL extension.
+
+   - If you plan to use SQLite, PostgreSQL, or MySQL to store OpenID
+     data, you'll need PEAR DB.  You can install this by running this
+     as root:
+
+     # pear install DB
+
+     You'll also need to install and enable the appropriate PHP
+     database extension.  Alternatively, you can store OpenID data on
+     the filesystem instead of using a relational database.  Nothing
+     special is required for using the filesystem method.
+
+   - Install either the DOM or domxml PHP XML processing extension,
+     but not both (they are incompatible).
+
+2. Use the PEAR installer to install the package.  To use the PEAR
+   installer, run this command from the package directory:
+
+   # pear install package.xml
+
+   If your PEAR version is sufficiently new, you can run this instead:
+
+   # pear install package2.xml
+
+   If the PEAR installer isn't available, you can copy the Auth/ and
+   Services/ directories into your PHP include path.
+
+TESTING YOUR SETUP
+==================
+
+You can use the example code to test your setup.  To run the example
+consumer or server, follow the instructions in the examples/README
+file.
+
+USING THE API
+=============
+
+The best way to get started using the API is to take a look at the
+example consumer and server in the examples/ directory.  See the
+examples/README file for more details.
+
+TROUBLESHOOTING
+===============
+
+On some systems, PHP basedir restrictions prevent web servers from
+opening a source of randomness, such as /dev/urandom.  If your PHP
+OpenID library has trouble getting a satisfactory source of
+randomness, check your Apache and PHP configurations to be sure that
+the randomness source is in the list of allowed paths for the
+"open_basedir" option.
+
+GETTING HELP
+============
+
+If you have any questions, recommendations, or patches, please tell
+us!  Subscribe to our OpenID development discussion list at
+
+  http://lists.openidenabled.com/mailman/listinfo/dev
+
+DOCUMENTATION
+=============
+
+You can view the HTML library documentation in the doc/ directory.
+You can also find it on the web at
+
+  http://www.openidenabled.com/resources/docs/openid/php/
+
+This package's documentation is in PhpDoc format.  To generate the
+documentation, install phpdoc and run the admin/makedoc.sh script.
+Phpdoc lives at:
+
+  http://www.phpdoc.org/
+
+CONTRIBUTING
+============
+
+If you have a bugfix or feature you'd like to contribute, don't
+hesitate to send it to us.  Post your patch to the development list at
+
+  http://lists.openidenabled.com/mailman/listinfo/dev
+
+To run the test suite included with this package, install PHPUnit 1.x
+and run
+
+  php admin/texttest.php
+
+PHPUnit 1.x can be found at
+
+  http://pear.phpunit.de/get/