函数名:SQLite3::__construct()
适用版本:PHP 5 >= 5.3.0, PHP 7, PHP 8
用法:SQLite3::__construct() 是 SQLite3 类的构造方法,用于创建一个 SQLite 数据库连接对象。
语法:public SQLite3::__construct(string $filename, int $flags = SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE, string $encryption_key = "")
参数:
- $filename: 必需,要连接的 SQLite 数据库文件的路径。
- $flags: 可选,连接的标志。默认为 SQLITE3_OPEN_READWRITE | SQLITE3_OPEN_CREATE,表示以读写方式打开数据库,并在数据库不存在时创建新的数据库文件。可选的标志有:
- SQLITE3_OPEN_READONLY: 以只读方式打开数据库。
- SQLITE3_OPEN_READWRITE: 以读写方式打开数据库。
- SQLITE3_OPEN_CREATE: 如果数据库文件不存在,则创建新的数据库文件。
- $encryption_key: 可选,数据库的加密密钥。如果数据库文件使用了加密,需要提供正确的密钥才能成功连接。
返回值:如果连接成功,返回一个 SQLite3 对象;如果连接失败,抛出一个 SQLite3Exception 异常。
示例:
try {
$db = new SQLite3('mydatabase.db'); // 创建一个连接到 mydatabase.db 文件的 SQLite3 对象
echo "数据库连接成功!";
} catch (SQLite3Exception $e) {
echo "数据库连接失败:" . $e->getMessage();
}
在上面的示例中,我们尝试连接到名为 "mydatabase.db" 的 SQLite 数据库文件。如果连接成功,将输出 "数据库连接成功!";如果连接失败,将捕获并输出异常信息。