SQLite在XAMPP中无需配置服务,只需确保php.ini(Apache实际加载的,如C:\xampp\apache\bin\php.ini)启用php_sqlite3.dll和php_pdo_sqlite.dll扩展,数据库文件路径正确且Apache有写权限,并用SQLiteStudio管理验证结构。

SQLite 在 XAMPP 中根本不需要“配置”,它不是服务型数据库,没有启动项、端口或独立进程——只要你 PHP 环境正常,SQLite3 类和 PDO 的 sqlite 驱动默认就可用。真正卡住人的,90% 是扩展没启对、路径写错、权限没设好。
确认 php.ini 是 Apache 实际加载的那个
很多人改了 xampp\php\php.ini 却无效,因为 Apache 加载的是 xampp\apache\bin\php.ini。不查清楚这个路径,所有修改都白做。
- 新建一个
info.php放在htdocs下,内容为<?php phpinfo(); ?> - 访问
http://localhost/info.php,搜索 “Loaded Configuration File” - 看到的路径就是你必须编辑的那个文件,比如
C:\xampp\apache\bin\php.ini - 别碰带
-dist后缀的模板文件,也别改 CLI 用的xampp\php\php.ini
Windows 下必须启用的两个 DLL 扩展
只开 php_sqlite3.dll 不够,PDO 连接会报 could not find driver;只开 php_pdo_sqlite.dll 不开前者,new SQLite3() 直接抛 Class 'SQLite3' not found。
- 打开上一步确认的
php.ini,找到并取消注释这两行:extension=php_sqlite3.dll和extension=php_pdo_sqlite.dll - 确保
xampp\php\ext\目录下确实存在这两个文件(XAMPP 3.2+ 默认自带) -
extension_dir一般不用改,默认指向xampp\php\ext就行 - 改完必须重启 Apache,不是刷新网页
数据库文件路径和权限最容易踩坑
报 unable to open database file 不是代码错,几乎全是路径或权限问题。
- 数据库文件别放在
htdocs目录下(比如htdocs/myapp/data.db),否则能被直接下载;推荐放htdocs/myapp/storage/data.db,再用.htaccess拦住访问 - 确保 Apache 进程对所在目录有写权限:Windows 下通常是 SYSTEM 或当前用户,Linux/macOS 下常是
daemon或www-data - 路径用相对路径时,是以 PHP 脚本所在位置为基准,不是 Web 根目录;建议统一用绝对路径,比如
C:\xampp\htdocs\myapp\storage\data.db - 首次创建数据库时,PHP 需要能创建文件 + 写入,目录本身必须存在且可写
用 SQLiteStudio 而不是 echo 查数据
靠 var_dump() 或循环打印查数据效率低、易出错,尤其字段多或数据量稍大时。
- 下载 SQLiteStudio(免安装,跨平台),打开你的
.db文件,直接看表、改数据、执行 SQL - 它能直观显示主键、索引、触发器,还能导出建表语句,比手写
CREATE TABLE少出错 - 开发阶段每次改结构后,立刻在工具里验证是否生效,比反复跑 PHP 脚本快得多
- 别用网页版管理器(如 SQLiteManagerForPHP),XAMPP 新版本已不兼容,且存在安全风险
最常被忽略的其实是权限和路径作用域——Apache 进程看不到你命令行下能访问的路径,也写不了你用户目录下没放开的文件夹。动手前先确认 phpinfo() 里的配置路径,再检查文件所在目录的写权限,这两步做完,剩下就是纯 SQL 逻辑了。


















