MS SQL Server The MSSQL extension is available on Win32 systems only. You can use the Sybase extension to connect to MSSQL databases from other platforms. These functions allow you to access MS SQL Server database. 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. The MSSQL extension is enabled by adding extension=php_mssql.dll to php.ini. mssql_close Close MS SQL Server connection int mssql_close int link_identifier Returns: &true; on success, &false; on error. mssql_close closes the link to a MS SQL Server database that's associated with the specified link identifier. If the link identifier isn't specified, the last opened link is assumed. Note that this isn't usually necessary, as non-persistent open links are automatically closed at the end of the script's execution. mssql_close will not close persistent links generated by mssql_pconnect. See also: mssql_connect, mssql_pconnect. mssql_connect Open MS SQL server connection int mssql_connect string servername string username string password Returns: A positive MS SQL link identifier on success, or &false; on error. mssql_connect establishes a connection to a MS SQL server. The servername argument has to be a valid servername that is defined in the 'interfaces' file. In case a second call is made to mssql_connect with the same arguments, no new link will be established, but instead, the link identifier of the already opened link will be returned. The link to the server will be closed as soon as the execution of the script ends, unless it's closed earlier by explicitly calling mssql_close. See also mssql_pconnect, mssql_close. mssql_data_seek Move internal row pointer int mssql_data_seek int result_identifier int row_number Returns: &true; on success, &false; on failure. mssql_data_seek moves the internal row pointer of the MS SQL result associated with the specified result identifier to point to the specified row number. The next call to mssql_fetch_row would return that row. See also: mssql_data_seek. mssql_fetch_array Fetch row as array int mssql_fetch_array int result Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. mssql_fetch_array is an extended version of mssql_fetch_row. In addition to storing the data in the numeric indices of the result array, it also stores the data in associative indices, using the field names as keys. An important thing to note is that using mssql_fetch_array is NOT significantly slower than using mssql_fetch_row, while it provides a significant added value. For further details, also see mssql_fetch_row. mssql_fetch_field Get field information object mssql_fetch_field int result int field_offset Returns an object containing field information. mssql_fetch_field can be used in order to obtain information about fields in a certain query result. If the field offset isn't specified, the next field that wasn't yet retrieved by mssql_fetch_field is retrieved. The properties of the object are: name - column name. if the column is a result of a function, this property is set to computed#N, where #N is a serial number. column_source - the table from which the column was taken max_length - maximum length of the column numeric - 1 if the column is numeric See also mssql_field_seek. mssql_fetch_object Fetch row as object int mssql_fetch_object int result Returns: An object with properties that correspond to the fetched row, or &false; if there are no more rows. mssql_fetch_object is similar to mssql_fetch_array, with one difference - an object is returned, instead of an array. Indirectly, that means that you can only access the data by the field names, and not by their offsets (numbers are illegal property names). Speed-wise, the function is identical to mssql_fetch_array, and almost as quick as mssql_fetch_row (the difference is insignificant). See also: mssql_fetch-array and mssql_fetch-row. mssql_fetch_row Get row as enumerated array array mssql_fetch_row int result Returns: An array that corresponds to the fetched row, or &false; if there are no more rows. mssql_fetch_row fetches one row of data from the result associated with the specified result identifier. The row is returned as an array. Each result column is stored in an array offset, starting at offset 0. Subsequent call to mssql_fetch_rows would return the next row in the result set, or &false; if there are no more rows. See also: mssql_fetch_array, mssql_fetch_object, mssql_data_seek, mssql_fetch_lengths, and mssql_result. mssql_field_length Get the length of a field int mssql_field_length int result int offset mssql_field_name Get the name of a field int mssql_field_name int result int offset mssql_field_seek Set field offset int mssql_field_seek int result int field_offset Seeks to the specified field offset. If the next call to mssql_fetch_field won't include a field offset, this field would be returned. See also: mssql_fetch_field. mssql_field_type Get the type of a field string mssql_field_type int result int offset mssql_free_result Free result memory int mssql_free_result int result mssql_free_result only needs to be called if you are worried about using too much memory while your script is running. All result memory will automatically be freed when the script ends. You may call mssql_free_result with the result identifier as an argument and the associated result memory will be freed. mssql_get_last_message Returns the last message from server (over min_message_severity?) string mssql_get_last_message mssql_min_error_severity Sets the lower error severity void mssql_min_error_severity int severity mssql_min_message_severity Sets the lower message severity void mssql_min_message_severity int severity mssql_next_result Move the internal result pointer to the next result bool mssql_next_result int result_id When sending more than one SQL statement to the server or executing a stored procedure with multiple results, it will cause the server to return multiple result sets. This function will test for additional results available form the server. If an additional result set exists it will free the existing result set and prepare to fetch the rows from the new result set. The function will return &true; if an additional result set was available or &false; otherwise. ]]> mssql_num_fields Get number of fields in result int mssql_num_fields int result mssql_num_fields returns the number of fields in a result set. See also: mssql_db_query, mssql_query, mssql_fetch_field, and mssql_num_rows. mssql_num_rows Get number of rows in result int mssql_num_rows string result mssql_num_rows returns the number of rows in a result set. See also: mssql_db_query, mssql_query, and mssql_fetch_row. mssql_pconnect Open persistent MS SQL connection int mssql_pconnect string servername string username string password Returns: A positive MS SQL persistent link identifier on success, or &false; on error. mssql_pconnect acts very much like mssql_connect with two major differences. First, when connecting, the function would first try to find a (persistent) link that's already open with the same host, username and password. If one is found, an identifier for it will be returned instead of opening a new connection. Second, the connection to the SQL server will not be closed when the execution of the script ends. Instead, the link will remain open for future use (mssql_close will not close links established by mssql_pconnect). This type of links is therefore called 'persistent'. mssql_query Send MS SQL query int mssql_query string query int link_identifier Returns: A positive MS SQL result identifier on success, or &false; on error. mssql_query sends a query to the currently active database on the server that's associated with the specified link identifier. If the link identifier isn't specified, the last opened link is assumed. If no link is open, the function tries to establish a link as if mssql_connect was called, and use it. See also: mssql_db_query, mssql_select_db, and mssql_connect. mssql_result Get result data int mssql_result int result int i mixed field mssql_result returns the contents of one cell from a MS SQL result set. The field argument can be the field's offset, the field's name or the field's table dot field's name (tablename.fieldname). If the column name has been aliased ('select foo as bar from...'), it uses the alias instead of the column name. When working on large result sets, you should consider using one of the functions that fetch an entire row (specified below). As these functions return the contents of multiple cells in one function call, they're MUCH quicker than mssql_result. Also, note that specifying a numeric offset for the field argument is much quicker than specifying a fieldname or tablename.fieldname argument. Recommended high-performance alternatives: mssql_fetch_row, mssql_fetch_array, and mssql_fetch_object. mssql_select_db Select MS SQL database int mssql_select_db string database_name int link_identifier Returns: &true; on success, &false; on error mssql_select_db sets the current active database on the server that's associated with the specified link identifier. If no link identifier is specified, the last opened link is assumed. If no link is open, the function will try to establish a link as if mssql_connect was called, and use it. Every subsequent call to mssql_query will be made on the active database. See also: mssql_connect, mssql_pconnect, and mssql_query mssql_bind Adds a parameter to a stored procedure or a remote stored procedure int mssql_bind int stmt string param_name mixed var int type int is_output int is_null int maxlen &warn.undocumented.func; mssql_execute Executes a stored procedure on a MS-SQL server database int mssql_execute int stmt &warn.undocumented.func; mssql_fetch_assoc Returns an associative array of the current row in the result set specified by result_id array mssql_fetch_assoc int result_id int result_type &warn.undocumented.func; mssql_fetch_batch Returns the next batch of records int mssql_fetch_batch string result_index &warn.undocumented.func; mssql_guid_string Converts a 16 byte binary GUID to a string string mssql_guid_string string binary int short_format &warn.undocumented.func; mssql_init Initializes a stored procedure or a remote stored procedure int mssql_init string sp_name int conn_id &warn.undocumented.func; mssql_rows_affected Returns the number of records affected by the query int mssql_rows_affected int conn_id &warn.undocumented.func;