The database class provides a wrapper of most common functions used for database access, and also others which simplify common queries. All queries performed with the database through the database abstraction layer can be analyzed for the execution time and further optimization.

Contents 1 Commonly Used 1.1 $db->query 1.2 $db->write_query 1.3 $db->simple_select 1.4 $db->fetch_array 1.5 $db->fetch_field 1.6 $db->num_rows 1.7 $db->insert_id 1.8 $db->insert_query 1.9 $db->update_query 1.10 $db->delete_query 1.11 $db->escape_string 2 Others 2.1 $db->connect 2.2 $db->select_db 2.3 $db->explain_query 2.4 $db->data_seek 2.5 $db->close 2.6 $db->error_number 2.7 $db->error 2.8 $db->dberror 2.9 $db->affected_rows 2.10 $db->num_fields 2.11 $db->list_tables 2.12 $db->table_exists 2.13 $db->field_exists 2.14 $db->shutdown_query 2.15 $db->select_query 2.16 $db->get_version 2.17 $db->optimize_table 2.18 $db->analyze_table 2.19 $db->show_create_table 2.20 $db->show_fields_from 2.21 $db->is_fulltext 2.22 $db->supports_fulltext 2.23 $db->supports_fulltext_boolean 2.24 $db->create_fulltext_index 2.25 $db->drop_index

Commonly Used

$db->query

Executes an SQL query with your database. Notice that the write_query method is now preferred.

$db->write_query

Similar to the query method, except write_query executes the query on the slave database in case you happen to have a multi-database server setup. Write_query is now preferred over query. For more information, see the following post from Pirata Nervo: https://community.mybb.com/post-559029.html#pid559029

$db->simple_select

See Simple Select.

$db->fetch_array

Returns an array of values for the first row (can be iterated through with a while statement)

Example:

$query=$db->query("SELECT * FROM Table [WHERE Field='Value']");
while($result=$db->fetch_array($query))
{
   $data1=$result['FieldName1'];
   $data2=$result['FieldName2'];
  (etc.)
}

$db->fetch_field

See Fetch_Field.

$db->num_rows

Returns the number of rows in the query

$db->insert_id

Returns the insert id (The id of the primary key) of the insert query just run

$db->insert_query

Runs an insert query on a table in a database. Receive two parameters:

1. string - The table name to perform the query on.
2. array - An array of fields and their values.

Build an insert query from the array and executes the query using $db->query

$db->update_query

Runs an update query on a table in a database.
parameters: ('table name', 'update array', 'conditional')

$db->delete_query

Used to perform a delete query on a table in a database

$db->escape_string

Replaces addslashes, escapes data before being used in a query

Others

$db->connect

Connects a new database.

$db->select_db

Selects the database for the current MySQL Session

$db->explain_query

Helps to explain queries run from on database from the current session for debugging purposes.

$db->data_seek

Moves the internal pointer to the specified column

$db->close

Closes the connection to the currently open database

$db->error_number

Returns the error number (if any) of the specified query resource

$db->error

Returns the error string (if any) of the specified query resource

$db->dberror

Outputs an error message (if any) of the specified query resource

$db->affected_rows

Returns the amount of affected rows from a "write" query

$db->num_fields

Returns the number of fields of the specified query resource

$db->list_tables

Returns the tables in the current open database

$db->table_exists

Returns true if the specified table exists

$db->field_exists

Returns true if the specified field exists

$db->shutdown_query

Runs a query thats performed when php is done parsing the file

$db->select_query

Runs a complex query (join queries). (Note: Depreciated in MyBB 1.4)

$db->get_version

Returns the version number of the database server being used

$db->optimize_table

Runs an optimize query on a table

$db->analyze_table

Runs an analyze query on a table

$db->show_create_table

Return the "create table" command for a specific table.

$db->show_fields_from

Show the "show fields from" command for a specific table.

$db->is_fulltext

Returns whether or not the table contains a fulltext index.

$db->supports_fulltext

Returns whether or not this database engine supports fulltext indexing.

$db->supports_fulltext_boolean

Returns whether or not this database engine supports boolean fulltext matching.

$db->create_fulltext_index

Creates a fulltext index on the specified column in the specified table with optional index name.

$db->drop_index

Drop an index with the specified name from the specified table

Edit this page on GitHub