array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.odbc-connect.php', 1 => 'odbc_connect', 2 => 'Conectar a una fuente de datos', ), 'up' => array ( 0 => 'ref.uodbc.php', 1 => 'Funciones ODBC', ), 'prev' => array ( 0 => 'function.odbc-commit.php', 1 => 'odbc_commit', ), 'next' => array ( 0 => 'function.odbc-connection-string-is-quoted.php', 1 => 'odbc_connection_string_is_quoted', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/uodbc/functions/odbc-connect.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

odbc_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_connect — Conectar a una fuente de datos

Descripción

odbc_connect(
    string $dsn,
    ?string $user = null,
    #[\SensitiveParameter] ?string $password = null,
    int $cursor_option = SQL_CUR_USE_DRIVER
): Odbc\Connection|false

El identificador de conexión devuelto por esta función es necesario para otras funciones ODBC. Puede tener múltiples conexiones abiertas a la vez siempre que utilicen diferentes bases de datos o diferentes credenciales.

Con algunos controladores ODBC, ejecutar un procedimiento almacenado complejo puede fallar con un error similar a: "No se puede abrir un cursor en un procedimiento almacenado que tenga algo más que una única sentencia SELECT". Usar SQL_CUR_USE_ODBC puede evitar ese error. Además, algunos controladores no soportan el parámetro opcional row_number en odbc_fetch_row(). SQL_CUR_USE_ODBC podría ayudar en ese caso también.

Parámetros

dsn

El nombre de la fuente de datos para la conexión. Alternativamente, se puede usar una cadena de conexión sin DSN.

user

El nombre de usuario. Este parámetro se ignora si dsn contiene uid. Para conectar sin especificar un user, use null.

password

La contraseña. Este parámetro se ignora si dsn contiene pwd. Para conectar sin especificar una password, use null.

cursor_option

Esto establece el tipo de cursor a utilizar para esta conexión. Este parámetro normalmente no es necesario, pero puede ser útil para solucionar problemas con algunos controladores ODBC.

Las siguientes constantes están definidas para cursortype:

  • SQL_CUR_USE_IF_NEEDED
  • SQL_CUR_USE_ODBC
  • SQL_CUR_USE_DRIVER

Valores devueltos

Devuelve una conexión ODBC, o false si ocurre un error.

Historial de cambios

Versión Descripción
8.4.0 odbc ahora espera una instancia de Odbc\Connection; anteriormente, se esperaba un resource.
8.4.0 Esta función ahora devuelve una instancia de Odbc\Connection; anteriormente, se devolvía un resource.
8.4.0 user y password ahora pueden ser nulos, también son opcionales y valen por omisión null.
8.4.0 Anteriormente, el uso de una cadena vacía para password no incluía pwd en la cadena de conexión generada para dsn. Ahora, pwd se incluye en la cadena de conexión, con un valor de cadena vacía. Para restaurar el comportamiento anterior, password puede ser definido como null.
8.4.0 Anteriormente, si dsn contenía uid o pwd, entonces los parámetros user y password eran ignorados. Ahora, user solo es ignorado si dsn contiene uid, y password solo es ignorado si dsn contiene pwd.

Ejemplos

Ejemplo #1 Conexiones sin DSN

<?php
// Microsoft SQL Server usando el controlador ODBC SQL Native Client 10.0 - permite conexión a SQL 7, 2000, 2005 y 2008
$connection = odbc_connect("Driver={SQL Server Native Client 10.0};Server=$server;Database=$database;", $user, $password);

// Microsoft Access
$connection = odbc_connect("Driver={Microsoft Access Driver (*.mdb)};Dbq=$mdbFilename", $user, $password);

// Microsoft Excel
$excelFile = realpath('C:/ExcelData.xls');
$excelDir = dirname($excelFile);
$connection = odbc_connect("Driver={Microsoft Excel Driver (*.xls)};DriverId=790;Dbq=$excelFile;DefaultDir=$excelDir" , '', '');
?>

Ver también