PHP打包成EXE无法内嵌MySQL服务，仅能集成SQLite；需用__DIR__动态构建.db路径确保便携，MySQL必须单独安装并配置客户端连接。
PHP 打包成 EXE 无法直接包含 SQLite/MySQL 服务
PHP 本身是解释型语言，所谓“打包成 EXE”只是用 ExeOutput for PHP、PHP Desktop 或 WebCompiler 等工具把 PHP 解释器、你的脚本和 Web 服务器（如内置的 PHP-CGI + Chromium）打包进一个可执行文件。它不等于编译，更不等于能内嵌数据库服务进程。
SQLite 是无服务的单文件数据库，可以随程序一起分发；而 MySQL 是独立服务进程，必须单独安装并运行，不能“打包进 EXE”。强行尝试集成 MySQL 服务到 EXE 中，会导致权限、端口、服务注册、路径硬编码等一连串运行时失败。
-
sqlite3.dll（Windows）或libsqlite3.so（Linux）由 PHP 运行时自带，只要启用pdo_sqlite和sqlite3扩展即可直接用 - MySQL 需要
mysqld.exe启动服务，该进程无法被静态链接或注入到 PHP EXE 中 - 常见错误现象：
Connection refused、Can't connect to MySQL server on '127.0.0.1'、Access denied for user 'root'@'localhost'（因服务未启动或配置错）
用 SQLite 实现真正便携：文件路径必须动态化
SQLite 数据库本质是一个 .db 文件，但默认路径写死（比如 C:\myapp\data.db）会导致在其他电脑上无法读写——尤其当用户没有管理员权限、U 盘运行、或路径含中文/空格时。
关键点是：用 __DIR__ 或 getcwd() 定位当前 EXE 解压后的实际工作目录，再拼接数据库路径。
立即学习“PHP免费学习笔记（深入）”；
if (!file_exists($dbPath = __DIR__ . '/data.sqlite')) {
$pdo = new PDO('sqlite:' . $dbPath);
$pdo->exec("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)");
} else {
$pdo = new PDO('sqlite:' . $dbPath);
}
- 不要用
$_SERVER['DOCUMENT_ROOT']—— 在 EXE 环境下该值不可靠甚至为空 - 避免使用绝对路径（如
C:\temp\app.db），否则部署即失效 - 首次运行需确保目录可写：若 EXE 解压到
%TEMP%下，某些杀毒软件会拦截写入
如果非要用 MySQL：只做客户端连接，服务另装
EXE 内的 PHP 只能作为 MySQL 客户端存在。这意味着你必须要求用户提前安装 MySQL（或 MariaDB），并保证服务已启动、账号开放、网络可达。
典型配置方式（在 PHP 脚本中）：
$host = '127.0.0.1'; // 不要用 'localhost'（可能走 socket，而 EXE 环境无有效 socket 路径）
$port = 3306;
$dbname = 'myapp';
$user = 'myapp_user';
$pass = 'secure_pass';
try {
$pdo = new PDO("mysql:host={$host};port={$port};dbname={$dbname};charset=utf8mb4", $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
]);
} catch (PDOException $e) {
// 提示用户检查 MySQL 是否运行、防火墙是否放行 3306
die("MySQL 连接失败：" . $e->getMessage());
}
- 务必显式指定
port，Windows 下localhost默认走命名管道或 socket，而 EXE 打包环境通常不提供对应路径 - 账号权限要最小化：仅授予该数据库的
SELECT/INSERT/UPDATE/DELETE，禁用DROP、CREATE USER等高危权限 - 不要把密码硬编码在 PHP 文件里——EXE 可被反解，建议首次运行弹窗引导用户输入或从外部配置文件读取（如同目录下的
config.ini）
ExeOutput / PHP Desktop 打包时扩展必须手动启用
很多打包工具默认只启用最基础的 PHP 扩展（json、mbstring），pdo_sqlite、pdo_mysql、openssl 等需要你在配置界面勾选或修改 php.ini 模板。
常见遗漏导致的报错：
-
Class 'PDO' not found→ 没启用pdo扩展 -
could not find driver（SQLite）→ 缺少pdo_sqlite或sqlite3 -
Driver not found（MySQL）→pdo_mysql未启用，或libmysql.dll未随包分发（PHP Desktop 自带，ExeOutput 需确认版本匹配）
验证方法：打包后运行 EXE，在页面中执行
<?php phpinfo(); ?>，搜索关键词确认扩展已加载。
SQLite 的便携性是真实的，MySQL 的“集成”是幻觉——接受这个事实，才能避开 90% 的部署故障。
