Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
=== PDO (SQLite) For Wordpress === Contributors: Justin Adie (http://rathercurious.net) Tags: database, PDO, sqlite, SQLite Requires at least: 2.3.0 Donate Link: rathercurious.net Tested up to: 2.9.1 Stable tag: 2.7.0 This 'plugin' enables WP to use databases supported by PHP's PDO abstraction layer. Currently, mysql and sqlite drivers are provided. == Description == Wordpress has for a long time, and for good reasons, been locked into using mysql as its database storage engine. There is a good discussion of 'why' [in the codex](http://codex.wordpress.org/Using_Alternative_Databases#Solutions/ "Codex Discussion") But this design choice has ramifications; not least because mysql's implementation of sql is not standard. Even with the use of the EZSQL abstraction layer bundled with Wordpress, this makes plugging in other databases very difficult. PDO For Wordpress is a step towards eliminating this difficulty. Think about this 'plugin' in four steps: 1. the basic layer takes all queries and separates out the variables from the language. It replaces each variable with a placeholder as well as stripping mysql specific 'nasties' like the slash-escaping and backticks. 1. then a language specific driver steps in and rewrites the query to use its own native constructs or (in the case of SQLite) pushes the query into some special user-defined functions 1. the basic layer then puts it all back together and runs the query, finally ... 1. returning the whole thing to the EZSQL abstraction layer so that Wordpress doesn't know that anything has gone awry See below/other notes for details of known limitations == Installation == This plugin is not a simple Wordpress plugin. Beware. You cannot just put the files in plugins and enable through the control panel. This is because the database needs to be connected adn established BEFORE the plugins are loaded. So ... to install PDO For Wordpress please do the following: 1. Step 1: unzip the files in your wp-content directory. After unzipping the structure should look like this wp-content ->plugins ->themes ->pdo db.php index.php[maybe] The key thing is the presence of the pdo directory and the db.php file in the 'root' of the wp-content directory. 1. Step 2: Edit your wp-config.php file so that: this line of code is placed directly after the define('COLLATE',''); line: define('DB_TYPE', 'sqlite'); //mysql or sqlite` Note: currently only mysql and sqlite are supported. I hope that more flavours will appear soon. As part of the general wordpress installation you should define your secret keys too (in wp-config.php). and that's it. two steps. The next time you load your wordpress installation it will automatically create the database and take you through the basic Wordpress installation routine. If you have problems with the installation you should receive a meaningful error messsage. If not, the most common error by far is permissions. You MUST make sure that php can read/write to wp-content/database. == Frequently Asked Questions == What databases are supported? Currently the basic layer supports any database that is supported by PDO. * MS SQL Server (PDO) â Microsoft SQL Server and Sybase Functions (PDO_DBLIB) * Firebird/Interbase (PDO) â Firebird/Interbase Functions (PDO_FIREBIRD) * IBM (PDO) â IBM Functions (PDO_IBM) * Informix (PDO) â Informix Functions (PDO_INFORMIX) * MySQL (PDO) â MySQL Functions (PDO_MYSQL) * Oracle (PDO) â Oracle Functions (PDO_OCI) * ODBC and DB2 (PDO) â ODBC and DB2 Functions (PDO_ODBC) * PostgreSQL (PDO) â PostgreSQL Functions (PDO_PGSQL) * SQLite (PDO) â SQLite Functions (PDO_SQLITE) Note that through the PDO_ODBC extension, all ODBC supported databases are also supported, subject to drivers being available HOWEVER each database needs its own driver and currently the only drivers written for this plugin are for * sqlite and * mysql The database does not install. Why? the main reason for this is permissions. The php process on your server needs to have permissions to create files and directories. Please contact me by leaving a comment at rathercurious.net if this is affecting you. == Screenshots == There are no screenshots == Known Limitations == * this plugin requires PHP 5.0 + as it uses PDO. There is no workaround. * the database schema cannot be upgraded through the WP automatic systems. I am working on this: it is non-trivial * some plugins will not upgrade as they use the WP upgrade functions to upgrade their databases. Create statements issued through dbdelta() WILL work, however * some plugins will not install/work as they do use native mysql calls rather than the WP abstraction layer. This is contrary to WordPress API guidelines. == To Do == * parameterise the database location to allow people to change the name and the location of the database * write a routine to allow upgrades/changes to the database schema. This is not easy as sqlite does not support the alter syntax to the same extent that mysql does. [We could just fudge this and leave old columns in the table]* examine and consider replacing some of the clunky code in the sqlite engine to use user defined functions in some cases (e.g. dates and if). * remove some of the clunky debug code * consider adding collation support. * remove inefficiency of object recreation at the end of the post-processing. it should be easier to keep the pdo resultset as an array of objects to start with. * consider using WP's own error handling class * consider revising the prepare->execute syntax to a pure query type syntax for certain types of query * consider altering the directory structure so that the majority of files can sit under the plugins directory and use the auto-updater. * or write an updater plugin (is that possible if they come from different sources?) == Attributions == Early versions of this plugin used a complete replacement for the WP abstraction layer. Thanks to Ulf Ninow for pointing out the value of inheritance to me and thus hugely simplifying the upkeep of the plugin. == Version Information == version 2.7.0 - 2010 January 13 changes in the WP installation code broke this plugin. Compatibility is now fixed through a rewrite of wp_install changes in 2.8.1 broke some other functionality. Essentially greater use of mysql >=4.1 functions means that it's a constant game of catch up to rewrite. Really the WP core team should go back to basics and use pure SQL ANSI syntax (particularly if the rumours about migration to MS SQL are true) Move to UDF's in place of a whole bunch of regex work. this should speed up execution. and other minor changes. still have to fix up the debug code. it's horribly clunky but we need very accurate feedback to debug failing queries... Version 2.6.1 - 2009 June 13 fix error in Optimize queries - thanks fnumatic fix small error in multi-inserts leading to problem with importing from existing wordpress installation NB there is still a problem with the regex on multi-inserts, as yet no fix but the error should not manifest except as a small performance decrease Version 2.6.0 - 2009 June 01 create a new query type to handle insert multiples fix bug with install routine and sqlite schema changes Version 2.5.0 - 2009 May 04 [version 2.0.0 + has had a bunch of problems in it (inc 2.4.0). how these crept in is unknown.] fixes inconsistency between string and integer based data comparisons in sqlite Version 2.4.0 - 2009 May 03 fix another installation problem linked to query buffering Version 2.3.0 - 2000 May 02 added some more checking into the install routine to avoid perms problems cleaned up the date handling thanks to Nicholas Schmid. This will improve permalinks Version 2.2.0 - 2009 April 29 create new tag and recommit because tag 2.1.0 was corrupt Version 2.1.0 - 2009 April 21 added global $wpdb to the connect method in PDOEngine.php fixed some umask errors Version 2.0.0 - 2009 April 03 overhaul of the sqlite code to use UDF's in place of regex (for the most part) overhaul of the base class to reuse the wpdb class by inheritance Version 1.0.2 - 2008 June 29 version control issue. not all files were committed to svn in 1.0.1 Version 1.0.1 - 2008 June 28 Fixed bug where the comments did not display in Manage Comments due to the use of index hints in the mysql sql