# mssql_connect

(PHP 4, PHP 5, PECL odbtp >= 1.1.1)

mssql_connect — 打开MS SQL server链接

### 说明

mssql_connect ([ string `$servername` [, string `$username` [, string `$password` [, bool `$new_link` = false ]]]] ) : resource

mssql_connect() 建立一个MS SQL server链接。

链接会在程序执行结束之后关闭, 除非在之前已经通过调用mssql_close()关闭。

### 参数

`servername`

  服务器,它可以包含一个端口号 e.g. 主机:端口号(hostname:port) (Linux), 或 主机,端口号(hostname,port) (Windows).

`username`

  用户名。

`password`

  密码。

`new_link`

  如果第二次调用mssql_connect()使用相同的参数， 不会建立新的链接，而是将之前已经打开的链接标识返回。对这个参数的值进行修改，则使得调用 mssql_connect()总是会建立新的链接， 即便调用mssql_connect()使用与之前同样的参数。

### 返回值

返回一个链接视为成功, 或者 `FALSE` 和错误信息.

### 更新日志

版本 | 说明
--- | ---
5.1.0 | `new_link`参数加入

### 范例

Example #1 mssql_connect() 例子

    <?php
    // Server in the this format: <computer>\<instance name> or
    // <server>,<port> when using a non default port number
    $server = 'KALLESPC\SQLEXPRESS';

    // Connect to MSSQL
    $link = mssql_connect($server, 'sa', 'phpfi');

    if (!$link) {
        die('Something went wrong while connecting to MSSQL');
    }
    ?>

### 参见

- mssql_close() - 关闭MS SQL Server链接
- mssql_pconnect() - Open persistent MS SQL connection