在Windows环境中使用SQLite与PHP进行数据存储

PHP 与 SQLite 的组合，为轻量级数据存储提供了一个简单高效的解决方案。如果你需要在 Windows 环境下快速搭建数据库应用，本文将详细介绍如何配置与使用这对组合来完成数据存储与管理。

一、环境准备

在开始使用SQLite和PHP进行数据存储之前，需要确保Windows系统已经安装了PHP和SQLite扩展。以下是具体的准备步骤：

1. 安装PHP：可以从PHP官方网站（https://www.php.net/downloads.php）下载适合Windows系统的PHP版本。下载完成后，解压到指定目录，例如C:\php。

2. 配置环境变量：将PHP的安装目录（如C:\php）添加到系统的环境变量PATH中，这样在命令行中就可以直接使用PHP命令。

3. 启用SQLite扩展：打开PHP安装目录下的php.ini文件，找到并取消以下两行的注释：

;extension=sqlite3
;extension=pdo_sqlite

将上述两行前面的分号（;）去掉，保存文件。这样就启用了SQLite和PDO_SQLite扩展。

4. 验证安装：打开命令行工具，输入以下命令：

php -m | findstr sqlite

如果输出显示sqlite3和pdo_sqlite，则说明扩展已经成功启用。

二、创建SQLite数据库

在PHP中，可以使用SQLite3类来创建和操作SQLite数据库。以下是一个简单的示例代码，用于创建一个名为test.db的SQLite数据库：

<?php
// 打开或创建SQLite数据库
$db = new SQLite3('test.db');
if (!$db) {
    echo $db->lastErrorMsg();
} else {
    echo "数据库创建成功";
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先使用SQLite3类的构造函数打开或创建一个名为test.db的数据库。如果数据库创建失败，将输出错误信息；如果成功，则输出“数据库创建成功”。最后，使用close方法关闭数据库连接。

三、创建数据表

创建好数据库后，需要在其中创建数据表来存储数据。以下是一个示例代码，用于在test.db数据库中创建一个名为users的数据表：

<?php
// 打开SQLite数据库
$db = new SQLite3('test.db');
// 创建数据表的SQL语句
$sql = "CREATE TABLE IF NOT EXISTS users (
      id INTEGER PRIMARY KEY AUTOINCREMENT,
      name TEXT NOT NULL,
      email TEXT NOT NULL UNIQUE
   )";
// 执行SQL语句
$ret = $db->exec($sql);
if (!$ret) {
    echo $db->lastErrorMsg();
} else {
    echo "数据表创建成功";
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先打开test.db数据库。然后，使用CREATE TABLE语句创建一个名为users的数据表，该表包含三个字段：id（自增主键）、name（姓名，不能为空）和email（邮箱，不能为空且唯一）。最后，使用exec方法执行SQL语句，并根据执行结果输出相应的信息。

四、添加数据

创建好数据表后，就可以向其中添加数据了。以下是一个示例代码，用于向users数据表中添加一条新记录：

<?php
// 打开SQLite数据库
$db = new SQLite3('test.db');
// 添加数据的SQL语句
$sql = "INSERT INTO users (name, email) VALUES ('John Doe', 'johndoe@example.com')";
// 执行SQL语句
$ret = $db->exec($sql);
if (!$ret) {
    echo $db->lastErrorMsg();
} else {
    echo "数据添加成功，新记录的ID为：" . $db->lastInsertRowID();
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先打开test.db数据库。然后，使用INSERT INTO语句向users数据表中添加一条新记录。最后，使用exec方法执行SQL语句，并根据执行结果输出相应的信息。如果添加成功，还会输出新记录的ID。

五、查询数据

添加数据后，需要能够查询这些数据。以下是一个示例代码，用于从users数据表中查询所有记录：

<?php
// 打开SQLite数据库
$db = new SQLite3('test.db');
// 查询数据的SQL语句
$sql = "SELECT * FROM users";
// 执行SQL语句
$results = $db->query($sql);
if (!$results) {
    echo $db->lastErrorMsg();
} else {
    while ($row = $results->fetchArray(SQLITE3_ASSOC)) {
        echo "ID: " . $row['id'] . ", 姓名: " . $row['name'] . ", 邮箱: " . $row['email'] . "
";
    }
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先打开test.db数据库。然后，使用SELECT语句从users数据表中查询所有记录。接着，使用query方法执行SQL语句，并使用fetchArray方法逐行获取查询结果。最后，根据执行结果输出相应的信息。

六、更新数据

有时候，需要对已经存在的数据进行更新。以下是一个示例代码，用于更新users数据表中指定记录的信息：

<?php
// 打开SQLite数据库
$db = new SQLite3('test.db');
// 更新数据的SQL语句
$sql = "UPDATE users SET name = 'Jane Doe' WHERE id = 1";
// 执行SQL语句
$ret = $db->exec($sql);
if (!$ret) {
    echo $db->lastErrorMsg();
} else {
    echo "数据更新成功，受影响的记录数为：" . $db->changes();
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先打开test.db数据库。然后，使用UPDATE语句更新users数据表中id为1的记录的姓名为“Jane Doe”。最后，使用exec方法执行SQL语句，并根据执行结果输出相应的信息。如果更新成功，还会输出受影响的记录数。

七、删除数据

当某些数据不再需要时，可以将其从数据表中删除。以下是一个示例代码，用于删除users数据表中指定记录：

<?php
// 打开SQLite数据库
$db = new SQLite3('test.db');
// 删除数据的SQL语句
$sql = "DELETE FROM users WHERE id = 1";
// 执行SQL语句
$ret = $db->exec($sql);
if (!$ret) {
    echo $db->lastErrorMsg();
} else {
    echo "数据删除成功，受影响的记录数为：" . $db->changes();
}
// 关闭数据库连接
$db->close();
?>

在上述代码中，首先打开test.db数据库。然后，使用DELETE语句删除users数据表中id为1的记录。最后，使用exec方法执行SQL语句，并根据执行结果输出相应的信息。如果删除成功，还会输出受影响的记录数。

八、错误处理

在使用SQLite和PHP进行数据存储时，可能会遇到各种错误，如数据库连接失败、SQL语句执行错误等。因此，需要进行适当的错误处理。以下是一个示例代码，演示了如何进行错误处理：

<?php
try {
    // 打开SQLite数据库
    $db = new SQLite3('test.db');
    // 执行SQL语句
    $sql = "SELECT * FROM non_existent_table";
    $results = $db->query($sql);
    while ($row = $results->fetchArray(SQLITE3_ASSOC)) {
        echo "ID: " . $row['id'] . ", 姓名: " . $row['name'] . ", 邮箱: " . $row['email'] . "
";
    }
} catch (Exception $e) {
    echo "发生错误：" . $e->getMessage();
} finally {
    // 关闭数据库连接
    if (isset($db)) {
        $db->close();
    }
}
?>

在上述代码中，使用try-catch-finally语句块进行错误处理。在try块中，尝试打开数据库并执行SQL语句。如果发生异常，将在catch块中捕获并输出错误信息。最后，在finally块中关闭数据库连接，确保无论是否发生异常，数据库连接都会被关闭。

九、总结

通过本文的介绍，我们了解了在Windows环境中如何使用SQLite与PHP进行数据存储。首先，需要进行环境准备，包括安装PHP和启用SQLite扩展。然后，可以使用SQLite3类创建和操作SQLite数据库，包括创建数据表、添加数据、查询数据、更新数据和删除数据等操作。同时，还需要进行适当的错误处理，以确保程序的稳定性和可靠性。SQLite和PHP的结合为小型项目和嵌入式系统提供了一种简单、高效的数据存储解决方案。