php-src/ext/pdo
Marcus Boerger a72a517e2f - Add ability to execute .php generated from .phpt on failure without the
need to manually set the environment.
2005-09-21 18:40:56 +00:00
..
tests - Add ability to execute .php generated from .phpt on failure without the 2005-09-21 18:40:56 +00:00
config.m4 Fix PECL Bug #5010 2005-09-11 19:44:26 +00:00
config.w32 build pdo statically on win32, so sqlite2 driver will build. 2005-03-12 01:15:37 +00:00
CREDITS Hello PDO. 2004-05-17 15:41:51 +00:00
EXPERIMENTAL Hello PDO. 2004-05-17 15:41:51 +00:00
Makefile.frag Allow it build with PHP 5.0.x and up again. 2005-05-14 20:06:54 +00:00
package.xml Fix PECL Bug #5010 2005-09-11 19:44:26 +00:00
pdo_dbh.c MFH: Allow overloading of PDO constructor. 2005-09-20 19:52:24 +00:00
pdo_sql_parser.c and touch the generated file 2005-09-10 20:58:57 +00:00
pdo_sql_parser.re actually register PDO_PARAM_BOOL as a constant (doh!). 2005-09-10 20:58:19 +00:00
pdo_sqlstate.c Add sqlstates defined in PostgreSQL documentation. 2005-07-01 23:32:39 +00:00
pdo_stmt.c When populating bound columns, override the returned type with the type 2005-09-11 20:32:28 +00:00
pdo.c MFH: Make PDO use class constants 2005-09-20 00:35:21 +00:00
pdo.php update ready for release 2005-02-09 04:54:56 +00:00
php_pdo_driver.h Proper handling for databases that need to pre-calculate length of large 2005-07-20 03:38:33 +00:00
php_pdo_int.h fix build (declare extern HashTable pdo_driver_hash) 2005-09-18 18:05:59 +00:00
php_pdo.h MFH: Allow overloading of PDO constructor. 2005-09-20 19:52:24 +00:00
README rename ancient method 2005-02-09 23:34:53 +00:00
TODO better handling of pdo-level errors 2005-02-06 21:05:59 +00:00

$Id$

PHP Data Objects
================

Concept: Data Access Abstraction

Goals:

1/  Be light-weight
2/  Provide common API for common database operations
3/  Be performant
4/  Keep majority of PHP specific stuff in the PDO core (such as persistent
    resource management); drivers should only have to worry about getting the
    data and not about PHP internals.


Transactions and autocommit
===========================

When you create a database handle, you *should* specify the autocommit
behaviour that you require.  PDO will default to autocommit on.

$dbh = new PDO("...", $user, $pass, array(PDO_ATTR_AUTOCOMMIT => true));

When auto-commit is on, the driver will implicitly commit each query as it is
executed.  This works fine for most simple tasks but can be significantly
slower when you are making a large number of udpates.

$dbh = new PDO("...", $user, $pass, array(PDO_ATTR_AUTOCOMMIT => false));

When auto-commit is off, you must then use $dbh->beginTransaction() to
initiate a transaction.  When your work is done, you then call $dbh->commit()
or $dbh->rollBack() to persist or abort your changes respectively.  Not all
databases support transactions.

You can change the auto-commit mode at run-time:

$dbh->setAttribute(PDO_ATTR_AUTOCOMMIT, false);

Regardless of the error handling mode set on the database handle, if the
autocommit mode cannot be changed, an exception will be thrown.

Some drivers will allow you to temporarily disable autocommit if you call
$dbh->beginTransaction().  When you commit() or rollBack() such a transaction,
the handle will switch back to autocommit mode again.  If the mode could not
be changed, an exception will be raised, as noted above.

When the database handle is closed or destroyed (or at request end for
persistent handles), the driver will implicitly rollBack().  It is your
responsibility to call commit() when you are done making changes and
autocommit is turned off.

vim:tw=78:et