ImDb

Kind: global class
Summary: A utility class which provides an easy access to the databases defined by the WSX5 user.
To use it, you must include x5engine.php in your code.

new ImDb($host, $user, $pwd, $db)

Create a new ImDb Object

Param Type Description
$host String The database host address
$user String The database username
$pwd String The database password
$db String The database name

.testConnection() ⇒ Boolean

Check if the class is connected or not to a db

Kind: instance method of ImDb
Returns: Boolean - True if the class is connected to a DB. False otherwise.

.closeConnection() ⇒ Void

Close the connection

Kind: instance method of ImDb

.createTable($name, $fields) ⇒ Boolean

Create a new table or update an existing one.

Kind: instance method of ImDb
Returns: Boolean - True if the table was created succesfully.

Param Type Description
$name String The table name
$fields Array The table fields list as array of associative arrays (one array item foreach table field). must be passed as stated in the example.

Example

$db->createTable('tableName', array(
    "field1" => array(
        "type" => "INTEGER",
        "null" => false,
        "auto_increment" => true,
        "primary" => true
    ),
    "field2" => array(
        "type" => "TEXT",
        "null" => true,
        "auto_increment" => false,
        "more" => "CHARACTER SET UTF-8"
    ))
);

.deleteTable($table) ⇒ Void

Delete a table from the database.

Kind: instance method of ImDb

Param Type Description
$table String The table name

.tableExists($table) ⇒ Boolean

Check if the table exists

Kind: instance method of ImDb
Returns: Boolean - True if the table exists. False otherwise.

Param Type Description
$table String The table name

.error() ⇒ Array

Get the last MySQL error.

Kind: instance method of ImDb

.lastInsertId() ⇒ Number

Provide the last inserted ID of the AUTOINCREMENT column

Kind: instance method of ImDb
Returns: Number - The id of the latest insert operation

.query($query) ⇒ Array

Execute a MySQL query.

Kind: instance method of ImDb
Returns: Array - The query result or FALSE on error

Param Type
$query String

.escapeString($string) ⇒ String

Escape a MySQL query string.

Kind: instance method of ImDb
Returns: String - The escaped string

Param Type Description
$string String The string to escape

.affectedRows() ⇒ Number

Return the number of affected rows in the last query.

Kind: instance method of ImDb
Returns: Number - The number of affected rows.