如何通过 AJAX 检查本地目录是否为空并返回布尔结果

本文详解如何使用 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、未过滤路径、误判响应类型）都会导致逻辑断裂。遵循上述结构，即可稳定支撑文件导出前的状态校验流程。