01. 环境搭建与准备
01.1 Windows 11 系统准备与软件需求
本教程聚焦Windows 11 下的开发环境搭建，用以实现 PHP 连接 SQLite 的完整流程，因此需要具备基本的系统访问权限与网络配置。请确认已开启开发者模式、并具备管理员权限以安装或修改系统组件。关键要点包括下载合适的 PHP 运行时、配置 PATH 变量，以及准备一个可写的工作目录用于创建 SQLite 数据库文件。
在进行环境搭建前，建议先了解目标 PHP 版本在 Windows 11 上的兼容性与扩展状态，确保后续使用的扩展模块（例如 sqlite3、pdo_sqlite）与 PHP 版本匹配。系统兼容性是稳定运行的基础。
01.2 下载并解压 PHP 到本地目录
推荐从 PHP 官方站点下载适合 Windows 的版本，优先选择 Thread Safe (TS) 版本以便后续与 Web 服务器对接，若仅进行 CLI 测试也可选用非 TS 版本。将下载的压缩包解压到一个简洁的目录，例如 C:\php，并记下扩展目录 ext，后续启用 sqlite3 与 pdo_sqlite 需要正确的路径信息。
解压后请确保目录结构清晰，并准备一个工作目录用于数据库文件的存放，例如 C:\php-work，以便后续在示例中引用数据库文件路径。目录命名规范有助于避免路径冲突。
02. 配置 PHP 与 SQLite 扩展
02.1 配置环境变量与 php.ini
将 C:\php 添加到系统 PATH，这样在任意路径都能直接执行 php 命令，提升开发效率。完成后打开命令行，输入 php -v 验证是否能正确输出 PHP 版本信息。
在 php.ini 中启用 sqlite3 与 pdo_sqlite 扩展，通常需要移除注释或确保以下两行存在且未被注释：
extension=pdo_sqlite
extension=sqlite3此外，请确保扩展目录设置正确（extension_dir 指向 ext 目录，如 C:\php\ext），以便 PHP 能加载这些扩展。路径正确性直接决定扩展是否就绪。
02.2 验证扩展是否成功加载
在命令行执行 php -m，应看到输出中包含 pdo_sqlite、sqlite3 等模块。如果没有，请检查 php.ini 是否被正确加载、扩展目录是否正确，以及是否存在多个 PHP 版本冲突导致设置未生效。诊断要点包括使用 phpinfo() 获取当前 PHP 环境信息。
在排错时，可以创建一个简单的测试脚本并通过命令行运行，确保数据库扩展在运行时可用。这有助于快速定位是环境变量还是配置文件导致的问题。快速验证方法将帮助你确保后续的数据库操作顺利进行。
03. 使用 PDO 连接 SQLite 的基本操作
03.1 创建数据库文件与初始化表结构
SQLite 使用一个本地文件来存储数据库，所以请在工作目录内准备一个数据库文件，例如 C:\php-work\data.db。若数据库文件不存在，使用 PDO 可以在第一次连接时自动创建。本地文件路径应可读写，避免只读权限导致写入失败。
为了演示，我们先创建一个简单的用户表，便于后续演示增删改查操作。建议在应用中使用相对路径引用数据库文件，使部署在不同环境时更易维护。推荐实践是将数据库文件与应用代码放在同一个目录并进行相对路径处理。
以下是一个简短的初始化示例，演示如何在连接后创建表并准备数据结构。请将数据库文件路径替换为你的实际路径。安全性与异常处理在生产环境也应考虑。
03.2 基本的 PDO 连接、创建表与简单 CRUD
使用 PDO 连接 SQLite 的核心思想是通过 DSN 形式指定数据库文件路径，然后以 PDO 实例执行 SQL。下面的示例展示了连接、创建表、插入数据以及查询数据的基本流程。核心要点是确保错误模式设置为异常，以便捕获并处理数据库错误。
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);// Create table
$pdo->exec("CREATE TABLE IF NOT EXISTS users (id INTEGER PRIMARY KEY AUTOINCREMENT,name TEXT NOT NULL)
");// Insert
$stmt = $pdo->prepare("INSERT INTO users (name) VALUES (:name)");
$stmt->execute([':name' => '张三']);// Query
$rows = $pdo->query("SELECT * FROM users")->fetchAll(PDO::FETCH_ASSOC);
var_dump($rows);
?>上述代码展示了 数据库连接、表创建、数据写入与读取 的完整流程，适合作为新手入门的起点。若要进一步加强安全性与可维护性，可以将 SQL 及参数绑定封装到函数中，以便于复用与单元测试。可维护性与 可扩展性是实际项目中需要关注的要点。
04. 常见问题排查与调试要点
04.1 常见错误：扩展未加载或数据库连接失败
若运行时出现 “未定义函数” 或 “无法加载扩展” 的错误，请先确认 pdo_sqlite 与 sqlite3 是否已在 php.ini 中正确开启，并且 extension_dir 指向正确的扩展目录。使用 phpinfo() 可以快速确认正在使用的配置。
另一种排错方式是直接在命令行执行 php -i | findstr sqlite（Windows），查看已加载的 sqlite 相关信息。若无输出，请回到扩展加载步骤，重新启动命令行或 IIS/Apache 服务以使配置生效。重启服务与重新打开命令行是常用的快速修复步骤。
04.2 路径、权限与并发访问的注意点
SQLite 的数据库文件必须具备可读写权限，尤其是在 Windows 11 的默认安全策略下，数据库文件若设为只读或所在目录权限不足，应用可能会抛出“磁盘错误”或“权限被拒绝”的异常。请确保数据库文件 所在目录 的权限设置允许应用程序写入。权限管理是确保稳定写入的关键。
另外，在多进程/多线程环境中对同一数据库文件的并发访问需要谨慎。如果应用并发写入，考虑使用事务控制与锁策略，避免数据损坏或竞争条件。事务边界与 异常处理可以显著提升鲁棒性。
04.3 事务处理与错误日志
在实际使用中，开启错误模式并用 try-catch 捕获异常，是妥善处理数据库错误的常见做法。下面展示一个带错误处理的连接片段，便于定位问题所在。错误处理、日志记录与 用户友好提示是生产环境的重要组成部分。
setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);// 进行数据库操作...
} catch (PDOException $e) {// 记录日志、返回友好信息或终止执行error_log('SQLite 错误: ' . $e->getMessage());echo '数据库访问发生错误，请稍后再试。';
}
?> 