Docs For Class atkMysqliDb

Home

Documentation home

Atk index

Docs For Class atkMysqliDb [ package: atk ]

Class: atkMysqliDb

Source Location: /db/class.atkmysqlidb.inc

Class atkMysqliDb

Class Overview

Driver for MySQL databases > 4.1.3

Located in /db/class.atkmysqlidb.inc [line 30]

Wiki documentation

atkDb
   |
   --atkMysqlDb
      |
      --atkMysqliDb

Author(s):

Eldad Ran <eldad@tele-concept.com>

Information Tags:

Methods

[ Top ]

Inherited from parent

Inherited Properties	Inherited Methods
Inherited From atkMysqlDb atkMysqlDb::$m_identifierQuoting atkMysqlDb::$m_seq_field atkMysqlDb::$m_seq_namefield atkMysqlDb::$m_seq_table atkMysqlDb::$m_type Inherited From atkDb atkDb::$m_affected_rows atkDb::$m_auto_free atkDb::$m_charset atkDb::$m_collate atkDb::$m_connection atkDb::$m_database atkDb::$m_errno atkDb::$m_error atkDb::$m_errorLookup atkDb::$m_haltonerror atkDb::$m_host atkDb::$m_link_id atkDb::$m_mode atkDb::$m_password atkDb::$m_port atkDb::$m_query_id atkDb::$m_record atkDb::$m_row atkDb::$m_tableMeta atkDb::$m_user atkDb::$m_user_error atkDb::$m_vendor	Inherited From atkMysqlDb atkMysqlDb::affected_rows() Evaluate the result; which rows were affected by the query. atkMysqlDb::atkmysqldb() Base constructor atkMysqlDb::disconnect() Disconnect from database atkMysqlDb::doConnect() Connect to the database atkMysqlDb::dropAll() Drop all database tables. atkMysqlDb::func_datetimetochar() Get TO_CHAR() equivalent for the current database. atkMysqlDb::func_datetochar() Get TO_CHAR() equivalent for the current database. atkMysqlDb::getColumnLength() Mysql_field_len returns unusable results for decimal,float and double column types. atkMysqlDb::getErrorType() Determine whether an error that occurred is a recoverable (user) error or a system error. atkMysqlDb::getSearchModes() This function indicates what searchmodes the database supports. atkMysqlDb::lock() Lock a certain table in the database atkMysqlDb::locktables_fallback_on_error() This method provides a fallback when error 1100 occurs (Table ... not locked using LOCK TABLES). This method locks the table and runs the query again. atkMysqlDb::metadata() Return the meta data of a certain table atkMysqlDb::nextid() Get the next sequence number of a certain sequence. atkMysqlDb::next_record() Goto the next record in the result set atkMysqlDb::num_fields() Evaluatie the result; how many fields where affected by the query. atkMysqlDb::num_rows() Evaluate the result; how many rows were affected by the query. atkMysqlDb::query() Performs a query atkMysqlDb::seek() Goto a certain position in result set. atkMysqlDb::setSequenceValue() Set database sequence value. atkMysqlDb::tableExists() This function checks the database for a table with the provide name atkMysqlDb::table_names() Return the available table names atkMysqlDb::unlock() Unlock table(s) in the database atkMysqlDb::vendorDateFormat() Convert a php date() format specifier to a mysql specific format specifier. atkMysqlDb::_getTableType() Returns the table type. atkMysqlDb::_setErrorVariables() Store MySQL errors in internal variables atkMysqlDb::_translateError() Translates known database errors to developer-friendly messages Inherited From atkDb atkDb::affected_rows() Retrieve the number of rows affected by the last query. atkDb::clearMapping() Clear the current database mapping. atkDb::cloneAll() Clones the database structure of the given database to this database. This also means the complete database is emptied beforehand. atkDb::commit() Commit the current transaction. atkDb::connect() Connect to the database. atkDb::createDDL() Create an atkDDL object for constructing ddl queries. atkDb::createQuery() Create an atkQuery object for constructing queries. atkDb::deleteAll() Empty all database tables. atkDb::disconnect() Disconnect from database atkDb::doConnect() Connect to the database atkDb::dropAll() Drop all database tables. atkDb::errorLookup() Looks up the error atkDb::escapeSQL() escapes quotes for use in SQL: ' -> '' (and sometimes % -> %%) atkDb::func_concat() Get CONCAT() equivalent for the current database. atkDb::func_concat_ws() Get CONCAT_WS() equivalent for the current database. atkDb::func_datetimetochar() Get TO_CHAR() equivalent for the current database. atkDb::func_datetochar() Get TO_CHAR() equivalent for the current database. atkDb::func_now() get NOW() or SYSDATE() equivalent for the current database atkDb::func_substring() get SUBSTRING() equivalent for the current database. atkDb::getAtkDbErrno() Get generic atk errorccode atkDb::getDbErrno() Get vendor-dependent database error number. atkDb::getDbError() Get vendor-dependent database error message. atkDb::getDbStatus() Check if current db is present and acceptable for current user atkDb::getErrorMsg() Get localized error message (for display in the application) atkDb::getErrorType() Determine whether an error that occurred is a recoverable (user) error or a system error. atkDb::getInstance() Get database instance. atkDb::getMapping() Returns the current database mapping. atkDb::getQueryMode() Returns the query mode atkDb::getrows() Get all rows that are the result of a certain specified query atkDb::getSearchModes() This function indicates what searchmodes the database supports. atkDb::getTranslatedDatabaseName() Returns the real database name. If a mapping atkDb::getType() Get the database driver type. atkDb::getValue() Get a single value (first row, first column) from a certain specified query atkDb::getValues() Get an array with all the values in the (first) column. atkDb::halt() If haltonerror is set, this will raise an atkerror. If not, it will place the error in atkdebug and continue. atkDb::hasError() Has error? atkDb::hasMode() Check if the current instance has the given mode atkDb::init() (Re)Initialise a database driver with a connection atkDb::link_id() Get the current connection. atkDb::lock() Lock a table in the database. atkDb::maxIdentifierLength() Returns the maximum length an identifier (tablename, columnname, etc) may have atkDb::metadata() Return the meta data of a certain table HIE GEBLEVEN atkDb::nextid() Get the next sequence number of a certain sequence. atkDb::next_record() Retrieve the next record in the resultset. atkDb::query() Parse and execute a query. atkDb::query_id() Get the current query statement resource id. atkDb::quoteIdentifier() Quote Indentifier atkDb::rollback() Rollback the current transaction. atkDb::savepoint() Set savepoint with the given name. atkDb::setHaltOnError() Halt on error or not? atkDb::setInstance() Replace the current instance of a named connection at runtime with a different connection. This is useful for example for replacing a named database instance with a mock object for testing purposes. atkDb::setSequenceValue() Set database sequence value. atkDb::setUserError() Define custom user error codes. atkDb::tableExists() This function checks the database for a table with the provide name atkDb::tableMeta() Fetches table meta data from database atkDb::table_names() Return the available table names atkDb::toggleForeignKeys() Enable/disable all foreign key constraints. atkDb::unlock() Relieve all locks. atkDb::useMapping() Use the given mapping to translate database requests from one database to another database. This can be used for test purposes. atkDb::vendorDateFormat() Convert a php date() format specifier to a vendor specific format specifier. atkDb::_getOrUseMapping() Get or set the database mapping atkDb::_getTableMetaFromCache() If cached it'll return the table metadata from cache. atkDb::_getTableMetaFromDb() Returns the tablemetadata directly from db atkDb::_translateError() Translate database-vendor dependent error messages into an ATK generic error code.

Inherited Properties

Inherited Methods

Inherited From atkMysqlDb

atkMysqlDb::$m_identifierQuoting

atkMysqlDb::$m_seq_field

atkMysqlDb::$m_seq_namefield

atkMysqlDb::$m_seq_table

atkMysqlDb::$m_type

Inherited From atkDb

atkDb::$m_affected_rows

atkDb::$m_auto_free

atkDb::$m_charset

atkDb::$m_collate

atkDb::$m_connection

atkDb::$m_database

atkDb::$m_errno

atkDb::$m_error

atkDb::$m_errorLookup

atkDb::$m_haltonerror

atkDb::$m_host

atkDb::$m_link_id

atkDb::$m_mode

atkDb::$m_password

atkDb::$m_port

atkDb::$m_query_id

atkDb::$m_record

atkDb::$m_row

atkDb::$m_tableMeta

atkDb::$m_user

atkDb::$m_user_error

atkDb::$m_vendor

Inherited From atkMysqlDb

atkMysqlDb::affected_rows()

Evaluate the result; which rows were affected by the query.

atkMysqlDb::atkmysqldb()

Base constructor

atkMysqlDb::disconnect()

Disconnect from database

atkMysqlDb::doConnect()

Connect to the database

atkMysqlDb::dropAll()

Drop all database tables.

atkMysqlDb::func_datetimetochar()

Get TO_CHAR() equivalent for the current database.

atkMysqlDb::func_datetochar()

Get TO_CHAR() equivalent for the current database.

atkMysqlDb::getColumnLength()

Mysql_field_len returns unusable results for decimal,float and double column types.

atkMysqlDb::getErrorType()

Determine whether an error that occurred is a recoverable (user) error or a system error.

atkMysqlDb::getSearchModes()

This function indicates what searchmodes the database supports.

atkMysqlDb::lock()

Lock a certain table in the database

atkMysqlDb::locktables_fallback_on_error()

This method provides a fallback when error 1100 occurs (Table ... not locked using LOCK TABLES). This method locks the table and runs the query again.

atkMysqlDb::metadata()

Return the meta data of a certain table

atkMysqlDb::nextid()

Get the next sequence number of a certain sequence.

atkMysqlDb::next_record()

Goto the next record in the result set

atkMysqlDb::num_fields()

Evaluatie the result; how many fields where affected by the query.

atkMysqlDb::num_rows()

Evaluate the result; how many rows were affected by the query.

atkMysqlDb::query()

Performs a query

atkMysqlDb::seek()

Goto a certain position in result set.

atkMysqlDb::setSequenceValue()

Set database sequence value.

atkMysqlDb::tableExists()

This function checks the database for a table with the provide name

atkMysqlDb::table_names()

Return the available table names

atkMysqlDb::unlock()

Unlock table(s) in the database

atkMysqlDb::vendorDateFormat()

Convert a php date() format specifier to a mysql specific format specifier.

atkMysqlDb::_getTableType()

Returns the table type.

atkMysqlDb::_setErrorVariables()

Store MySQL errors in internal variables

atkMysqlDb::_translateError()

Translates known database errors to developer-friendly messages

Inherited From atkDb

atkDb::affected_rows()

Retrieve the number of rows affected by the last query.

atkDb::clearMapping()

Clear the current database mapping.

atkDb::cloneAll()

Clones the database structure of the given database to this database. This also means the complete database is emptied beforehand.

atkDb::commit()

Commit the current transaction.

atkDb::connect()

Connect to the database.

atkDb::createDDL()

Create an atkDDL object for constructing ddl queries.

atkDb::createQuery()

Create an atkQuery object for constructing queries.

atkDb::deleteAll()

Empty all database tables.

atkDb::disconnect()

Disconnect from database

atkDb::doConnect()

Connect to the database

atkDb::dropAll()

Drop all database tables.

atkDb::errorLookup()

Looks up the error

atkDb::escapeSQL()

escapes quotes for use in SQL: ' -> '' (and sometimes % -> %%)

atkDb::func_concat()

Get CONCAT() equivalent for the current database.

atkDb::func_concat_ws()

Get CONCAT_WS() equivalent for the current database.

atkDb::func_datetimetochar()

Get TO_CHAR() equivalent for the current database.

atkDb::func_datetochar()

Get TO_CHAR() equivalent for the current database.

atkDb::func_now()

get NOW() or SYSDATE() equivalent for the current database

atkDb::func_substring()

get SUBSTRING() equivalent for the current database.

atkDb::getAtkDbErrno()

Get generic atk errorccode

atkDb::getDbErrno()

Get vendor-dependent database error number.

atkDb::getDbError()

Get vendor-dependent database error message.

atkDb::getDbStatus()

Check if current db is present and acceptable for current user

atkDb::getErrorMsg()

Get localized error message (for display in the application)

atkDb::getErrorType()

Determine whether an error that occurred is a recoverable (user) error or a system error.

atkDb::getInstance()

Get database instance.

atkDb::getMapping()

Returns the current database mapping.

atkDb::getQueryMode()

Returns the query mode

atkDb::getrows()

Get all rows that are the result of a certain specified query

atkDb::getSearchModes()

This function indicates what searchmodes the database supports.

atkDb::getTranslatedDatabaseName()

Returns the real database name. If a mapping

atkDb::getType()

Get the database driver type.

atkDb::getValue()

Get a single value (first row, first column) from a certain specified query

atkDb::getValues()

Get an array with all the values in the (first) column.

atkDb::halt()

If haltonerror is set, this will raise an atkerror. If not, it will place the error in atkdebug and continue.

atkDb::hasError()

Has error?

atkDb::hasMode()

Check if the current instance has the given mode

atkDb::init()

(Re)Initialise a database driver with a connection

atkDb::link_id()

Get the current connection.

atkDb::lock()

Lock a table in the database.

atkDb::maxIdentifierLength()

Returns the maximum length an identifier (tablename, columnname, etc) may have

atkDb::metadata()

Return the meta data of a certain table HIE GEBLEVEN

atkDb::nextid()

Get the next sequence number of a certain sequence.

atkDb::next_record()

Retrieve the next record in the resultset.

atkDb::query()

Parse and execute a query.

atkDb::query_id()

Get the current query statement resource id.

atkDb::quoteIdentifier()

Quote Indentifier

atkDb::rollback()

Rollback the current transaction.

atkDb::savepoint()

Set savepoint with the given name.

atkDb::setHaltOnError()

Halt on error or not?

atkDb::setInstance()

Replace the current instance of a named connection at runtime with a different connection. This is useful for example for replacing a named database instance with a mock object for testing purposes.

atkDb::setSequenceValue()

Set database sequence value.

atkDb::setUserError()

Define custom user error codes.

atkDb::tableExists()

This function checks the database for a table with the provide name

atkDb::tableMeta()

Fetches table meta data from database

atkDb::table_names()

Return the available table names

atkDb::toggleForeignKeys()

Enable/disable all foreign key constraints.

atkDb::unlock()

Relieve all locks.

atkDb::useMapping()

Use the given mapping to translate database requests from one database to another database. This can be used for test purposes.

atkDb::vendorDateFormat()

Convert a php date() format specifier to a vendor specific format specifier.

atkDb::_getOrUseMapping()

Get or set the database mapping

atkDb::_getTableMetaFromCache()

If cached it'll return the table metadata from cache.

atkDb::_getTableMetaFromDb()

Returns the tablemetadata directly from db

atkDb::_translateError()

Translate database-vendor dependent error messages into an ATK generic error code.

[ Top ]

Method Summary

affected	affected_rows()	Evaluate the result; which rows were affected by the query.
void	atkmysqlidb()	Base constructor
bool	commit()	Commit the current transaction.
void	disconnect()	Disconnect from database
mixed	doConnect()	Connect to the database
int	getInsertId()	Returns the last inserted auto increment value.
result	lock()	Lock a certain table in the database
void	locktables_fallback_on_error()	This method provides a fallback when error 1100 occurs (Table ... not locked using LOCK TABLES). This method locks the table and runs the query again.
array	metadata()	Return the meta data of a certain table
the	nextid()	Get the next sequence number of a certain sequence.
result	next_record()	Goto the next record in the result set
number	num_fields()	Evaluatie the result; how many fields where affected by the query.
number	num_rows()	Evaluate the result; how many rows were affected by the query.
void	query()	Performs a query
void	rollback()	Rollback the the current transaction.
void	savepoint()	Set savepoint with the given name.
void	seek()	Goto a certain position in result set.
array	table_names()	Return the available table names
void	toggleForeignKeys()	Enable/disable all foreign key constraints.
result	unlock()	Unlock table(s) in the database
void	_debugWarnings()	Get all MySQL warnings for the previously executed query and make atkwarnings of them.
void	_setErrorVariables()	Store MySQL errors in internal variables

[ Top ]

Properties

Methods

affected_rows [line 333]

affected affected_rows(
)

Evaluate the result; which rows were affected by the query.

API Tags:

Return:

rows

Redefinition of:

atkMysqlDb::affected_rows(): Evaluate the result; which rows were affected by the query.

[ Top ]

atkmysqlidb [line 35]

void atkmysqlidb(
)

Base constructor

[ Top ]

commit [line 507]

bool commit(
)

Commit the current transaction.

API Tags:

Return:

true

Redefinition of:

atkDb::commit(): Commit the current transaction.

[ Top ]

disconnect [line 109]

void disconnect(
)

Disconnect from database

Redefinition of:

atkMysqlDb::disconnect(): Disconnect from database

[ Top ]

doConnect [line 59]

mixed doConnect(
string
$host, string
$user, string
$password, string
$database, int
$port, string
$charset 
)

Connect to the database

Parameters:

string	$host:	Hostname
string	$user:	Username
string	$password:	Password
string	$database:	The database to connect to
int	$port:	The portnumber to use for connecting
string	$charset:	The charset to use

API Tags:

Return:

Connection status

Redefinition of:

atkMysqlDb::doConnect(): Connect to the database

[ Top ]

getInsertId [line 567]

int getInsertId(
)

Returns the last inserted auto increment value.

API Tags:

Return:	auto increment value of latest insert query
Access:	public

[ Top ]

lock [line 285]

result lock(
string
$table, [string
$mode = "write"] 
)

Lock a certain table in the database

Parameters:

string	$table:	the table name
string	$mode:	the type of locking

API Tags:

Return:

of locking

Redefinition of:

atkMysqlDb::lock(): Lock a certain table in the database

[ Top ]

locktables_fallback_on_error [line 215]

void locktables_fallback_on_error(
string
$query, [string
$querymode = 'w'] 
)

This method provides a fallback when error 1100 occurs (Table ... not locked using LOCK TABLES). This method locks the table and runs the query again.

Parameters:

string	$query:	The original query that failed
string	$querymode:	Kind of query - 'w' for write or 'r' for read

Redefinition of:

atkMysqlDb::locktables_fallback_on_error(): This method provides a fallback when error 1100 occurs (Table ... not locked using LOCK TABLES). This method locks the table and runs the query again.

[ Top ]

metadata [line 414]

array metadata(
string
$table, [bool
$full = false] 
)

Return the meta data of a certain table

Parameters:

string	$table:	the table name
bool	$full:	all meta data or not

API Tags:

Return:

with meta data

Redefinition of:

atkMysqlDb::metadata(): Return the meta data of a certain table

[ Top ]

nextid [line 364]

the nextid(
string
$sequence 
)

Get the next sequence number of a certain sequence.

Parameters:

string

$sequence:

the sequence name

API Tags:

Return:

next sequence id

Redefinition of:

atkMysqlDb::nextid(): Get the next sequence number of a certain sequence.

[ Top ]

next_record [line 246]

result next_record(
)

Goto the next record in the result set

API Tags:

Return:

of going to the next record

Redefinition of:

atkMysqlDb::next_record(): Goto the next record in the result set

[ Top ]

num_fields [line 353]

number num_fields(
)

Evaluatie the result; how many fields where affected by the query.

API Tags:

Return:

of affected fields

Redefinition of:

atkMysqlDb::num_fields(): Evaluatie the result; how many fields where affected by the query.

[ Top ]

num_rows [line 343]

number num_rows(
)

Evaluate the result; how many rows were affected by the query.

API Tags:

Return:

of affected rows

Redefinition of:

atkMysqlDb::num_rows(): Evaluate the result; how many rows were affected by the query.

[ Top ]

query [line 125]

void query(
string
$query, [int
$offset = -1], [int
$limit = -1] 
)

Performs a query

Parameters:

string	$query:	the query
int	$offset:	offset in record list
int	$limit:	maximum number of records

Redefinition of:

atkMysqlDb::query(): Performs a query

[ Top ]

rollback [line 533]

void rollback(
[string
$savepoint = ""] 
)

Rollback the the current transaction.

Parameters:

string

$savepoint:

The savepoint to rollback to

Redefinition of:

atkDb::rollback(): Rollback the current transaction.

[ Top ]

savepoint [line 522]

void savepoint(
string
$name 
)

Set savepoint with the given name.

Parameters:

string

$name:

savepoint name

Redefinition of:

atkDb::savepoint(): Set savepoint with the given name.

[ Top ]

seek [line 272]

void seek(
[int
$position = 0] 
)

Goto a certain position in result set.

Not specifying a position will set the pointer at the beginning of the result set.

Parameters:

int

$position:

the position

Redefinition of:

atkMysqlDb::seek(): Goto a certain position in result set.

[ Top ]

table_names [line 481]

array table_names(
[bool
$includeViews = true] 
)

Return the available table names

Parameters:

bool

$includeViews:

Include views?

API Tags:

Return:

with table names etc.

Redefinition of:

atkMysqlDb::table_names(): Return the available table names

[ Top ]

toggleForeignKeys [line 557]

void toggleForeignKeys(
boolean
$enable 
)

Enable/disable all foreign key constraints.

Parameters:

boolean

$enable:

enable/disable foreign keys?

Redefinition of:

atkDb::toggleForeignKeys(): Enable/disable all foreign key constraints.

[ Top ]

unlock [line 312]

result unlock(
)

Unlock table(s) in the database

API Tags:

Return:

of unlocking

Redefinition of:

atkMysqlDb::unlock(): Unlock table(s) in the database

[ Top ]

_debugWarnings [line 191]

void _debugWarnings(
)

Get all MySQL warnings for the previously executed query and make atkwarnings of them.

API Tags:

Access:

private

[ Top ]

_setErrorVariables [line 92]

void _setErrorVariables(
)

Store MySQL errors in internal variables

API Tags:

Access:

private

Redefinition of:

atkMysqlDb::_setErrorVariables(): Store MySQL errors in internal variables

[ Top ]