Funciones mSQL
Manual de PHP
AnteriorSiguiente

LXXXVI. Funciones mSQL

Introducci贸n

Estas funciones le permiten acceder a servidores de bases de datos mSQL. Puede encontrar m谩s informaci贸n sobre mSQL en http://www.hughes.com.au/.

Instalaci贸n

In order to have these functions available, you must compile PHP with msql support by using the --with-msql[=DIR] option. DIR is the mSQL base install directory, defaults to /usr/local/msql3.

Note to Win32 Users: In order to enable this module on a Windows environment, you must copy msql.dll from the DLL folder of the PHP/Win32 binary package to the SYSTEM32 folder of your windows machine. (Ex: C:\WINNT\SYSTEM32 or C:\WINDOWS\SYSTEM32)

Configuraci贸n en tiempo de ejecuci贸n

El comportamiento de estas funciones est谩 afectado por los valores definidos en php.ini.

Tabla 1. mSQL configuration options

NameDefaultChangeableChangelog
msql.allow_persistent"1"PHP_INI_ALL 
msql.max_persistent"-1"PHP_INI_ALL 
msql.max_links"-1"PHP_INI_ALL 
For further details and definitions of the PHP_INI_* constants, see the Ap茅ndice G.

A continuaci贸n se presenta una corta explicaci贸n de las directivas de configuraci贸n.

msql.allow_persistent boolean

Whether to allow persistent mSQL connections.

msql.max_persistent integer

The maximum number of persistent mSQL connections per process.

msql.max_links integer

The maximum number of mSQL connections per process, including persistent connections.

Tipos de recursos

Existen dos tipos de recurso usados en el m贸dulo mSQL. El primero es el identificador de enlace para una conexi贸n de base de datos, el segundo es un recurso que contiene el resultado de una consulta.

Constantes predefinidas

Estas constantes est谩n definidas por esta extensi贸n y estar谩n disponibles solamente cuando la extensi贸n ha sido o bien compilada dentro de PHP o grabada din谩micamente en tiempo de ejecuci贸n.

MSQL_ASSOC (integer)

MSQL_NUM (integer)

MSQL_BOTH (integer)

Ejemplos

Este sencillo ejemplo muestra el modo de crear una conexi贸n, ejecutar una consulta, imprimir las filas de resultado y desconectarse de una base de datos mSQL.

Ejemplo 1. Ejemplo de uso de mSQL

<?php
/* Conexion, seleccion de una base de datos */
$enlace = msql_connect('localhost', 'nombre_usuario', 'contrasenya')
    or die('No pudo crear una conexi&oacute;n: ' . msql_error($enlace));

msql_select_db('base_de_datos', $enlace)
    or die('No pudo seleccionarse la base de datos');

/* Realizar una consulta SQL */
$consulta = 'SELECT * FROM mi_tabla';
$resultado = msql_query($consulta, $enlace) or die('La consulta fall&oacute;: ' . msql_error($enlace));

/* Impresion de resultados en HTML */
echo "<table>\n";
while ($fila = msql_fetch_array($resultado, MSQL_ASSOC)) {
    echo "\t<tr>\n";
    foreach ($fila as $valor_col) {
        echo "\t\t<td>$valor_col</td>\n";
    }
    echo "\t</tr>\n";
}
echo "</table>\n";

/* Liberar el conjunto de resultados */
msql_free_result($resultado);

/* Cerrar la conexion */
msql_close($enlace);
?>

Tabla de contenidos
msql_affected_rows -- devuelve el n煤mero de filas involucradas
msql_close -- cierra una conexi贸n mSQL
msql_connect -- abre una conexi贸n mSQL
msql_create_db -- crea una base de datos mSQL
msql_createdb -- crea una base de datos mSQL
msql_data_seek -- desplaza el puntero interno de fila
msql_db_query -- Send mSQL query
msql_dbname -- obtiene el nombre de la base de datos mSQL actual
msql_drop_db -- elimina (suprime) una base de datos mSQL
msql_error -- devuelve el mensaje de error de la 煤ltima llamada msql
msql_fetch_array -- recupera una fila como un array
msql_fetch_field -- obtiene informaci贸n de campo
msql_fetch_object -- recupera una fila como un objeto
msql_fetch_row -- obtiene una fila como un array enumerado
msql_field_flags -- Get field flags
msql_field_len -- Get field length
msql_field_name -- Get the name of the specified field in a result
msql_field_seek -- establece el desplazamiento del campo
msql_field_table -- Get table name for field
msql_field_type -- Get field type
msql_fieldflags -- obtiene los flags del campo
msql_fieldlen -- obtiene la longitud del campo
msql_fieldname -- obtiene el nombre del campo
msql_fieldtable -- obtiene el nombre de la tabla de un campo
msql_fieldtype -- obtiene el tipo del campo
msql_free_result -- libera la memoria del resultado
msql_list_dbs -- lista las bases de datos mSQL en el servidor
msql_list_fields -- lista los campos del resultado
msql_list_tables -- lista las tablas de una base de datos mSQL
msql_num_fields -- obtiene el n煤mero de campos de un resultado
msql_num_rows -- obtiene el n煤mero de filas de un resultado
msql_numfields -- obtiene el n煤mero de campos de un resultado
msql_numrows -- obtiene el n煤mero de filas en el resultado
msql_pconnect -- abre una conexi贸n mSQL persistente
msql_query -- env铆a una consulta mSQL
msql_regcase -- construye una expresi贸n regular para una b煤squeda que no distinga may煤sculas/min煤sculas
msql_result -- obtiene datos resultado
msql_select_db -- selecciona una base de datos mSQL
msql_tablename -- obtiene el nombre de la tabla de un campo
msql -- ejecuta una consulta mSQL
AnteriorInicioSiguiente
msession_unlockSubirmsql_affected_rows