<HTML ><HEAD ><TITLE >Microsoft SQL Server functions</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7"><LINK REL="HOME" TITLE="PHP Manual" HREF="index.html"><LINK REL="UP" TITLE="Function Reference" HREF="funcref.html"><LINK REL="PREVIOUS" TITLE="mime_content_type" HREF="function.mime-content-type.html"><LINK REL="NEXT" TITLE="mssql_bind" HREF="function.mssql-bind.html"><META HTTP-EQUIV="Content-type" CONTENT="text/html; charset=ISO-8859-1"></HEAD ><BODY CLASS="reference" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >PHP Manual</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="function.mime-content-type.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="function.mssql-bind.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><DIV CLASS="reference" ><A NAME="ref.mssql" ></A ><DIV CLASS="TITLEPAGE" ><H1 CLASS="title" >LVIII. Microsoft SQL Server functions</H1 ><DIV CLASS="PARTINTRO" ><A NAME="AEN51600" ></A ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.intro" ></A >Introduction</H1 ><P > These functions allow you to access MS SQL Server database. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.requirements" ></A >Requirements</H1 ><P > Requirements for WIn32 platforms. </P ><P > 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 <TT CLASS="filename" >ntwdblib.dll</TT > from <TT CLASS="filename" >\winnt\system32</TT > on the server to <TT CLASS="filename" >\winnt\system32</TT > on the PHP box. Copying <TT CLASS="filename" >ntwdblib.dll</TT > will only provide access. Configuration of the client will require installation of all the tools. </P ><P > Requirements for Unix/Linux platforms. </P ><P > 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: <A HREF="http://www.freetds.org/" TARGET="_top" >http://www.freetds.org/</A > </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.installation" ></A >Installation</H1 ><P > The MSSQL extension is enabled by adding extension=php_mssql.dll to <TT CLASS="filename" >php.ini</TT >. </P ><P > To get these functions to work, you have to compile PHP with <TT CLASS="option" >--with-mssql[=DIR]</TT >, where DIR is the FreeTDS install prefix. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.configuration" ></A >Runtime Configuration</H1 ><P > The behaviour of these functions is affected by settings in <TT CLASS="filename" >php.ini</TT >. </P ><P > <DIV CLASS="table" ><A NAME="AEN51626" ></A ><P ><B >Table 1. MS SQL Server configuration options</B ></P ><TABLE BORDER="1" CLASS="CALSTABLE" ><THEAD ><TR ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Name</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Default</TH ><TH ALIGN="LEFT" VALIGN="MIDDLE" >Changeable</TH ></TR ></THEAD ><TBODY ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.allow_persistent</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.max_persistent</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"-1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.max_links</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"-1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.min_error_severity</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"10"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.min_message_severity</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"10"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.compatability_mode</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"0"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.connect_timeout</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"5"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.timeout</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"60"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.textsize</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"-1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.textlimit</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"-1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.batchsize</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"0"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.datetimeconvert</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"1"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.secure_connection</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"0"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_SYSTEM</TD ></TR ><TR ><TD ALIGN="LEFT" VALIGN="MIDDLE" >mssql.max_procs</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >"25"</TD ><TD ALIGN="LEFT" VALIGN="MIDDLE" >PHP_INI_ALL</TD ></TR ></TBODY ></TABLE ></DIV > For further details and definition of the PHP_INI_* constants see <A HREF="function.ini-set.html" ><B CLASS="function" >ini_set()</B ></A >. </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.resources" ></A >Resource Types</H1 ><P > </P ></DIV ><DIV CLASS="section" ><H1 CLASS="section" ><A NAME="mssql.constants" ></A >Predefined Constants</H1 ><P > The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime. </P ><P ></P ><DIV CLASS="variablelist" ><DL ><DT ><TT CLASS="constant" ><B >MSSQL_ASSOC</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >MSSQL_NUM</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >MSSQL_BOTH</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLTEXT</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLVARCHAR</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLCHAR</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLINT1</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLINT2</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLINT4</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLBIT</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ><DT ><TT CLASS="constant" ><B >SQLFLT8</B ></TT > (<A HREF="language.types.integer.html" >integer</A >)</DT ><DD ><P > </P ></DD ></DL ></DIV ></DIV ></DIV ><DIV CLASS="TOC" ><DL ><DT ><B >Table of Contents</B ></DT ><DT ><A HREF="function.mssql-bind.html" >mssql_bind</A > -- Adds a parameter to a stored procedure or a remote stored procedure </DT ><DT ><A HREF="function.mssql-close.html" >mssql_close</A > -- Close MS SQL Server connection</DT ><DT ><A HREF="function.mssql-connect.html" >mssql_connect</A > -- Open MS SQL server connection</DT ><DT ><A HREF="function.mssql-data-seek.html" >mssql_data_seek</A > -- Move internal row pointer</DT ><DT ><A HREF="function.mssql-execute.html" >mssql_execute</A > -- Executes a stored procedure on a MS SQL server database </DT ><DT ><A HREF="function.mssql-fetch-array.html" >mssql_fetch_array</A > -- Fetch row as array</DT ><DT ><A HREF="function.mssql-fetch-assoc.html" >mssql_fetch_assoc</A > -- Returns an associative array of the current row in the result set specified by result_id </DT ><DT ><A HREF="function.mssql-fetch-batch.html" >mssql_fetch_batch</A > -- Returns the next batch of records </DT ><DT ><A HREF="function.mssql-fetch-field.html" >mssql_fetch_field</A > -- Get field information</DT ><DT ><A HREF="function.mssql-fetch-object.html" >mssql_fetch_object</A > -- Fetch row as object</DT ><DT ><A HREF="function.mssql-fetch-row.html" >mssql_fetch_row</A > -- Get row as enumerated array</DT ><DT ><A HREF="function.mssql-field-length.html" >mssql_field_length</A > -- Get the length of a field</DT ><DT ><A HREF="function.mssql-field-name.html" >mssql_field_name</A > -- Get the name of a field</DT ><DT ><A HREF="function.mssql-field-seek.html" >mssql_field_seek</A > -- Set field offset</DT ><DT ><A HREF="function.mssql-field-type.html" >mssql_field_type</A > -- Get the type of a field</DT ><DT ><A HREF="function.mssql-free-result.html" >mssql_free_result</A > -- Free result memory</DT ><DT ><A HREF="function.mssql-free-statement.html" >mssql_free_statement</A > -- Free statement memory</DT ><DT ><A HREF="function.mssql-get-last-message.html" >mssql_get_last_message</A > -- Returns the last message from server (over min_message_severity?) </DT ><DT ><A HREF="function.mssql-guid-string.html" >mssql_guid_string</A > -- Converts a 16 byte binary GUID to a string </DT ><DT ><A HREF="function.mssql-init.html" >mssql_init</A > -- Initializes a stored procedure or a remote stored procedure </DT ><DT ><A HREF="function.mssql-min-error-severity.html" >mssql_min_error_severity</A > -- Sets the lower error severity</DT ><DT ><A HREF="function.mssql-min-message-severity.html" >mssql_min_message_severity</A > -- Sets the lower message severity</DT ><DT ><A HREF="function.mssql-next-result.html" >mssql_next_result</A > -- Move the internal result pointer to the next result</DT ><DT ><A HREF="function.mssql-num-fields.html" >mssql_num_fields</A > -- Get number of fields in result</DT ><DT ><A HREF="function.mssql-num-rows.html" >mssql_num_rows</A > -- Get number of rows in result</DT ><DT ><A HREF="function.mssql-pconnect.html" >mssql_pconnect</A > -- Open persistent MS SQL connection</DT ><DT ><A HREF="function.mssql-query.html" >mssql_query</A > -- Send MS SQL query</DT ><DT ><A HREF="function.mssql-result.html" >mssql_result</A > -- Get result data</DT ><DT ><A HREF="function.mssql-rows-affected.html" >mssql_rows_affected</A > -- Returns the number of records affected by the query </DT ><DT ><A HREF="function.mssql-select-db.html" >mssql_select_db</A > -- Select MS SQL database</DT ></DL ></DIV ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="function.mime-content-type.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="function.mssql-bind.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >mime_content_type</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="funcref.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >mssql_bind</TD ></TR ></TABLE ></DIV ></BODY ></HTML >