本文详解如何使用 jquery ajax 调用 php 脚本检查指定路径文件夹是否为空，并正确返回 `true`/`false` 语义值（实际以 `1`/`0` 形式传输），解决因 php 输出缺失、类型不匹配导致的前端判断失效问题。
在 Web 开发中，常需通过前端触发后端逻辑来校验服务器端状态（如某输出目录是否存在待下载文件）。但需注意：浏览器无法直接访问本地磁盘路径（如 D:/output）——该路径必须是 Web 服务器可读的服务端路径（例如 /var/www/html/output 或 C:/xampp/htdocs/output），且 PHP 进程需具备对应目录的读取权限。
✅ 正确的前后端协同逻辑
1. 前端 AJAX 调用（优化版）
function downloadExcel() {
const folder = "/path/on/server/output"; // ⚠️ 必须是服务器绝对路径或相对于 Web 根目录的路径
if (result.isConfirmed) {
$.ajax({
type: 'POST',
url: 'check_file.php',
data: { folder: folder },
cache: false,
dataType: 'text', // 明确指定响应类型为纯文本，避免 jQuery 自动转换干扰
success: function(response) {
// 将响应转为数字再转布尔：'1' → true, '0' → false
const isEmpty = response.trim() === '1';
if (isEmpty) {
Swal.fire('执行成功', '目标文件夹为空', 'success');
} else {
Swal.fire('提取失败', '文件夹非空，请检查输出内容', 'error');
}
},
error: function(xhr, status, error) {
console.error("AJAX 请求失败:", status, error);
Swal.fire('错误', '无法连接到服务器或路径不可读', 'error');
}
});
refresh();
} else if (result.dismiss === Swal.DismissReason.cancel) {
// 取消逻辑
}
}2. 后端 PHP 脚本（check_file.php）
⚠️ 关键注意事项
- 路径安全性第一：永远不要直接使用用户传入的路径拼接 scandir()，务必过滤 ..、空字节等攻击向量；
- PHP 输出必须唯一：echo 是向 AJAX 返回数据的唯一方式；return、print_r()、var_dump() 或未 echo 的变量均无效；
- 布尔值不能直接 echo：echo false 输出空字符串，echo true 输出 1 —— 但语义模糊，统一用 '0'/'1' 最可靠；
- 前端类型转换要显式：JS 接收的是字符串，需用 response.trim() === '1' 判断，而非 if (response)（空字符串、'0' 都为 falsy）；
- 调试建议：在浏览器 DevTools 的 Network 标签页中查看 check_file.php 的 Response 内容，确认是否精确返回 0 或 1。
✅ 总结
实现“AJAX 检查目录是否为空”的核心在于：后端只输出机器可解析的确定值（0/1），前端据此做明确分支处理，并全程保障路径安全与类型严谨性。跳过任何一环（如忘记 echo、未过滤路径、误判响应类型）都会导致逻辑断裂。遵循上述结构，即可稳定支撑文件导出前的状态校验流程。
