mSQL Functions
簡介
These functions allow you to access mSQL database servers. More information about mSQL can be found at » https://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: Note to Win32 Users 需要有DLL檔案存在於PATH的Windows系統上,來使此擴充功能運作。參見FAQ主題為"如何增加PHP目錄至Windows上的PATH環境變數",可獲得如何完成這些步驟的資訊。雖然從PHP資料夾複製DLL檔案至Windows系統目錄也可行(因為PATH預設包含系統目錄),不過不建議這樣做。此擴充功能需要以下檔案存在PATH中: msql.dll
執行時期設定
這些函式的行為受 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 |
以下是設定選項的簡要解釋。
資源類型
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 中,或者在執行時被動態載入後才有效。
範例
This simple example shows how to connect, execute a query, print resulting rows and disconnect from a mSQL database.
Example#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());
/* 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);
?>
Table of Contents
- msql_affected_rows — Returns number of affected rows
- msql_close — Close mSQL connection
- msql_connect — Open mSQL connection
- msql_create_db — Create mSQL database
- msql_createdb — 別名 msql_create_db
- msql_data_seek — Move internal row pointer
- msql_db_query — Send mSQL query
- msql_dbname — 別名 msql_result
- msql_drop_db — Drop (delete) mSQL database
- msql_error — Returns error message of last msql call
- msql_fetch_array — Fetch row as array
- msql_fetch_field — Get field information
- msql_fetch_object — Fetch row as object
- msql_fetch_row — Get row as enumerated array
- 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 — Set field offset
- msql_field_table — Get table name for field
- msql_field_type — Get field type
- msql_fieldflags — Alias of msql_field_flags
- msql_fieldlen — Alias of msql_field_len
- msql_fieldname — Alias of msql_field_name
- msql_fieldtable — Alias of msql_field_table
- msql_fieldtype — Alias of msql_field_type
- msql_free_result — Free result memory
- msql_list_dbs — List mSQL databases on server
- msql_list_fields — List result fields
- msql_list_tables — List tables in an mSQL database
- msql_num_fields — Get number of fields in result
- msql_num_rows — Get number of rows in result
- msql_numfields — Alias of msql_num_fields
- msql_numrows — Alias of msql_num_rows
- msql_pconnect — Open persistent mSQL connection
- msql_query — Send mSQL query
- msql_regcase — Alias of sql_regcase
- msql_result — Get result data
- msql_select_db — Select mSQL database
- msql_tablename — Alias of msql_result
- msql — Alias of msql_db_query