在 ServBay 中使用内置的 SQLite 数据库模块进行 PHP 开发

ServBay 是一款功能强大的本地 Web 开发环境，专为开发者设计，支持多种技术栈。它内置了 SQLite 数据库模块，使得在 PHP 应用中使用 SQLite 进行数据存储和管理变得极为便捷。本文将详细介绍如何在 ServBay 中利用这一特性。

SQLite 模块概述

SQLite 是一个轻量级的、嵌入式的关系型数据库管理系统。与传统的客户端/服务器数据库（如 MySQL、PostgreSQL）不同，SQLite 不需要独立的服务器进程，而是直接以库的形式嵌入到应用程序中。整个数据库存储在一个单一的文件中，这极大地简化了部署和管理。

SQLite 因其以下特点而受到广泛欢迎，尤其适用于中小型应用、本地缓存、移动应用以及开发和测试环境：

主要特点

1. 轻量级：核心库体积小巧，资源占用低。
2. 零配置：无需安装、配置服务器或管理用户权限，开箱即用。
3. 高性能：对于大多数读操作和适度的写操作，SQLite 提供了出色的性能。
4. 单个文件存储：整个数据库保存在一个 .sqlite 文件中，易于备份、迁移和管理。
5. ACID 事务支持：提供可靠的事务处理，确保数据一致性和完整性。
6. 跨平台：支持多种操作系统和编程语言。

ServBay 对 SQLite 的支持

ServBay 集成了多个 PHP 版本，并且针对这些版本，相应的 SQLite 扩展（如 sqlite3 和 pdo_sqlite）已经预装并默认启用。这意味着您无需手动下载、编译或配置 PHP 扩展，即可直接在您的 PHP 项目中使用 SQLite 功能。

前提条件

• 已在 macOS 上安装并运行 ServBay。
• 已在 ServBay 中启用并运行您所需的 PHP 版本。
• 您需要一个用于存放网站文件的目录，建议使用 ServBay 默认的网站根目录 /Applications/ServBay/www 或其子目录。

如何在 ServBay 中使用 SQLite

由于 ServBay 已经默认启用了 SQLite 模块，您无需执行任何特定的启用步骤。PHP 环境已经准备就绪，可以直接调用 SQLite 相关的函数和类。

验证 SQLite 扩展是否启用：

如果您想确认 SQLite 扩展是否已成功加载，可以通过查看 phpinfo() 输出页面。

1. 创建一个包含 <?php phpinfo(); ?> 的 PHP 文件（例如 info.php）。
2. 将该文件放置在 ServBay 网站根目录 /Applications/ServBay/www 下的某个网站目录中（例如 /Applications/ServBay/www/servbay.demo/info.php）。
3. 通过浏览器访问该文件（例如 http://servbay.demo/info.php）。
4. 在输出页面中搜索 "sqlite" 或 "pdo_sqlite"。如果找到相关的配置段，说明扩展已成功启用。

在 PHP 代码中使用 SQLite

一旦确认 SQLite 扩展可用，您就可以在 PHP 应用程序中直接使用 SQLite 相关的 API 进行数据库操作。PHP 提供了多种与 SQLite 交互的方式，最常用的是 SQLite3 类（面向对象）和 PDO（PHP Data Objects）。

以下是在 ServBay 环境下，使用这两种方式连接、创建表、插入和查询数据的简单示例。建议将这些 PHP 文件和生成的 .sqlite 数据库文件存放在您的网站项目目录下，例如 /Applications/ServBay/www/your-project-name/.

示例代码（标准 SQLite3 方式）

这种方式使用 PHP 内置的 SQLite3 类，提供了一个面向对象的接口来操作 SQLite 数据库。

<?php
// 数据库文件路径
// 建议将数据库文件存放在网站项目目录下的某个子目录，例如 data/
$db_file = __DIR__ . '/data/servbay_demo.sqlite'; // __DIR__ 指当前脚本所在目录

// 确保数据目录存在
if (!is_dir(__DIR__ . '/data')) {
    mkdir(__DIR__ . '/data', 0777, true);
}

// 连接到SQLite数据库
// 如果文件不存在，SQLite会自动创建它
try {
    $db = new SQLite3($db_file);
    echo "成功连接到数据库: " . $db_file . "\n";
} catch (Exception $e) {
    die("连接数据库失败: " . $e->getMessage());
}


// 创建表
// 使用 IF NOT EXISTS 避免重复创建错误
$create_table_sql = "CREATE TABLE IF NOT EXISTS users (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT UNIQUE NOT NULL,
    age INTEGER
)";
if ($db->exec($create_table_sql)) {
    echo "表 'users' 创建或已存在\n";
} else {
    echo "创建表失败: " . $db->lastErrorMsg() . "\n";
}


// 插入数据
$name = 'ServBay Demo User';
$email = '[email protected]';
$age = 30;

// 使用预处理语句防止 SQL 注入
$stmt = $db->prepare("INSERT INTO users (name, email, age) VALUES (:name, :email, :age)");
$stmt->bindValue(':name', $name, SQLITE3_TEXT);
$stmt->bindValue(':email', $email, SQLITE3_TEXT);
$stmt->bindValue(':age', $age, SQLITE3_INTEGER);

// 执行插入，并检查是否成功（email 是 UNIQUE，重复插入会失败）
if ($stmt->execute()) {
    echo "数据插入成功: Name=" . $name . ", Email=" . $email . "\n";
} else {
    // 检查是否是唯一约束错误
    if (strpos($db->lastErrorMsg(), 'UNIQUE constraint failed') !== false) {
         echo "数据插入失败: Email '" . $email . "' 已存在\n";
    } else {
        echo "数据插入失败: " . $db->lastErrorMsg() . "\n";
    }
}
$stmt->close(); // 关闭预处理语句


// 查询数据
$search_name = 'ServBay Demo User';
$query_sql = "SELECT id, name, email, age FROM users WHERE name = :name";
$stmt = $db->prepare($query_sql);
$stmt->bindValue(':name', $search_name, SQLITE3_TEXT);

$result = $stmt->execute();

echo "查询结果:\n";
$found = false;
while ($row = $result->fetchArray(SQLITE3_ASSOC)) {
    print_r($row);
    $found = true;
}
if (!$found) {
    echo "未找到匹配数据\n";
}

$result->finalize(); // 释放结果集
$stmt->close(); // 关闭预处理语句


// 关闭数据库连接
$db->close();
echo "数据库连接已关闭\n";

?>

示例代码（PDO 方式）

PDO (PHP Data Objects) 提供了一个统一的数据库访问抽象层，您可以使用相同的函数名称来访问不同的数据库系统。使用 PDO 访问 SQLite 是推荐的方式，因为它更灵活且支持更广泛的数据库。

<?php
// 数据库文件路径
// 建议将数据库文件存放在网站项目目录下的某个子目录，例如 data/
$db_file = __DIR__ . '/data/servbay_demo_pdo.sqlite'; // __DIR__ 指当前脚本所在目录

// 确保数据目录存在
if (!is_dir(__DIR__ . '/data')) {
    mkdir(__DIR__ . '/data', 0777, true);
}

try {
    // 创建一个新的PDO实例
    // DSN (Data Source Name) 格式为 'sqlite:数据库文件路径'
    $dsn = 'sqlite:' . $db_file;
    $pdo = new PDO($dsn);

    // 设置错误模式为抛出异常，方便调试
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    // 设置默认的 fetch 模式，例如关联数组
    $pdo->setAttribute(PDO::ATTR_DEFAULT_FETCH_MODE, PDO::FETCH_ASSOC);

    echo "成功连接到数据库: " . $db_file . "\n";

    // 创建表
    $create_table_sql = "CREATE TABLE IF NOT EXISTS users (
        id INTEGER PRIMARY KEY AUTOINCREMENT,
        name TEXT NOT NULL,
        email TEXT UNIQUE NOT NULL,
        age INTEGER
    )";
    $pdo->exec($create_table_sql);
    echo "表 'users' 创建或已存在\n";


    // 插入数据
    $name = 'ServBay PDO User';
    $email = '[email protected]';
    $age = 35;

    // 使用预处理语句
    $stmt = $pdo->prepare("INSERT INTO users (name, email, age) VALUES (:name, :email, :age)");

    // 执行插入，并检查是否成功（email 是 UNIQUE，重复插入会失败）
    try {
        $stmt->execute([
            ':name' => $name,
            ':email' => $email,
            ':age' => $age
        ]);
        echo "数据插入成功: Name=" . $name . ", Email=" . $email . "\n";
    } catch (PDOException $e) {
         // 检查是否是唯一约束错误 (SQLite 错误码 19)
         if ($e->getCode() == '23000' || strpos($e->getMessage(), 'UNIQUE constraint failed') !== false) {
             echo "数据插入失败: Email '" . $email . "' 已存在\n";
         } else {
             throw $e; // 重新抛出其他类型的错误
         }
    }
    $stmt->closeCursor(); // 释放语句资源


    // 查询数据
    $search_name = 'ServBay PDO User';
    $stmt = $pdo->prepare("SELECT id, name, email, age FROM users WHERE name = :name");
    $stmt->execute([':name' => $search_name]);

    $data = $stmt->fetchAll(); // 获取所有结果行

    echo "查询结果:\n";
    if ($data) {
        print_r($data);
    } else {
        echo "未找到匹配数据\n";
    }

    $stmt->closeCursor(); // 释放语句资源

} catch (PDOException $e) {
    // 捕获 PDO 异常
    echo "数据库操作失败: " . $e->getMessage();
    // 您也可以通过 $e->getCode() 获取 SQLSTATE 错误码
}

// PDO 在脚本执行结束时会自动关闭连接，无需显式调用 close() 方法

?>

关于数据库文件位置：

在上述示例中，数据库文件 (servbay_demo.sqlite 和 servbay_demo_pdo.sqlite) 被创建在当前 PHP 脚本所在目录下的 data/ 子目录中。例如，如果您的 PHP 文件位于 /Applications/ServBay/www/my-servbay-project/index.php，那么数据库文件将创建在 /Applications/ServBay/www/my-servbay-project/data/ 目录下。

将数据库文件存放在网站项目的子目录中是一个良好的实践，便于项目管理和备份。请确保 ServBay 运行的用户对该目录有写入权限（在 macOS 的默认 ServBay 配置下，这通常不是问题）。

注意事项

• SQLite 数据库文件是敏感数据，应确保其不会被公共访问。将数据库文件存放在 Web 可访问目录之外，或者使用服务器配置（如 Caddy 或 Nginx）阻止对 .sqlite 文件的直接访问，是更安全的做法。在示例中将其放在网站目录下的 data/ 子目录仅是为了演示方便，生产环境中应考虑更严格的安全措施。
• SQLite 适用于并发写入不频繁的场景。如果在高并发写入环境下使用，可能会遇到性能瓶颈或锁定问题。对于需要高并发写入的应用，建议使用 MySQL 或 PostgreSQL 等客户端/服务器数据库。
• 虽然 ServBay 默认启用了 SQLite 扩展，但如果在 phpinfo() 中未看到相关信息，请检查 ServBay 的 PHP 配置或尝试重新启动 ServBay 服务。

常见问题解答 (FAQ)

Q: 我需要单独安装 SQLite 吗？

A: 不需要。ServBay 的 PHP 软件包已经内置并默认启用了 SQLite 扩展，您可以直接在 PHP 代码中使用。

Q: 我的 .sqlite 数据库文件应该放在哪里？

A: 建议放在您的网站项目目录下的一个非 Web 可直接访问的子目录中（例如 data/ 或 database/），以增强安全性。示例代码中使用了 __DIR__ . '/data/' 来指定相对路径。

Q: 为什么我的 PHP 脚本无法连接到 SQLite 数据库或创建文件？

A: 请检查以下几点：

• 确保 ServBay 正在运行，并且您正在通过 ServBay 访问您的 PHP 文件。
• 检查 phpinfo() 输出，确认 sqlite3 和 pdo_sqlite 扩展已启用。
• 检查存放数据库文件的目录是否存在，并且 ServBay 运行用户对该目录有写入权限。

总结

ServBay 为 PHP 开发者提供了便捷的 SQLite 数据库支持。通过 ServBay 内置并默认启用的 SQLite 模块，您可以轻松地在本地进行基于 SQLite 的应用开发和测试，无需复杂的配置过程。结合 SQLite 的轻量级和零配置特性，ServBay 成为了一个高效、易用的本地开发利器。