English readme version

README.en.md

@@ -0,0 +1,54 @@
+# PDO SQLCipher
+
+A driver for implementing [PDO](http://php.net/manual/en/book.pdo.php) (PHP Data Objects)  interface for [SQLCipher](http://sqlcipher.net) without replacing genuine PDO SQLite or the system version of [SQLite](http://www.sqlite.org/). It's based on PDO SQLite source code and created by simply replacing names and inserting SQLCipher code (instead of dynamic linking with SQLite libraries).
+
+A detachment of this kind allows granting access to encrypted databases only to applications that obviously need it, without fear of data loss or slowing down other applications.
+
+## Assembling
+
+To assemble this extension, run `build.sh` script. After successful assembly, all the necessary files will be placed in the directory named `release`:
+
+* `sqlcipher` - console client (equivalent of `sqlite3` client)
+* `pdo_sqlcipher.so` - php extension (equivalent of `pdo_sqlite.so` extension)
+
+If assembling is performed under Debain, the following dev packages may be required (in addition to standard):
+
+* `libicu-dev`
+* `libreadline-dev`
+* `libssl-dev`
+* `php5-dev`
+* `tcl-dev`
+
+If assembling is performed under RHEL, the following dev packages may be required (in addition to standard):
+
+* `libicu-devel`
+* `readline-devel`
+* `openssl-devel`
+* `php-devel`
+* `tcl-devel`
+
+If assembling is performed under FreeBSD, `lang/tcl-wrapper` port installation may be required (to support `tclsh`).
+
+Assembling script was tested under Debian Wheezy (PHP 5.4.4-14) and FreeBSD 9.1 (PHP 5.4.13)
+
+## Installation
+
+Install this extension by copying files from the `release` directory:
+
+* `sqlcipher` to the `/usr/local/bin/` directory 
+* `pdo_sqlcipher.so` to the directory of php modules (depends on specific distro):
+  * Debian:  `/usr/lib/php5/20100525/`
+  * RHEL:    `/usr/lib64/php/modules/`
+  * FreeBSD: `/usr/local/lib/php/20100525/`
+
+And enable the php extension:
+
+```
+extension=pdo_sqlcipher.so
+```
+
+* Debian:  `/etc/php5/conf.d/pdo_sqlcipher.ini`
+* RHEL:    `/etc/php.d/pdo_sqlcipher.ini`
+* FreeBSD: `/usr/local/etc/php/usr/local/etc/php/extensions.ini`
+
+You can find an example of extension usage in `example.php` file within the repository.

README.md

@@ -1,12 +1,12 @@
-PDO SQLCipher
+# PDO SQLCipher
-=============
+
+[English version](https://github.com/abbat/pdo_sqlcipher/blob/master/README.en.md)
 
 Драйвер, реализующий интерфейс [PDO](http://php.net/manual/en/book.pdo.php) (PHP Data Objects) для [SQLCipher](http://sqlcipher.net) без замещения оригинальной версии PDO SQLite или системной версии [SQLite](http://www.sqlite.org/). Основан на оригинальном коде PDO SQLite путем простого замещения имен и встраиванием кода SQLCipher (вместо динамической линковки с библиотеками SQLite).
 
 Подобное разделение позволяет работать с шифрованными базами только тем приложениям, которые в этом явно нуждаются не опасаясь потери данных или замедления работы остальных приложений.
 
-Сборка
+## Сборка
-======
 
 Для сборки расширения запустите скрипт `build.sh`. После успешной сборки необходимые файлы будут помещены в директорию `release`:
 
@@ -33,8 +33,7 @@ PDO SQLCipher
 
 Скрипт сборки протестирован на Debian Wheezy (PHP 5.4.4-14) и FreeBSD 9.1 (PHP 5.4.13)
 
-Установка
+## Установка
-=========
 
 Для установки расширения скопируйте файлы из директории `release`: