View this page in	Last updated: Sun, 01 Jul 2007
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)

Sets run-time configuration options for PEAR DB.

Tabla 35-1.

Option	Data Type	Default Value	Description
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?

integer - DB_OK on success or a DB_Error object on failure

Tabla 35-2. Posibles valores de PEAR_Error

Error code	Error message	Reason	Solution
`NULL`	`unknown option`	The given option does not exist	Check `$option` for typographical errors

Esta función no puede ser llamada estáticamente.

Ejemplo 35-1. Simple setOption() example


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

Ejemplo 35-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);
?>

Ejemplo 35-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);
?>

Download Documentation	Last updated: Sun, 01 Jul 2007
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.