Docs For Class jDb

Class jDb

Description

factory for database connector and other db utilities

Located in /db/jDb.class.php (line 102)

Method Summary

static void clearProfiles ()

static void createVirtualProfile (string $name, array|string $params)

static void floatToStr ( $value)

static jDbConnection getConnection ([string $name = ''])

static jDbWidget getDbWidget ([string $name = null])

static array getProfile ([string $name = ''], [boolean $noDefault = false])

static jDbTools getTools ([string $name = null])

static jDbConnection|jDbPDOConnection _createConnector (array $profile)

boolean testProfile (array $profile)

Methods

static clearProfiles (line 207)

clear the loaded profiles to force to reload the db profiles file.

WARNING: it closes all opened connections !

deprecated: since 1.3, use jProfiles::clear instead
since: 1.2
access: public

static void clearProfiles ()

static createVirtualProfile (line 197)

create a temporary new profile

deprecated: since 1.3, use jProfiles::createVirtualProfile instead
access: public

static void createVirtualProfile (string $name, array|string $params)

string $name: the name of the profile
array|string $params: parameters of the profile. key=parameter name, value=parameter value. same kind of parameters we found in profiles.ini.php we can also indicate a name of an other profile, to create an alias

static floatToStr (line 217)

perform a convertion float to str. It takes care about the decimal separator which should be a '.' for SQL. Because when doing a native convertion float->str, PHP uses the local decimal separator, and so, we don't want that.

since: 1.1.11
access: public

static void floatToStr ( $value)

$value

static getConnection (line 111)

return a database connector. It uses a temporay pool of connection to reuse currently opened connections.

return: the connector
access: public

static jDbConnection getConnection ([string $name = ''])

string $name: profile name to use. if empty, use the default one

static getDbWidget (line 120)

create a new jDbWidget

access: public

static jDbWidget getDbWidget ([string $name = null])

string $name: profile name to use. if empty, use the default one

static getProfile (line 151)

load properties of a connector profile

a profile is a section in the profiles.ini.php file

the given name can be a profile name (it should correspond to a section name in the ini file), or an alias of a profile. An alias is a parameter name in the global section of the ini file, and the value of this parameter should be a profile name.

return: properties
deprecated: use jProfiles::get instead
access: public

static array getProfile ([string $name = ''], [boolean $noDefault = false])

string $name: profile name or alias of a profile name. if empty, use the default profile
boolean $noDefault: if true and if the profile doesn't exist, throw an error instead of getting the default profile

static getTools (line 131)

instancy a jDbTools object. Use jDbConnection::tools() instead.

deprecated: since 1.2
access: public

static jDbTools getTools ([string $name = null])

string $name: profile name to use. if empty, use the default one

static _createConnector (line 176)

create a connector. internal use (callback method for jProfiles)

return: database connector
access: public

static jDbConnection|jDbPDOConnection _createConnector (array $profile)

array $profile: profile properties

testProfile (line 160)

call it to test a profile (during an install for example)

return: true if properties are ok
access: public

boolean testProfile (array $profile)

array $profile: profile properties

Documentation generated on Mon, 19 Sep 2011 14:12:25 +0200 by phpDocumentor 1.4.3