PHP 手冊
前一頁 |  | 下一頁

# LXXVI. 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
--- | --- | ---
msql.allow_persistent | "On" | PHP_INI_SYSTEM
msql.max_persistent | "-1" | PHP_INI_SYSTEM
msql.max_links | "-1" | PHP_INI_SYSTEM

For further details and definitions of the PHP_INI_* constants, see the 附錄 H.

這裡為簡短的結構指令說明。

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

前一頁 | 內容 | 下一頁
msession_unlock | 上一層 | msql_affected_rows