RetailCRM-Mirror/doctrine2
1
0
Fork 0
mirror of synced 2025-02-01 04:51:45 +03:00
Code Issues Projects Releases Wiki Activity

added some docs for the upcoming new Doctrine_DB

Browse Source
This commit is contained in:
zYne 2006-09-29 11:49:50 +00:00
parent 487e07aea6
commit 0c94b003b1
10 changed files with 126 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
manual/codes/Basic Components - Connection - Querying the database.php
View File

@ -2,9 +2,13 @@
// select all users
$conn->query("FROM User");
$users = $conn->query("FROM User");
// select all users where user email is jackdaniels@drinkmore.info
$conn->query("FROM User WHERE User.Email.address = 'jackdaniels@drinkmore.info'");
$users = $conn->query("FROM User WHERE User.Email.address = 'jackdaniels@drinkmore.info'");
// using prepared statements
$users = $conn->query("FROM User WHERE User.name = ?", array('Jack'));
?>

34
manual/codes/Basic Components - DB - Chaining listeners.php Normal file
View File

@ -0,0 +1,34 @@
<?php
// using PDO dsn for connecting sqlite memory table
$dbh = Doctrine_DB::getConnection('sqlite::memory:');
class Counter extends Doctrine_DB_EventListener {
private $queries = 0;
public function onQuery(Doctrine_DB $dbh, $query, $params) {
$this->queries++;
}
public function count() {
return count($this->queries);
}
}
class OutputLogger extends Doctrine_Overloadable {
public function __call($m, $a) {
print $m." called!";
}
}
$counter = new Counter();
$dbh->addListener($counter);
$dbh->addListener(new OutputLogger());
$dbh->query("SELECT * FROM foo");
// prints:
// onPreQuery called!
// onQuery called!
print $counter->count(); // 1
?>

11
manual/codes/Basic Components - DB - Connecting to a database.php Normal file
View File

@ -0,0 +1,11 @@
<?php
// using PDO dsn for connecting sqlite memory table
$dbh = Doctrine_DB::getConnection('sqlite::memory:');
// using PEAR like dsn for connecting mysql database
$dsn = 'mysql://root:password@localhost/test';
$dbh = Doctrine_DB::getConnection($dsn);
?>

36
manual/codes/Basic Components - DB - Using event listeners.php Normal file
View File

@ -0,0 +1,36 @@
<?php
// using PDO dsn for connecting sqlite memory table
$dbh = Doctrine_DB::getConnection('sqlite::memory:');
class MyLogger extends Doctrine_DB_EventListener {
public function onPreQuery(Doctrine_DB $dbh, $query, $params) {
print "database is going to be queried!";
}
public function onQuery(Doctrine_DB $dbh, $query, $params) {
print "executed: $query";
}
}
$dbh->setListener(new MyLogger());
$dbh->query("SELECT * FROM foo");
// prints:
// database is going to be queried
// executed: SELECT * FROM foo
class MyLogger2 extends Doctrine_Overloadable {
public function __call($m, $a) {
print $m." called!";
}
}
$dbh->setListener(new MyLogger2());
$dbh->exec("DELETE FROM foo");
// prints:
// onPreExec called!
// onExec called!
?>

10
manual/codes/Basic Components - Record - Checking existence.php Normal file
View File

@ -0,0 +1,10 @@
<?php
$record = new User();
$record->exists(); // false
$record->name = 'someone';
$record->save();
$record->exists(); // true
?>

10
manual/codes/Basic Components - Record - Getting record state.php
View File

@ -3,27 +3,27 @@ $state = $record->getState();
switch($state):
case Doctrine_Record::STATE_PROXY:
// data access object is in proxy state,
// record is in proxy state,
// meaning its persistent but not all of its properties are
// loaded from the database
break;
case Doctrine_Record::STATE_TCLEAN:
// data access object is transient clean,
// record is transient clean,
// meaning its transient and
// none of its properties are changed
break;
case Doctrine_Record::STATE_TDIRTY:
// data access object is transient dirty,
// record is transient dirty,
// meaning its transient and
// some of its properties are changed
break;
case Doctrine_Record::STATE_DIRTY:
// data access object is dirty,
// record is dirty,
// meaning its persistent and
// some of its properties are changed
break;
case Doctrine_Record::STATE_CLEAN:
// data access object is clean,
// record is clean,
// meaning its persistent and
// none of its properties are changed
break;

1
manual/docs/Basic Components - Connection - Querying the database.php
View File

@ -0,0 +1 @@
Doctrine_Connection::query() is a simple method for efficient object retrieval. It takes one parameter (DQL query) and optionally prepared statement params.

10
manual/docs/Basic Components - DB - Connecting to a database.php Normal file
View File

@ -0,0 +1,10 @@
<?php
// using PDO dsn for connecting sqlite memory table
//$dbh = Doctrine_DB::getConnection('sqlite::memory:');
// using PEAR like dsn for connecting mysql database
//$dbh = Doctrine_DB::getConnection('mysql://root:password@localhost/test');
?>

10
manual/docs/Basic Components - DB - Introduction.php Normal file
View File

@ -0,0 +1,10 @@
Doctrine_DB is a wrapper for PDO database object. Why should you consider using Doctrine_DB instead of PDO?
<br \><br \>
1. It provides efficient eventlistener architecture, hence its easy to add new aspects to existing methods like on-demand-caching
<br \><br \>
2. Doctrine_DB lazy-connects database. Creating an instance of Doctrine_DB doesn't directly connect database, hence
Doctrine_DB fits perfectly for application using for example page caching.
<br \><br \>
3. It has many short cuts for commonly used fetching methods like Doctrine_DB::fetchOne().
<br \><br \>
4. Supports PEAR-like data source names as well as PDO data source names.

5
manual/documentation.php
View File

@ -144,7 +144,7 @@ $menu = array("Getting started" =>
"Getting record state",
"Getting object copy",
"Serializing",
"Existence checking",
"Checking Existence",
"Callbacks"),
"Connection"
=> array("Introduction",
@ -194,7 +194,8 @@ $menu = array("Getting started" =>
"DB" => array(
"Introduction",
"Connecting to a database",
"Using event listeners"),
"Using event listeners",
"Chaining listeners"),
/**
"Statement - <font color='red'>UNDER CONSTRUCTION</font>" => array("Introduction",
"Setting parameters",