[edit] Last updated: Mon, 01 Nov 2010

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&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

add a note User Contributed Notes Funciones mSQL

acroyear at io dot com 15-May-2000 02:11


To those porting code from w3-msql/lite to php, a few functions are different or missing (aside from the fact that the order of arguments is reversed and the other signatures are different...not good design work, imho, or was it built for msql 1.x?  At any rate, conformity with the C and Lite API should have been maintained.).





The lite/C function msqlStoreResult() is automatically done in msql_query() and msql().  


msql_fetch_field() doesn't give you the field length value (unlike msqlFetchField()).  You have to call msql_fieldlen() to get that.





msqlEncode() is missing.  The functionality (which is needed for pretty much ALL SQL based rdbms's) is in addSlashes() in the String library.

add a note