core::connect

(CoreMVC 1.0)

core::connect — 数据库连接

---

◎描述

handle core::connect ( array $args [, array &$ref = null ] )

---

handle core::connect ( bool $connect [, array &$ref = null ] )

---

handle core::connect ( string $filename [, array &$ref = null ] )

---

mixed core::connect ( string $attribute [, array &$ref = null ] )

---

handle core::connect ( int $current [, array &$ref = null ] )

---

array core::connect ( [ null [, array &$ref = null ] ] )

---

该方法可以设置数据库参数，可以连接或断开数据库，也可以支持多数据库并自由选择。相关数据库方法会自动连接数据库，但该方法可以返回数据库句柄以便于手工操作数据库。

◎参数

args

设置当前连接的数据库参数数组，非设置项不会替换已有的。

connect

是否连接数据库，如果是则连接数据库，如果否则断开数据库。

filename

当前连接的要导入的配置文件。文件名必须以“.php”结尾。

attribute

要取得属性值的属性名称，如果该属性名称不存在则返回空串。

current

要选择的当前数据库连接的编号，只能是非负整数，初始默认的是0。

ref

当前连接的配置信息数组。

◎返回值

如果传入属性名称则返回属性值，未找到时返回空串。如果没有参数则返回所有数据库信息。其他情况下都会返回数据库连接句柄，未连接时返回空值。

◎修改日志

版本	描述

1.2	修改了部份参数及返回值，增加了配置文件参数和属性参数。
1.3	删除了以“.ini”结尾的配置文件，增加了sql_format参数及环境变量设置方法。

◎例子

连接数据库的各种方法

《index.php》
<?php
require_once 'core.php';

var_dump(core::connect()); //显示所有的数据库信息，包括不同连接的参数及连接句柄等。

core::connect('config.php'); //导入数据库配置文件，仅对当前连接有效。

core::connect(true,$ref); //连接数据库，并在第二参数处返回配置信息，并返回连接句柄。

core::connect(array('debug_enable'=>true)); //设置数据库参数。

core::connect(array('sql_format'=>true)); //设置整合SQL参数以方便调试SQL语句。

core::connect('connect_provider'); //取数据库配置属性。

core::connect(false); //断开数据库，同时相应的配置信息也清空。
?>

《config.php》
<?php
return array(
    'connect_username' => 'root',
);
?>