Bluestone PHP Library
=====================

A general purpose PHP library for web applications

The Bluestone project includes classes for handling:

- simple debugging, including backtraces
- database abstraction now supporting parameterized queries
- identifying file types based on content
- creating and altering database tables to match a scheme
- handling lots of features of HTTP including resuming and gzip encoding
- diff (comparing two files)
- validating, filtering and converting UTF-8 encoded strings
- simple conversion between text and HTML (ie, paragraph tags and not much more)

Compatible with PHP 5.2.4 and above. Some functionality in Bluestone may also be
provided by PHP extensions currently available, but is included in Bluestone for
maximum portability. For example, basic UTF-8 support such as validating and
filtering invalid characters, case conversion and word separation without the need
for users to install the mbstring extension.

Installation and use
====================

Bluestone can be used in your PHP application by placing its files
into any directory on the server.

In your application configuration, you should define where the bluestone
files are using the BLUESTONE_DIR constant.  Do not include the trailing
slash.

For example,

define(BLUESTONE_DIR, '/path/to/bluestone');

License
=======

Bluestone
Copyright (c) 2011, Thomas Rutter
All rights reserved.

The Bluestone library is available for use under the Modified BSD License included
in this distribution.

The Modified BSD License is an open source free software license compatible
with the GNU General Public License.  Bluestone may be redistributed in your own
software, commercial or open, providing that its few license terms are met.