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

Name	Default	Changeable
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ó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ó: ' . 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

MANUAL DE PHP

windsurf mercedes camper