Database
in package
The shared PDO connection, opened on the first query.
Table of Contents
Properties
- $db : PDO|null
Methods
- dsn() : string
- Build a MySQL DSN, for the app's connection and for the CLI scripts that open their own.
- db() : PDO
- The shared database connection, opened on first use.
Properties
$db
private
static PDO|null
$db
= \null
The shared connection; null until the first query.
Methods
dsn()
Build a MySQL DSN, for the app's connection and for the CLI scripts that open their own.
public
static dsn(string $host, int $port, string $name) : string
Parameters
- $host : string
-
Host name or IP address, or the path of a Unix socket (it starts with
/). - $port : int
-
TCP port, left out of the DSN when it is MySQL's default (3306) and ignored for a socket.
- $name : string
-
Database name.
Return values
string —The PDO DSN, with the utf8mb4 charset.
db()
The shared database connection, opened on first use.
protected
final static db() : PDO
Building, validating or formatting a model therefore needs no database. The connection comes from the DB_*
constants; a failure triggers E_USER_ERROR. With DEBUG on, statements are created as DebugStatement so every
query execution is timed.
Prepared statements are native, so integer columns come back as int; the charset is utf8mb4 and the timezone
is the server's.
Return values
PDO —The shared connection.