Classes:
Doctrine
Doctrine_Access
Doctrine_Adapter
Doctrine_Adapter_Db2_Exception
Doctrine_Adapter_Exception
Doctrine_Adapter_Statement
Doctrine_AuditLog
Doctrine_AuditLog_Listener
Doctrine_Collection
Doctrine_Collection_Exception
Doctrine_Collection_Iterator
Doctrine_Collection_Iterator_Expandable
Doctrine_Collection_Iterator_Normal
Doctrine_Collection_Iterator_Offset
Doctrine_Collection_Offset
Doctrine_Column
Doctrine_Compiler
Doctrine_Compiler_Exception
Doctrine_Configurable
Doctrine_Connection
Doctrine_Connection_Common
Doctrine_Connection_Db2
Doctrine_Connection_Exception
Doctrine_Connection_Firebird
Doctrine_Connection_Firebird_Exception
Doctrine_Connection_Informix
Doctrine_Connection_Informix_Exception
Doctrine_Connection_Mock
Doctrine_Connection_Module
Doctrine_Connection_Mssql
Doctrine_Connection_Mssql_Exception
Doctrine_Connection_Mysql
Doctrine_Connection_Mysql_Exception
Doctrine_Connection_Oracle
Doctrine_Connection_Oracle_Exception
Doctrine_Connection_Pgsql
Doctrine_Connection_Pgsql_Exception
Doctrine_Connection_Profiler
Doctrine_Connection_Profiler_Exception
Doctrine_Connection_Sqlite
Doctrine_Connection_Sqlite_Exception
Doctrine_Connection_Statement
Doctrine_Connection_UnitOfWork
Doctrine_DataDict
Doctrine_DataDict_Exception
Doctrine_DataDict_Informix
Doctrine_DataType
Doctrine_Db
Doctrine_Event
Doctrine_EventListener
Doctrine_EventListener_Chain
Doctrine_EventListener_Exception
Doctrine_Exception
Doctrine_Export
Doctrine_Export_Exception
Doctrine_Export_Firebird
Doctrine_Export_Frontbase
Doctrine_Export_Mssql
Doctrine_Export_Mysql
Doctrine_Export_Oracle
Doctrine_Export_Pgsql
Doctrine_Export_Reporter
Doctrine_Export_Schema
Doctrine_Export_Schema_Xml
Doctrine_Export_Schema_Yml
Doctrine_Export_Sqlite
Doctrine_Expression
Doctrine_Expression_Driver
Doctrine_Expression_Exception
Doctrine_Expression_Firebird
Doctrine_Expression_Informix
Doctrine_Expression_Mock
Doctrine_Expression_Mssql
Doctrine_Expression_Mysql
Doctrine_Expression_Oracle
Doctrine_Expression_Pgsql
Doctrine_Expression_Sqlite
Doctrine_File
Doctrine_File_Index
Doctrine_Formatter
Doctrine_Hook
Doctrine_Hook_Equal
Doctrine_Hook_Integer
Doctrine_Hook_Parser
Doctrine_Hook_Parser_Complex
Doctrine_Hook_WordLike
Doctrine_Hydrate
Doctrine_Hydrate_Array
Doctrine_Hydrate_Exception
Doctrine_Hydrate_Record
Doctrine_Import
Doctrine_Import_Builder
Doctrine_Import_Builder_BaseClass
Doctrine_Import_Builder_Exception
Doctrine_Import_Exception
Doctrine_Import_Firebird
Doctrine_Import_Informix
Doctrine_Import_Mssql
Doctrine_Import_Mysql
Doctrine_Import_Oracle
Doctrine_Import_Pgsql
Doctrine_Import_Reader
Doctrine_Import_Reader_Db
Doctrine_Import_Reader_Exception
Doctrine_Import_Reader_Xml_Propel
Doctrine_Import_Schema
Doctrine_Import_Schema_Xml
Doctrine_Import_Schema_Yml
Doctrine_Import_Sqlite
Doctrine_IntegrityMapper
Doctrine_Lib
Doctrine_Locking_Exception
Doctrine_Locking_Manager_Pessimistic
Doctrine_Manager
Doctrine_Manager_Exception
Doctrine_Node
Doctrine_Node_AdjacencyList
Doctrine_Node_AdjacencyList_LevelOrderIterator
Doctrine_Node_AdjacencyList_PostOrderIterator
Doctrine_Node_AdjacencyList_PreOrderIterator
Doctrine_Node_Exception
Doctrine_Node_MaterializedPath
Doctrine_Node_MaterializedPath_LevelOrderIterator
Doctrine_Node_MaterializedPath_PostOrderIterator
Doctrine_Node_MaterializedPath_PreOrderIterator
Doctrine_Node_NestedSet
Doctrine_Node_NestedSet_LevelOrderIterator
Doctrine_Node_NestedSet_PostOrderIterator
Doctrine_Node_NestedSet_PreOrderIterator
Doctrine_Null
Doctrine_Object
Doctrine_Plugin
Doctrine_Query
Doctrine_Query_Abstract
Doctrine_Query_Check
Doctrine_Query_Condition
Doctrine_Query_Exception
Doctrine_Query_Filter
Doctrine_Query_Filter_Chain
Doctrine_Query_From
Doctrine_Query_Groupby
Doctrine_Query_Having
Doctrine_Query_JoinCondition
Doctrine_Query_Limit
Doctrine_Query_Offset
Doctrine_Query_Orderby
Doctrine_Query_Parser
Doctrine_Query_Part
Doctrine_Query_Select
Doctrine_Query_Set
Doctrine_Query_Where
Doctrine_RawSql
Doctrine_RawSql_Exception
Doctrine_Record
Doctrine_Record_Abstract
Doctrine_Record_Exception
Doctrine_Record_Filter
Doctrine_Record_Iterator
Doctrine_Record_Listener
Doctrine_Record_Listener_Chain
Doctrine_Record_State_Exception
Doctrine_Relation
Doctrine_Relation_Association
Doctrine_Relation_Association_Self
Doctrine_Relation_Exception
Doctrine_Relation_ForeignKey
Doctrine_Relation_LocalKey
Doctrine_Relation_Nest
Doctrine_Relation_Parser
Doctrine_Relation_Parser_Exception
Doctrine_Schema
Doctrine_Schema_Column
Doctrine_Schema_Database
Doctrine_Schema_Exception
Doctrine_Schema_Object
Doctrine_Schema_Relation
Doctrine_Schema_Table
Doctrine_Search
Doctrine_Search_Analyzer
Doctrine_Search_Analyzer_Exception
Doctrine_Search_Analyzer_Standard
Doctrine_Search_Exception
Doctrine_Search_Indexer
Doctrine_Search_Indexer_Dir
Doctrine_Search_Indexer_Exception
Doctrine_Search_Listener
Doctrine_Search_Parser
Doctrine_Search_Query
Doctrine_Search_Record
Doctrine_Search_Scorer
Doctrine_Search_Template
Doctrine_Sequence
Doctrine_Sequence_Db2
Doctrine_Sequence_Exception
Doctrine_Sequence_Firebird
Doctrine_Sequence_Informix
Doctrine_Sequence_Mssql
Doctrine_Sequence_Mysql
Doctrine_Sequence_Oracle
Doctrine_Sequence_Pgsql
Doctrine_Sequence_Sqlite
Doctrine_Table
Doctrine_Table_Exception
Doctrine_Table_Repository
Doctrine_Table_Repository_Exception
Doctrine_Template
Doctrine_Template_NestedSet
Doctrine_Template_Searchable
Doctrine_Template_Taggable
Doctrine_Template_Versionable
Doctrine_Tokenizer
Doctrine_Transaction
Doctrine_Transaction_Exception
Doctrine_Transaction_Firebird
Doctrine_Transaction_Informix
Doctrine_Transaction_Mock
Doctrine_Transaction_Mssql
Doctrine_Transaction_Mysql
Doctrine_Transaction_Oracle
Doctrine_Transaction_Pgsql
Doctrine_Transaction_Sqlite
Doctrine_Tree
Doctrine_Tree_AdjacencyList
Doctrine_Tree_Exception
Doctrine_Tree_MaterializedPath
Doctrine_Tree_NestedSet
Doctrine_Util
Doctrine_Validator
Doctrine_Validator_Country
Doctrine_Validator_Creditcard
Doctrine_Validator_Date
Doctrine_Validator_Email
Doctrine_Validator_Enum
Doctrine_Validator_ErrorStack
Doctrine_Validator_Exception
Doctrine_Validator_HtmlColor
Doctrine_Validator_Ip
Doctrine_Validator_Minlength
Doctrine_Validator_Nospace
Doctrine_Validator_Notblank
Doctrine_Validator_Notnull
Doctrine_Validator_Range
Doctrine_Validator_Regexp
Doctrine_Validator_Unique
Doctrine_Validator_Unsigned
Doctrine_Validator_Usstate
Doctrine_View
Doctrine_View_Exception
Doctrine_Cache
Doctrine_Cache
Doctrine_Cache_Apc
Doctrine_Cache_Array
Doctrine_Cache_Db
Doctrine_Cache_Driver
Doctrine_Cache_Exception
Doctrine_Cache_Memcache
Doctrine_Adapter
Doctrine_Adapter_Db2
Doctrine_Adapter_Mock
Doctrine_Adapter_Mysqli
Doctrine_Adapter_Oracle
Doctrine_Adapter_Statement_Mock
Doctrine_DataDict
Doctrine_DataDict_Firebird
Doctrine_DataDict_Mssql
Doctrine_DataDict_Mysql
Doctrine_DataDict_Oracle
Doctrine_DataDict_Pgsql
Doctrine_DataDict_Sqlite

# Class: Doctrine_Connection_Mysql

Source Location: /Doctrine/Connection/Mysql.php

## Class Doctrine_Connection_Mysql

Class Overview

Doctrine_Connection_Mysql Located in /Doctrine/Connection/Mysql.php [line 34]
    Doctrine_Object
       |
       --Doctrine_Configurable
          |
          --Doctrine_Connection
             |
             --Doctrine_Connection_Common
                |
                --Doctrine_Connection_Mysql
Author(s): Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library) Konsta Vesterinen <kvesteri@cc.hut.fi> Information Tags:
Version: | $Revision: 1773 $
Link: | www.phpdoctrine.com
Since: | 1.0
License: | LGPL
| Properties $driverName | Methods __construct replace setCharset

[ Top ]
Inherited Properties, Constants, and Methods

Inherited Properties | Inherited Methods | Inherited Constants
--- | --- | ---
Inherited From Doctrine_Connection Doctrine_Connection::$availableDrivers Doctrine_Connection::$dbh Doctrine_Connection::$isConnected Doctrine_Connection::$modules Doctrine_Connection::$options Doctrine_Connection::$pendingAttributes Doctrine_Connection::$properties Doctrine_Connection::$serverInfo Doctrine_Connection::$supported Doctrine_Connection::$tables Doctrine_Connection::$_count Inherited From Doctrine_Configurable Doctrine_Configurable::$attributes Doctrine_Configurable::$parent Doctrine_Configurable::$_impl Inherited From Doctrine_Object Doctrine_Object::$_null | Inherited From Doctrine_Connection_Common Doctrine_Connection_Common::modifyLimitQuery() Adds an driver-specific LIMIT clause to the query Inherited From Doctrine_Connection Doctrine_Connection::__construct() the constructor Doctrine_Connection::addTable() addTable adds a Doctrine_Table object into connection registry Doctrine_Connection::beginTransaction() beginTransaction Start a transaction or set a savepoint. Doctrine_Connection::clear() clear clears all repositories Doctrine_Connection::close() close closes the connection Doctrine_Connection::commit() commit Commit the database changes done during a transaction that is in progress or release a savepoint. This function may only be called when auto-committing is disabled, otherwise it will fail. Doctrine_Connection::connect() connect connects into database Doctrine_Connection::convertBooleans() convertBooleans some drivers need the boolean values to be converted into integers when using DQL API Doctrine_Connection::count() returns the count of initialized table objects Doctrine_Connection::create() create creates a record Doctrine_Connection::driverName() converts given driver name Doctrine_Connection::errorCode() errorCode Fetch the SQLSTATE associated with the last operation on the database handle Doctrine_Connection::errorInfo() errorInfo Fetch extended error information associated with the last operation on the database handle Doctrine_Connection::evictTables() evictTables evicts all tables Doctrine_Connection::exec() exec Doctrine_Connection::execute() execute Doctrine_Connection::fetchAll() fetchAll Doctrine_Connection::fetchArray() fetchArray Doctrine_Connection::fetchAssoc() fetchAssoc Doctrine_Connection::fetchBoth() fetchBoth Doctrine_Connection::fetchColumn() fetchColumn Doctrine_Connection::fetchOne() fetchOne Doctrine_Connection::fetchRow() fetchRow Doctrine_Connection::flush() flush saves all the records from all tables this operation is isolated using a transaction Doctrine_Connection::getAttribute() getAttribute retrieves a database connection attribute Doctrine_Connection::getAvailableDrivers() returns an array of available PDO drivers Doctrine_Connection::getDbh() returns the database handler of which this connection uses Doctrine_Connection::getIterator() returns an iterator that iterators through all initialized table objects Doctrine_Connection::getManager() returns the manager that created this connection Doctrine_Connection::getName() getName returns the name of this driver Doctrine_Connection::getTable() returns a table object for given component name Doctrine_Connection::getTables() returns an array of all initialized tables Doctrine_Connection::getTransactionLevel() get the current transaction nesting level Doctrine_Connection::hasTable() hasTable whether or not this connection has table $name initialized Doctrine_Connection::incrementQueryCount() Doctrine_Connection::insert() Inserts a table row with specified data. Doctrine_Connection::lastInsertId() lastInsertId Doctrine_Connection::prepare() prepare Doctrine_Connection::query() query queries the database using Doctrine Query Language returns a collection of Doctrine_Record objects Doctrine_Connection::queryOne() query queries the database using Doctrine Query Language and returns the first record found Doctrine_Connection::quote() quote quotes given input parameter Doctrine_Connection::quoteIdentifier() Quote a string so it can be safely used as a table or column name Doctrine_Connection::replace() Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT query, except that if there is already a row in the table with the same key field values, the REPLACE query just updates its values instead of inserting a new row. Doctrine_Connection::rethrowException() rethrowException Doctrine_Connection::rollback() rollback Doctrine_Connection::select() queries the database with limit and offset added to the query and returns a PDOStatement object Doctrine_Connection::setAttribute() setAttribute sets an attribute Doctrine_Connection::setCharset() Set the charset on the current connection Doctrine_Connection::setDateFormat() Set the date/time format for the current connection Doctrine_Connection::standaloneQuery() standaloneQuery Doctrine_Connection::supports() supports Doctrine_Connection::__get() __get lazy loads given module and returns it Doctrine_Connection::__toString() returns a string representation of this object Inherited From Doctrine_Configurable Doctrine_Configurable::addListener() addListener Doctrine_Configurable::addRecordListener() addRecordListener Doctrine_Configurable::getAttribute() returns the value of an attribute Doctrine_Configurable::getAttributes() getAttributes returns all attributes as an array Doctrine_Configurable::getCacheDriver() getCacheDriver Doctrine_Configurable::getImpl() getImpl returns the implementation for given class Doctrine_Configurable::getListener() getListener Doctrine_Configurable::getParent() getParent returns the parent of this component Doctrine_Configurable::getRecordListener() getListener Doctrine_Configurable::setAttribute() setAttribute sets a given attribute Doctrine_Configurable::setEventListener() Doctrine_Configurable::setImpl() setImpl binds given class to given template name Doctrine_Configurable::setListener() setListener Doctrine_Configurable::setParent() sets a parent for this configurable component the parent must be configurable component itself Doctrine_Configurable::setRecordListener() setListener Inherited From Doctrine_Object Doctrine_Object::getNullObject() getNullObject returns the null object associated with this object Doctrine_Object::initNullObject() initNullObject initializes the null object |

[ Top ]
Property Summary

string | $driverName |

[ Top ]
Method Summary

Doctrine_Connection_Mysql | __construct() | the constructor
integer | replace() | Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT query, except that if there is already a row in the table with the same key field values, the REPLACE query just updates its values instead of inserting a new row.
void | setCharset() | Set the charset on the current connection

[ Top ]
Properties
string $driverName = 'Mysql' [line 39]
API Tags:

Access: | protected

Redefinition of:

Doctrine_Connection::$driverName

[ Top ]
Methods
Constructor __construct [line 46]

`Doctrine_Connection_Mysql __construct( Doctrine_Manager $manager, PDO|Doctrine_Adapter $adapter )`

the constructor

Parameters:

Doctrine_Manager | $manager: |
PDO|Doctrine_Adapter | $adapter: | database handler

API Tags:

Access: | public

Redefinition of:

Doctrine_Connection::__construct()
  the constructor

[ Top ]
replace [line 167]

`integer replace( string $table, $fields, $keys )`

Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT query, except that if there is already a row in the table with the same key field values, the REPLACE query just updates its values instead of inserting a new row.

The REPLACE type of query does not make part of the SQL standards. Since practically only MySQL implements it natively, this type of query is emulated through this method for other DBMS using standard types of queries inside a transaction to assure the atomicity of the operation.

Parameters:

string | $table: | name of the table on which the REPLACE query will be executed.
array | $fields: | associative array that describes the fields and the values that will be inserted or updated in the specified table. The indexes of the array are the names of all the fields of the table. The values of the array are also associative arrays that describe the values and other properties of the table fields. Here follows a list of field properties that need to be specified: value: Value to be assigned to the specified field. This value may be of specified in database independent type format as this function can perform the necessary datatype conversions. Default: this property is required unless the Null property is set to 1. type Name of the type of the field. Currently, all types Metabase are supported except for clob and blob. Default: no type conversion null Boolean property that indicates that the value for this field should be set to null. The default value for fields missing in INSERT queries may be specified the definition of a table. Often, the default value is already null, but since the REPLACE may be emulated using an UPDATE query, make sure that all fields of the table are listed in this function argument array. Default: 0 key Boolean property that indicates that this field should be handled as a primary key or at least as part of the compound unique index of the table that will determine the row that will updated if it exists or inserted a new row otherwise. This function will fail if no key field is specified or if the value of a key field is set to null because fields that are part of unique index they may not be null. Default: 0
array | $keys: |

API Tags:

Return: | the number of affected rows
Access: | public

Redefinition of:

Doctrine_Connection::replace()
  Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT query, except that if there is already a row in the table with the same key field values, the REPLACE query just updates its values instead of inserting a new row.

[ Top ]
setCharset [line 98]

`void setCharset( string $charset )`

Set the charset on the current connection

Parameters:

string | $charset: | charset

API Tags:

Access: | public

Redefinition of:

Doctrine_Connection::setCharset()
  Set the charset on the current connection

[ Top ]