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 » https://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: Note to Win32 Users In order for this extension to work, there are DLL files that must be available to the Windows system PATH. See the FAQ titled "How do I add my PHP directory to the PATH on Windows" for information on how to do this. Although copying DLL files from the PHP folder into the Windows system directory also works (because the system directory is by default in the systems PATH), it is not recommended. This extension requires the following files to be in the PATH: msql.dll
Configuración en tiempo de ejecución
El comportamiento de estas funciones está afectado por los valores definidos en php.ini.
| Name | Default | Changeable | Changelog |
|---|---|---|---|
| msql.allow_persistent | "1" | PHP_INI_ALL | |
| msql.max_persistent | "-1" | PHP_INI_ALL | |
| msql.max_links | "-1" | PHP_INI_ALL |
A continuación se presenta una corta explicación de las directivas de configuración.
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.
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.
Example#1 Ejemplo de uso de mSQL
<?php
/* Conexión, selección de una base de datos */
$enlace = msql_connect('localhost', 'nombre_usuario', 'contrasenya')
or die('No pudo crearse 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());
/* Impresión 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 conexión */
msql_close($enlace);
?>
Table of Contents
- 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