PHP マニュアル
前のページ |  | 次のページ

# XCIII. mSQL 関数

# 導入

以下の関数により mSQL データベースサーバにアクセスすることが 可能になります。mSQL に関する詳細な情報は、 http://www.hughes.com.au/ にあります。

# インストール手順

以下の関数を利用可能とするには、 `--with-msql[=dir]` オプションにより mSQL サポートを追加して PHP をコンパイルする必要があります。DIR は mSQL のインストールディレクトリで、デフォルトの位置は `/usr/local/msql3` です。

> Win32 ユーザへの注意: このモジュールを Windows 環境で使用可能とするには、 `msql.dll` を PHP/Win32 バイナリパッケージの DLL フォルダから使用する Windows マシンの SYSTEM32 フォルダ(例: `C:\WINNT\SYSTEM32` または `C:\WINDOWS\SYSTEM32`) にコピーする必要があります。

# 実行時設定

`php.ini` の設定により動作が変化します。

表 1. mSQL 設定オプション

名前 | デフォルト | 変更の可否 | 変更履歴
--- | --- | --- | ---
msql.allow_persistent | "1" | PHP_INI_ALL |
msql.max_persistent | "-1" | PHP_INI_ALL |
msql.max_links | "-1" | PHP_INI_ALL |

PHP_INI_* 定数の詳細および定義については 付録G を参照してください。

以下に設定ディレクティブに関する 簡単な説明を示します。

`msql.allow_persistent` boolean

  持続的な mSQL 接続を許可するかどうか。

`msql.max_persistent` integer

  プロセスごとの、持続的 mSQL 接続の最大数。

`msql.max_links` integer

  プロセスごとの mSQL 接続の最大数。持続的接続の数も含めます。

# リソース型

mSQL モジュールでは 2 種類のリソース型が使用されます。ひとつは データベース接続のリンク ID で、もうひとつはクエリ結果を保持する リソースです。

# 定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

`MSQL_ASSOC` (integer)

`MSQL_NUM` (integer)

`MSQL_BOTH` (integer)

# 例

ここでは、mSQL データベースへの接続、クエリの実行、結果の表示 そして接続の切断を行う簡単な例を示します。

例 1. mSQL の使用例

`<?php
/* 接続し、データベースを選択する */
$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');
/* SQL クエリを発行する */
$query = 'SELECT * FROM my_table';
$result = msql_query($query, $link) or die('Query failed : ' . msql_error($link));
/* 結果を 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";
/* 結果セットを開放する */
msql_free_result($result);
/* 接続をクローズする */
msql_close($link);
?>`

前のページ | ホーム | 次のページ
msession_unlock | 上に戻る | msql_affected_rows