c:/www/apache/doc2//pear/DB.phpStig Bakkenmethods for creating DB objects as well as some utility functionscommon to all parts of DB.The object model of DB is as follows (indentation means inheritance):DB The main DB class. This is simply a utility classwith some "static" methods for creating DB objects aswell as common utility functions for other DB classes.DB_common The base for each DB implementation. Provides default| implementations (in OO lingo virtual methods) for| the actual DB implementations as well as a bunch of| query utility functions.|+-DB_mysql The DB implementation for MySQL. Inherits DB_common.When calling DB::factory or DB::connect for MySQLconnections, the object returned is an instance of thisclass.The main "DB" class is simply a container class with some static2PHP 4.0type, for example "mysql"newly created DB object, or a DB error code on errorCreate a new DB object for the specified database type"data source name", see the DB::parseDSN method for a description of the dsn format.this connection should be persistent. Ignored if the backend extension does not support persistent connections.newly created DB object, or a DB error code on errorCreate a new DB object and connect to the specified databasethe DB API version numberReturn the DB API versioncodewhether is an errorTell whether a result code from a DB method is an errorvaluewhether is a warningWarnings differ from errors in that they are generated by DB,and are not fatal.Tell whether a result code from a DB method is a warning.codeerror message, or false if the error code was not recognizedReturn a textual error message for a DB error codeSource Name to be parsedan associative array with the following keys: <dl> <dt>phptype</dt> <dd>Database backend used in PHP (mysql, odbc etc.)</dd> <dt>dbsyntax</dt> <dd>Database used with regards to SQL syntax etc.</dd> <dt>protocol</dt> <dd>Communication protocol to use (tcp, unix etc.)</dd> <dt>hostspec</dt> <dd>Host specification (hostname[:port])</dd> <dt>database</dt> <dd>Database to use on the DBMS server</dd> <dt>username</dt> <dd>User name for login</dd> <dt>password</dt> <dd>Password for login</dd> </dl> </p> <p> The format of the supplied DSN is in its fullest form: <ul> <li>phptype(dbsyntax)://username:password@protocol+hostspec/database</li> </ul> Most variations are allowed: <ul> <li>phptype://username:password@protocol+hostspec/database</li> <li>phptype://username:password@hostspec/database</li> <li>phptype://username:password@hostspec</li> <li>phptype://hostspec/database</li> <li>phptype://hostspec</li> <li>phptype(dbsyntax)</li> <li>phptype</li> </ul> </p>Parse a data source nameDB_result constructor.a row of data, or false on errorFetch and return a row of data.error codeFetch a row of data into an existing array.the number of columns, or a DB error codeGet the the number of columns in a result set.error codeFrees the resources allocated for this result set.error code, or string with error message."error mode" to operate inDB_Error constructor.error code, or string with error message."error mode" to operate inDB_Warning constructor.0any particular get mode, so the default should be used.This is a special constant that tells DB the user hasn't specified1Column data indexed by numbers, ordered from 0 and up2Column data indexed by column names4is the row number, and the second level indexed by column number or name.DB_FETCHMODE_FLIPPED switches this order, so the first level of arraysis the column name, and the second level the row number.For multi-dimensional results: normally the first level of arrays0-1-2-3-4-5-6-7-8-9-10-11-12-13-14-15-16-17-18-19-20-21-22-1000-100112123DB_FETCHMODE_ORDEREDDB_FETCHMODE_ASSOCDB_FETCHMODE_FLIPPED