DB_common::setFetchMode() (Previous) (Next) DB_common::tableInfo()
View this page in Last updated: Sun, 31 Aug 2008
English | Dutch | French | German | Hungarian | Japanese | Polish | Russian | Spanish | Plain HTML

DB_common::setOption()

DB_common::setOption() -- Sets run-time configuration options for PEAR DB

Synopsis

integer setOption (string $option, mixed $value)

Description

Sets run-time configuration options for PEAR DB.

Parameter

string $option

name of the option to set

mixed $value

value to set the option to

Table 39-1.

OptionData TypeDefault ValueDescription
autofree boolean FALSE should results be freed automatically when there are no more rows?
debug integer 0 debug level
persistent boolean FALSE should the connection be persistent?
portability integer DB_PORTABILITY_NONE portability mode constant. These constants are bitwised, so they can be combined using | and removed using ^. See the examples below and the "Intro - Portability" for more information.
seqname_format string %s_seq the sprintf() format string used on sequence names. This format is applied to sequence names passed to createSequence(), nextID() and dropSequence().  
ssl boolean FALSE use ssl to connect?

Return value

integer - DB_OK on success or a DB_Error object on failure

Throws

Table 39-2. Possible PEAR_Error values

Error codeError messageReasonSolution
NULL unknown option The given option does not exist Check $option for typographical errors

Note

This function can not be called statically.

Example

Example 39-1. Simple setOption() example


<?php
// Once you have a valid DB object named $db...
$db->setOption('autofree', true);
?>

Example 39-2. Portability for lowercasing and trimming


<?php
// Once you have a valid DB object named $db...
$db->setOption('portability',
    DB_PORTABILITY_LOWERCASE | DB_PORTABILITY_RTRIM);
?>

Example 39-3. All portability options except trimming


<?php
// Once you have a valid DB object named $db...
$db->setOption('portability',
    DB_PORTABILITY_ALL ^ DB_PORTABILITY_RTRIM);
?>
DB_common::setFetchMode() (Previous) (Next) DB_common::tableInfo()
Download Documentation Last updated: Sun, 31 Aug 2008
Do you think that something on this page is wrong? Please file a bug report or add a note.
User Notes:
There are no user contributed notes for this page.