1.1.5 mysql_close函数:关闭MySQL服务器的非持久连接
【功能说明】
该函数将关闭一个由函数mysql_connect()打开的非持久性的连接。通常情况下,也不需要使用该函数,因为该函数只能关闭非持久性连接,而非持久性连接在脚本执行结束后就自动关闭了。关闭成功返回TRUE,失败返回FALSE。
注:该函数不能关闭持久性连接,也就是说,不能关闭由mysql_pconnect()函数打开的连接。
【函数语法】
bool mysql_close([resource link_identifier])
其中,可选参数link_identifier是指定使用函数mysql_connect()打开的连接标识符,如果没有指定该参数的值,则该函数会自动寻找关闭最后使用函数mysql_connect()打开的连接。如果没有指定连接标识符,也没有找到使用函数mysql_connect()打开的连接,该函数会自动调用函数mysql_connect()来建立连接,然后将此连接关闭。如果找不到连接也无法创建,系统会发出一个E_WARNING级别的警告信息。该函数返回值为布尔型。
【示例程序】下面使用函数mysql_connect()打开了一个非持久连接,然后使用本例函数将此非持久性连接关闭。代码如下:
<?php //打开一个非持久的MySQL服务器的连接 $link = mysql_connect("localhost", "root", "123456")or die("connection error: " . mysql_error()); echo $link."<br />"; //输出连接后返回的标识符 $clink = mysql_close($link); //关闭打开的连接通道 var_dump($clink); //输出关闭打开连接的返回值 ?>
以上代码的运行结果如图1.5所示。
图1.5 运行结果
上述代码中,使用$link = mysql_connect("localhost", "root","123456")or die("connection error: " . mysql_error());打开了一个到本地MySQL服务器的非持久连接,如果连接失败则终止以下程序的执行,并返回错误的信息。使用该代码语句,返回了Resource id #2,说明非持久连接创建成功了。而使用mysql_close($link);代码语句关闭了打开的非持久连接,返回的结果是bool(true),说明关闭非持久连接成功了。