MSSQL_CONNECT(3)MSSQL_CONNECT(3)mssql_connect - Open MS SQL server connectionSYNOPSIS
resource mssql_connect ([string $servername], [string $username], [string $password], [bool $new_link = false])
DESCRIPTION mssql_connect(3) establishes a connection to a MS SQL server.
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(3).
PARAMETERS
o $servername
- The MS SQL server. It can also include a port number, e.g. hostname:port (Linux), or hostname,port (Windows).
o $username
- The username.
o $password
- The password.
o $new_link
- If a second call is made to mssql_connect(3) with the same arguments, no new link will be established, but instead, the link
identifier of the already opened link will be returned. This parameter modifies this behavior and makes mssql_connect(3) always
open a new link, even if mssql_connect(3) was called before with the same parameters.
RETURN VALUES
Returns a MS SQL link identifier on success, or FALSE on error.
CHANGELOG
+--------+------------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+------------------------------------+
| 5.1.0 | |
| | |
| | The $new_link parameter was added |
| | |
+--------+------------------------------------+
EXAMPLES
Example #1
mssql_connect(3) example
<?php
// Server in the this format: <computer><instance name> or
// <server>,<port> when using a non default port number
$server = 'KALLESPCSQLEXPRESS';
// Connect to MSSQL
$link = mssql_connect($server, 'sa', 'phpfi');
if (!$link) {
die('Something went wrong while connecting to MSSQL');
}
?>
SEE ALSO mssql_close(3), mssql_pconnect(3).
PHP Documentation Group MSSQL_CONNECT(3)
Check Out this Related Man Page
MSSQL_BIND(3)MSSQL_BIND(3)mssql_bind - Adds a parameter to a stored procedure or a remote stored procedureSYNOPSIS
bool mssql_bind (resource $stmt, string $param_name, mixed &$var, int $type, [bool $is_output = false], [bool $is_null = false], [int
$maxlen = -1])
DESCRIPTION
Binds a parameter to a stored procedure or a remote stored procedure.
PARAMETERS
o $stmt
- Statement resource, obtained with mssql_init(3).
o $param_name
- The parameter name, as a string.
Note
You have to include the @ character, like in the T-SQL syntax. See the explanation included in mssql_execute(3).
o $var
- The PHP variable you'll bind the MSSQL parameter to. It is passed by reference, to retrieve OUTPUT and RETVAL values after the
procedure execution.
o $type
- One of: SQLTEXT, SQLVARCHAR, SQLCHAR, SQLINT1, SQLINT2, SQLINT4, SQLBIT, SQLFLT4, SQLFLT8, SQLFLTN.
o $is_output
- Whether the value is an OUTPUT parameter or not. If it's an OUTPUT parameter and you don't mention it, it will be treated as a
normal input parameter and no error will be thrown.
o $is_null
- Whether the parameter is NULL or not. Passing the NULL value as $var will not do the job.
o $maxlen
- Used with char/varchar values. You have to indicate the length of the data so if the parameter is a varchar(50), the type must
be SQLVARCHAR and this value 50.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
mssql_bind(3) example
<?php
// Connect to MSSQL and select the database
mssql_connect('KALLESPCSQLEXPRESS', 'sa', 'phpfi');
mssql_select_db('php');
// Create a new stored prodecure
$stmt = mssql_init('NewUserRecord');
// Bind the field names
mssql_bind($stmt, '@username', 'Kalle', SQLVARCHAR, false, false, 60);
mssql_bind($stmt, '@name', 'Kalle', SQLVARCHAR, false, false, 60);
mssql_bind($stmt, '@age', 19, SQLINT1, false, false, 3);
// Execute
mssql_execute($stmt);
// Free statement
mssql_free_statement($stmt);
?>
SEE ALSO mssql_execute(3), mssql_free_statement(3), mssql_init(3).
PHP Documentation Group MSSQL_BIND(3)