Scriptlog Docs

Scriptlog Documentation

Code reference for the Scriptlog codebase

User Tools

Site Tools


scriptlog:lib:core:dbinterface

This is an old revision of the document!


DbInterface

Layer: Core · Source: lib/core/DbInterface.php:20 (lines 20–111)


interface DbInterface

Describe the functionality that any database adapter will need.

Docblock Metadata

^ Tag ^ Value ^
| ''@category'' | Core Class |
| ''@author'' | M.Noermoehammad |
| ''@license'' | MIT |
| ''@version'' | 1.0 |
| ''@since'' | Since Release 1.0 |

Inheritance

No parent, interface or trait. This is a root type.

Constants (0)

None.

Properties (0)

None declared.

Methods (12)

^ Visibility ^ Method ^ Summary ^ Line ^
| public | ''setDbConnection()'' | Set database connection. | 29 |
| public | ''closeDbConnection()'' | Close database connection. | 34 |
| public | ''dbQuery()'' | Execute an SQL query. | 43 |
| public | ''dbInsert()'' | Insert a new record. | 53 |
| public | ''dbReplace()'' | Insert ... On Duplicate Key Update. | 65 |
| public | ''dbUpdate()'' | Update an existing record. | 75 |
| public | ''dbDelete()'' | Delete a record. | 85 |
| public | ''dbLastInsertId()'' | Get the last inserted ID. | 90 |
| public | ''dbTransaction()'' | Start a transaction. | 95 |
| public | ''dbCommit()'' | Commit the current transaction. | 100 |
| public | ''dbRollBack()'' | Rollback the current transaction. | 105 |
| public | ''isConnected()'' | Check if a database connection is active. | 110 |

setDbConnection()

public function setDbConnection(array $config, array $options = []): void

line 29

Set database connection.

^ Parameter ^ Type ^ Default ^ Description ^
| ''$config'' | ''array'' | //required// | //none// |
| ''$options'' | ''array'' | ''[]'' | //none// |

Returns: void — void

closeDbConnection()

public function closeDbConnection(): void

line 34

Close database connection.

Takes no parameters.

Returns: void

dbQuery()

public function dbQuery(string $sql, array $parameters = [])

line 43

Execute an SQL query.

^ Parameter ^ Type ^ Default ^ Description ^
| ''$sql'' | ''string'' | //required// | //none// |
| ''$parameters'' | ''array'' | ''[]'' | //none// |

Returns: (none declared) — \PDOStatement|false

dbInsert()

public function dbInsert(string $tablename, array $params): bool

line 53

Insert a new record.

^ Parameter ^ Type ^ Default ^ Description ^
| ''$tablename'' | ''string'' | //required// | //none// |
| ''$params'' | ''array'' | //required// | //none// |

Returns: bool — boolean

dbReplace()

public function dbReplace(string $tablename, array $params, array $updateParams): bool

line 65

Insert … On Duplicate Key Update.

Replace statement to Insert or Update row. The correct way to do REPLACE INTO

^ Parameter ^ Type ^ Default ^ Description ^
| ''$tablename'' | ''string'' | //required// | //none// |
| ''$params'' | ''array'' | //required// | //none// |
| ''$updateParams'' | ''array'' | //required// | //none// |

Returns: bool — boolean

dbUpdate()

public function dbUpdate(string $tablename, array $params, array $where): int

line 75

Update an existing record.

^ Parameter ^ Type ^ Default ^ Description ^
| ''$tablename'' | ''string'' | //required// | //none// |
| ''$params'' | ''array'' | //required// | //none// |
| ''$where'' | ''array'' | //required// | //none// |

Returns: int — int

dbDelete()

public function dbDelete(string $tablename, array $where, ?int $limit = null): int

line 85

Delete a record.

^ Parameter ^ Type ^ Default ^ Description ^
| ''$tablename'' | ''string'' | //required// | //none// |
| ''$where'' | ''array'' | //required// | //none// |
| ''$limit'' | ''?int'' | ''null'' | default null |

Returns: int — int

dbLastInsertId()

public function dbLastInsertId(): string

line 90

Get the last inserted ID.

Takes no parameters.

Returns: string

dbTransaction()

public function dbTransaction(): bool

line 95

Start a transaction.

Takes no parameters.

Returns: bool

dbCommit()

public function dbCommit(): bool

line 100

Commit the current transaction.

Takes no parameters.

Returns: bool

dbRollBack()

public function dbRollBack(): bool

line 105

Rollback the current transaction.

Takes no parameters.

Returns: bool

isConnected()

public function isConnected(): bool

line 110

Check if a database connection is active.

Takes no parameters.

Returns: bool


This page is generated from source by 'tools/gendoc'. Edits will be overwritten.

scriptlog/lib/core/dbinterface.1790413761.txt.gz · Last modified: by admin