Руководство по PHP
Пред.След.

LXXXI. Microsoft SQL Server Functions

Введение

These functions allow you to access MS SQL Server database.

Требования

Requirements for Win32 platforms.

The extension requires the MS SQL Client Tools to be installed on the system where PHP is installed. The Client Tools can be installed from the MS SQL Server CD or by copying ntwdblib.dll from \winnt\system32 on the server to \winnt\system32 on the PHP box. Copying ntwdblib.dll will only provide access. Configuration of the client will require installation of all the tools.

Requirements for Unix/Linux platforms.

To use the MSSQL extension on Unix/Linux, you first need to build and install the FreeTDS library. Source code and installation instructions are available at the FreeTDS home page: http://www.freetds.org/

Замечание: In Windows, the DBLIB from Microsoft is used. Functions that return a column name are based on the dbcolname() function in DBLIB. DBLIB was developed for SQL Server 6.x where the max identifier length is 30. For this reason, the maximum column length is 30 characters. On platforms where FreeTDS is used (Linux), this is not a problem.

Установка

The MSSQL extension is enabled by adding extension=php_mssql.dll to php.ini.

To get these functions to work, you have to compile PHP with --with-mssql[=DIR], where DIR is the FreeTDS install prefix. And FreeTDS should be compiled using --enable-msdblib.

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

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

Таблица 1. MS SQL Server configuration options

NameDefaultChangeableChangelog
mssql.allow_persistent"1"PHP_INI_SYSTEM 
mssql.max_persistent"-1"PHP_INI_SYSTEM 
mssql.max_links"-1"PHP_INI_SYSTEM 
mssql.min_error_severity"10"PHP_INI_ALL 
mssql.min_message_severity"10"PHP_INI_ALL 
mssql.compatability_mode"0"PHP_INI_ALL 
mssql.connect_timeout"5"PHP_INI_ALL 
mssql.timeout"60"PHP_INI_ALLAvailable since PHP 4.1.0.
mssql.textsize"-1"PHP_INI_ALL 
mssql.textlimit"-1"PHP_INI_ALL 
mssql.batchsize"0"PHP_INI_ALLAvailable since PHP 4.0.4.
mssql.datetimeconvert"1"PHP_INI_ALLAvailable since PHP 4.2.0.
mssql.secure_connection"0"PHP_INI_SYSTEMAvailable since PHP 4.3.0.
mssql.max_procs"25"PHP_INI_ALLAvailable since PHP 4.3.0.
Для подробного описания констант PHP_INI_*, обратитесь к документации функции ini_set().

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

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

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

MSSQL_ASSOC (integer)

MSSQL_NUM (integer)

MSSQL_BOTH (integer)

SQLTEXT (integer)

SQLVARCHAR (integer)

SQLCHAR (integer)

SQLINT1 (integer)

SQLINT2 (integer)

SQLINT4 (integer)

SQLBIT (integer)

SQLFLT8 (integer)

Содержание
mssql_bind --  Adds a parameter to a stored procedure or a remote stored procedure
mssql_close -- Close MS SQL Server connection
mssql_connect -- Open MS SQL server connection
mssql_data_seek -- Moves internal row pointer
mssql_execute --  Executes a stored procedure on a MS SQL server database
mssql_fetch_array --  Fetch a result row as an associative array, a numeric array, or both
mssql_fetch_assoc --  Returns an associative array of the current row in the result set specified by result_id
mssql_fetch_batch --  Returns the next batch of records
mssql_fetch_field -- Get field information
mssql_fetch_object -- Fetch row as object
mssql_fetch_row -- Get row as enumerated array
mssql_field_length -- Get the length of a field
mssql_field_name -- Get the name of a field
mssql_field_seek -- Seeks to the specified field offset
mssql_field_type -- Gets the type of a field
mssql_free_result -- Free result memory
mssql_free_statement -- Free statement memory
mssql_get_last_message --  Returns the last message from the server
mssql_guid_string --  Converts a 16 byte binary GUID to a string
mssql_init --  Initializes a stored procedure or a remote stored procedure
mssql_min_error_severity -- Sets the lower error severity
mssql_min_message_severity -- Sets the lower message severity
mssql_next_result -- Move the internal result pointer to the next result
mssql_num_fields -- Gets the number of fields in result
mssql_num_rows -- Gets the number of rows in result
mssql_pconnect -- Open persistent MS SQL connection
mssql_query -- Send MS SQL query
mssql_result -- Get result data
mssql_rows_affected --  Returns the number of records affected by the query
mssql_select_db -- Select MS SQL database
Пред.НачалоСлед.
udm_set_agent_paramУровень вышеmssql_bind