“Database path not found”是phpEnv检测到SQLite数据库父目录不存在所致，而非SQLite报错；需手动创建database/sqlite等父目录或代码中用mkdir()兜底，确保is_dir()返回true。
“Database path not found” 不是 SQLite 报的错，而是 phpEnv（或你自定义的环境检测脚本）在检查 database_path() 或类似路径函数返回值时发现目录不存在 —— 本质是路径拼对了，但父目录压根没创建。
phpEnv 报错 Database path not found 的真实含义
这个提示通常出现在 Laravel + phpEnv 组合中，比如你在 config/database.php 里写了：'database' => database_path('sqlite/app.db')，但 database/sqlite/ 这个子目录实际并不存在。
phpEnv 的检测逻辑是：调用 database_path() → 得到绝对路径（如 /var/www/myapp/database/sqlite/app.db）→ 再用 is_dir(dirname($path)) 检查上层目录 → 失败 → 直接抛出 “Database path not found”。
它不关心 SQLite 文件存不存在，只卡在「目录是否存在」这一步。
为什么用 __DIR__ 或 storage_path() 也照样报错
常见错误写法：$pdo = new PDO('sqlite:' . __DIR__ . '/data/app.db');
你以为路径拼对了，但：
• __DIR__ . '/data/app.db' 对应的目录 data/ 可能根本没建；
• 如果你在控制器里写这行，__DIR__ 指向的是 app/Http/Controllers/，而你实际想放 db 的位置是 storage/app/db/；
• storage_path('app/db/app.db') 返回路径没错，但 storage/app/db/ 目录未手动 mkdir -p，同样触发该报错。
✅ 正确做法不是换路径函数，而是先确保目录存在：
- 运行
mkdir -p database/sqlite（Laravel 默认database/可写，子目录需手动建） - 或在代码里加兜底：
$dir = dirname($databasePath); if (!is_dir($dir)) { mkdir($dir, 0755, true); } - 别依赖框架自动建目录 —— Laravel 的
database_path()只返回路径，不创建目录
SQLite 文件路径拼写与权限的连环坑
即使目录存在，“Database path not found” 也可能由以下原因引发：
• 路径含中文或空格（如 database/用户数据/app.db），phpEnv 解析失败；
• Windows 下用了反斜杠 \，而 SQLite DSN 只认正斜杠 /，拼出来变成 sqlite:C:\path\app.db → 被当无效 URI；
• Web 服务器用户（如 www-data）对目录只有读权限，没有执行（x）权限 —— Linux 下进入目录需要 x 权限，缺了就判定“路径不可达”；
• 使用了符号链接，但 phpEnv 没启用 follow_symlinks，导致 is_dir() 返回 false。
✅ 验证方式：var_dump(is_dir(database_path('sqlite'))); // 必须输出 truevar_dump(is_writable(database_path('sqlite'))); // 建议同时为 true
立即学习“PHP免费学习笔记（深入）”；
绕过 phpEnv 检测的临时方案（仅调试用）
如果你确认路径和权限都没问题，只是 phpEnv 的检测逻辑太激进（比如它硬要检查 database/sqlite/，但你把 DB 放在 storage/app/db/），可以：
• 临时注释掉 phpEnv 中对应路径检查的代码段（通常在 env-checker.php 或服务提供者里）；
• 或改用 file_exists() 替代 is_dir() 判断（因为 SQLite 文件存在即代表路径可达）；
• 但生产环境务必还原 —— 缺失目录是部署疏漏，不是配置问题。
最稳妥的做法永远是：运行部署脚本前，明确执行 mkdir -p storage/app/db 并 chown www-data:www-data storage/app/db。
