PHP脚本无法将导出的CSV文件保存到服务器指定文件夹

常见问题原因 #

• 相对路径不可靠：PHP的相对路径基于当前执行脚本的工作目录，而非脚本文件所在目录，../CSV/可能指向了错误位置。
• 目标文件夹不存在：fopen不会自动创建文件夹，若CSV文件夹未提前创建，写入操作必然失败。
• 权限不足：运行PHP的服务器进程（如www-data）没有对CSV文件夹的写入权限。

解决步骤 #

1. 确认文件夹存在并设置权限
   手动创建CSV文件夹，再给它设置合适的写入权限：

   # 常规环境设置权限
   chmod 755 CSV
   # 测试环境可使用更宽松权限
   chmod 777 CSV
   

2. 使用绝对路径替代相对路径
   用__DIR__常量获取当前脚本所在目录，拼接目标路径，彻底避免路径指向错误：

   $targetPath = __DIR__ . '/../CSV/upload.csv';
   $f = fopen($targetPath, 'w');
   

3. 添加错误检查
   在fopen后加入判断，快速定位问题：

   if (!$f) {
       die('无法打开文件，请检查路径和权限');
   }
   

修改后的完整代码 #

include_once 'dbConfig.php';

$query = $db->query("SELECT *
FROM Clients
WHERE Last_Seen BETWEEN CURDATE() - INTERVAL 1 YEAR
                   AND CURDATE() - INTERVAL 6 MONTH
AND (Scheduled IS NULL OR Scheduled <= CURDATE() - INTERVAL 6 MONTH) ORDER BY Last_Seen DESC");

if($query->num_rows > 0){
   $delimiter = ",";
   $filename = "1-Year-6-Months-" . date('m-d-Y') . ".csv";

   // 使用绝对路径确保指向正确位置
   $targetPath = __DIR__ . '/../CSV/upload.csv';
   $f = fopen($targetPath, 'w');

   // 添加错误检查
   if (!$f) {
       die('无法创建或写入文件，请检查CSV文件夹是否存在及权限设置');
   }

   // 设置列标题
   $fields = array('Rep', 'First Name', 'Last Name', 'Email', 'PH Mobile', 'Date', 'Time', 'PH Mobile', 'PH Home', 'PH Work', 'Business_Name', 'Add1', 'Add2', 'City', 'State', 'Zip');
   fputcsv($f, $fields, $delimiter);

   
   // 输出每行数据，格式化为CSV并写入文件
   while($row = $query->fetch_assoc()){
       $lineData = array($row['Rep'], $row['Name'], $row['Last_Name'], $row['Email'], $row['Date'], $row['Time'], $row['PH_Mobile'], $row['PH_Home'], $row['PH_Work'], $row['Business_Name'], $row['Add1'], $row['Add2'], $row['City'], $row['State'], $row['Zip']);
       fputcsv($f, $lineData, $delimiter);
   }
   
   // 回到文件开头
   fseek($f, 0);
   
   // 设置响应头让文件下载而非直接显示
   header('Content-Type: text/csv');
   header('Content-Disposition: attachment; filename="' . $filename . '";');
   
   // 输出文件所有内容
   fpassthru($f);
   // 关闭文件句柄，避免资源泄漏
   fclose($f);
}
exit;
?>

内容的提问来源于stack exchange，提问作者Thorsverd