(PHP 5, PECL OCI8 >= 1.1.0)
oci_new_connect — Conecta al servidor de Oracle usando una conexión única
$username
, string $password
[, string $connection_string
[, string $character_set
[, int $session_mode
]]] )Establece una nueva conexión a un servidor de Oracle y se identifica.
A diferencia de oci_connect() y oci_pconnect(), oci_new_connect() no almacena en caché conexiones y siempre devolverá un gestor de conexión recién abierto. Esto es útil si la aplicación necesita aislamiento transaccional entre dos conjuntos de consultas.
username
El nombre de usuario de Oracle.
password
La contraseña para username.
connection_string
Contiene la instancia de Oracle a la que conectarse. Puede ser una » cadena de Conexión Sencilla (Easy Connect), o un Nombre de Conexión del fichero tnsnames.ora, o el nombre de una instancia local de Oracle.
Si no se especifica, PHP utiliza
variables de entorno como TWO_TASK (en Linux)
o LOCAL (en Windows)
y ORACLE_SID para determinar la
instancia de Oracle a la que conectarse.
Para utilizar el método de nomenclatura de Conexión Sencila, PHP debe estar vinculado con las bibliotecas cliente de Oracle 10g o superiores. La cadena de Conexión Sencilla para Oracle 10g se utiliza de la siguiente forma: [//]nombre_host[:puerto][/nombre_servicio]. Con Oracle 11g, la sintaxis es: [//]nombre_host[:puerto][/nombre_servicio][:tipo_servicio][/nombre_instancia]. Los nombres de servicio pueden encontrarse ejecuntado la utilidad de Oracle lsnrctl status en el servidor donde se encuentra la base de datos.
El fichero tnsnames.ora puede estar en la ruta de búsqueda de Oracle Net, la cual incluye $ORACLE_HOME/network/admin y /etc. De forma alternativa, establezca TNS_ADMIN para que $TNS_ADMIN/tnsnames.ora sea leído. Asegúrse que el demonio web tiene acceso de lectura al fichero.
character_set
Determina el juego de caracteres usado por las bibliotecas cliente de Oracle. El juego de caracteres no tiene por que coinicidir con el utilizado en la base de datos. Si no coinicide, Oracle intentará hacer lo posible para convertir los datos entre los dos juegos de caracteres. Dependiendo del juego de caracteres que se esté usando, podría no proporcionarse resultados útiles. La conversión también añade algo de carga extra de tiempo.
Si no se especifica, las
bibliotacas cliente de Oracle determinarán el juego de caracteres desde
la variable de entorno NLS_LANG.
Pasar este parámetro puede reducir el tiempo de conexión.
session_mode
Este
parámetro está disponible desde la versión 5 de PHP (PECL OCI8 1.1) y acepta los
siguientes valores: OCI_DEFAULT,
OCI_SYSOPER y OCI_SYSDBA.
Si se especifica OCI_SYSOPER o
OCI_SYSDBA, esta función intentará
establecer una conexión privilegiada con las credenciales externas.
Las conexiones privilegiadas están desactivadas por omisión. Para activarlas
hay que establecer oci8.privileged_connect
a On.
En PHP 5.3 (PECL OCI8 1.3.4) se introdujo el valor de modo
OCI_CRED_EXT. Esto indica a Oracle que utilice
la autenticación Externa o del SO, la cual debe estar configurada en la
base de datos. La bandera OCI_CRED_EXT sólo puede usarse
con el nombre de usuario "/" y la contraseña en blanco.
oci8.privileged_connect
podría ser On o Off.
OCI_CRED_EXT podría estar en combinación con los modos
OCI_SYSOPER o
OCI_SYSDBA.
OCI_CRED_EXT no se admite en Windows por
razones de seguridad.
Devuelve un identificador de conexión, o FALSE en caso de error.
El siguiente demuestra cómo se pueden separar conexiones.
Ejemplo #1 Ejemplo de oci_new_connect()
<?php
echo "<html><pre>";
$db = "";
$c1 = oci_connect("scott", "tiger", $db);
$c2 = oci_new_connect("scott", "tiger", $db);
function create_table($conn)
{
$stmt = oci_parse($conn, "create table scott.hallo (test
varchar2(64))");
oci_execute($stmt);
echo $conn . " created table\n\n";
}
function drop_table($conn)
{
$stmt = oci_parse($conn, "drop table scott.hallo");
oci_execute($stmt);
echo $conn . " dropped table\n\n";
}
function insert_data($conn)
{
$stmt = oci_parse($conn, "insert into scott.hallo
values('$conn' || ' ' || to_char(sysdate,'DD-MON-YY HH24:MI:SS'))");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . " inserted hallo\n\n";
}
function delete_data($conn)
{
$stmt = oci_parse($conn, "delete from scott.hallo");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . " deleted hallo\n\n";
}
function commit($conn)
{
oci_commit($conn);
echo $conn . " committed\n\n";
}
function rollback($conn)
{
oci_rollback($conn);
echo $conn . " rollback\n\n";
}
function select_data($conn)
{
$stmt = oci_parse($conn, "select * from scott.hallo");
oci_execute($stmt, OCI_DEFAULT);
echo $conn . "----selecting\n\n";
while (oci_fetch($stmt)) {
echo $conn . " <" . oci_result($stmt, "TEST") . ">\n\n";
}
echo $conn . "----done\n\n";
}
create_table($c1);
insert_data($c1);
select_data($c1);
select_data($c2);
rollback($c1);
select_data($c1);
select_data($c2);
insert_data($c2);
commit($c2);
select_data($c1);
delete_data($c1);
select_data($c1);
select_data($c2);
commit($c1);
select_data($c1);
select_data($c2);
drop_table($c1);
echo "</pre></html>";
?>
Nota:
En versiones de PHP anteriores a la 5.0.0 se debe usar ocinlogon() en su lugar. El nombre antiguo de la función todavía puede ser utilizado en versiones actuales, sin embargo es obsoleto y no se recomienda.