XAMPP开启SQLite3扩展教程

本文详细解析了在XAMPP环境中正确启用SQLite3扩展的关键步骤与常见陷阱，强调必须通过phpinfo()精准定位Apache实际加载的php.ini文件（位于xampp/apache/bin/目录下，而非xampp/php/下的CLI配置），准确取消extension=php_sqlite3.dll的注释，并同步启用pdo_sqlite相关扩展以支持PDO连接；同时提醒读者验证时需运行代码实测而非仅依赖重启Apache，并善用error.log快速定位加载失败原因——帮你避开90%因配置错位、命名错误或路径问题导致的“明明改了却无效”的调试困境。

确认 php.ini 是 XAMPP 实际加载的那个

很多人改了 php.ini 却没生效，根本原因是改错了文件。XAMPP 可能有多个 php.ini：一个在 xampp/php/（CLI 用），另一个在 xampp/apache/bin/（Apache 模块用）。Web 请求走的是 Apache 模块，所以必须改后者路径下的 php.ini。

运行 phpinfo() 页面，搜索 “Loaded Configuration File”，看到的路径才是真实生效的配置文件。别凭印象去改 xampp/php/php.ini —— 那个只影响命令行 php -v 或 php test.php。

extension=php_sqlite3.dll 必须取消注释且拼写准确

Windows 下 XAMPP 的 SQLite3 扩展名是 php_sqlite3.dll，不是 sqlite3.dll 或 php-sqlite3.dll。打开正确的 php.ini，找到这行：

;extension=php_sqlite3.dll

去掉前面的分号，保存。注意检查：

• extension_dir 指向的是 xampp\php\ext（默认值通常正确）
• 确保 xampp\php\ext\php_sqlite3.dll 确实存在（XAMPP 3.2.x 默认自带）
• 不需要额外下载或复制 sqlite3.dll 到系统目录 —— 这是过时做法，现代 PHP 不依赖它

PDO SQLite 支持需额外启用 pdo_sqlite

如果你用 PDO 连接 SQLite（比如 new PDO('sqlite:test.db')），光开 php_sqlite3.dll 不够。PDO 的 SQLite 驱动是独立扩展，必须同时启用：

;extension=php_pdo.dll
;extension=php_pdo_sqlite.dll

把这两行前面的分号都去掉。顺序无关，但两个缺一不可。否则会报 could not find driver 或 invalid data source name。

验证是否真正生效，别信重启 Apache 就万事大吉

重启 Apache 后，立刻建个 test.php 写：

var_dump(extension_loaded('sqlite3')); // 应输出 bool(true)
var_dump(extension_loaded('pdo_sqlite')); // 如果用了 PDO，这个也得 true
$db = @new SQLite3(':memory:');
var_dump($db instanceof SQLite3); // 应输出 bool(true)
?>

如果其中任一为 false 或报 Class 'SQLite3' not found，说明扩展没加载成功。常见漏点：

• Apache 和 PHP CLI 使用不同 php.ini，你只改了一个
• 扩展名写成 extension=sqlite3（少 php_ 前缀）或 .so（Windows 该用 .dll）
• 路径中含中文或空格，导致 Apache 启动失败（错误日志里会写 PHP Startup: Unable to load dynamic library）

出问题时第一反应不是重装 XAMPP，而是翻 apache/logs/error.log —— 那里会明确告诉你哪行 extension 加载失败、为什么失败。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~