PHP: mSQL Functions - Manual

downloads | documentation | faq | getting help | mailing lists | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

msql_affected_rows msession_unlock

Last updated: Sat, 27 Jan 2007

view this page in

# XCII. mSQL Functions

# Введение

These functions allow you to access mSQL database servers. More information about mSQL can be found at http://www.hughes.com.au/.

# Установка

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`)

# Настройка во время выполнения

Поведение этих функций зависит от установок в `php.ini`.

Таблица 1. mSQL configuration options

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 |

Для подробного описания констант PHP_INI_*, обратитесь к документации функции ini_set().

Краткое разъяснение конфигурационных директив.

`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.

# Типы ресурсов

There are two resource types used in the mSQL module. The first one is the link identifier for a database connection, the second a resource which holds the result of a query.

# Предопределенные константы

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение подгружается во время выполнения.

`MSQL_ASSOC` (integer)

`MSQL_NUM` (integer)

`MSQL_BOTH` (integer)

# Примеры

This simple example shows how to connect, execute a query, print resulting rows and disconnect from a mSQL database.

Пример 1. mSQL usage example

`<?php
/* Connecting, selecting database */
$link = msql_connect('localhost', 'username', 'password')
or die('Could not connect : ' . msql_error($link));
msql_select_db('database', $link)
or die('Could not select database');
/* Issue SQL query */
$query = 'SELECT * FROM my_table';
$result = msql_query($query, $link) or die('Query failed : ' . msql_error($link));
/* Printing results in HTML */
echo "<table>\n";
while ($row = msql_fetch_array($result, MSQL_ASSOC)) {
echo "\t<tr>\n";
foreach ($row as $col_value) {
echo "\t\t<td>$col_value</td>\n";
}
echo "\t</tr>\n";
}
echo "</table>\n";
/* Free result set */
msql_free_result($result);
/* Close connection */
msql_close($link);
?>`

add a note User Contributed Notes
mSQL Functions
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
msql_affected_rows msession_unlock

Last updated: Sat, 27 Jan 2007
show source | credits | stats | sitemap | contact | advertising | mirror sites
Copyright © 2001-2007 The PHP Group
All rights reserved.
This mirror generously provided by: Yahoo! Inc.
Last updated: Sat Mar 10 10:36:09 2007 PST