WampServer环境下PHP应用无法下载文件问题求助

问题描述 #

开发PHP应用时，需动态展示并下载数据库中存储的base64格式文件。前端生成下载链接后，点击时浏览器提示“Couldn't Download - Network Error.”，已尝试修改php.ini下载限制、更换浏览器、排查.htaccess干扰，问题仍未解决。相关代码如下：

foreach ($custom_tasks as $single_custom_task) {
    if (strtolower($single_custom_task['task_week']) == strtolower('week4') 
        && strtolower($single_custom_task['student_group']) == strtolower($student_group)) 
    {
        echo '<div class="activity-container">';
        echo '<h5 id="custom-task" class="text-start">Title : ' . $single_custom_task['task_name'] . '</h5>';
        echo '<p>Description: ' . $single_custom_task['task_desc'] . '</p>';
        if (base64_decode($single_custom_task['file_data'], true)) {
            echo '<a href="data:application/octet-stream;base64,' . 
                    $single_custom_task['file_data'] . 
                    '" download="' . $single_custom_task['file_name'] . '">
                    <i class="fas fa-file"></i> ' . 
                        $single_custom_task['file_name'] . '</a>';
        } else {
            echo 'Invalid file data';
        }
            
        echo '</div>';
    }
}

可能的原因及解决方法 #

• base64数据存在冗余字符：数据库中存储的base64内容可能包含换行、空格等非标准字符，导致浏览器解析失败。输出前先清理数据：

  $cleaned_base64 = preg_replace('/\s+/', '', $single_custom_task['file_data']);
  

  再将$cleaned_base64替换到链接的base64部分。

• 文件超出data URI大小限制：多数浏览器对data URI的大小有上限（通常几MB到几十MB），大文件直接用data URI会触发错误。建议改用后端接口输出文件流：

  1. 创建download_file.php接收文件ID：

     <?php
     $pdo = new PDO('mysql:host=localhost;dbname=your_db', 'user', 'pass');
     $file_id = $_GET['id'];
     $stmt = $pdo->prepare("SELECT file_name, file_data FROM custom_tasks WHERE id = ?");
     $stmt->execute([$file_id]);
     $file = $stmt->fetch(PDO::FETCH_ASSOC);
     
     if ($file && base64_decode($file['file_data'], true)) {
         $decoded_file = base64_decode($file['file_data']);
         header('Content-Type: application/octet-stream');
         header('Content-Disposition: attachment; filename="' . $file['file_name'] . '"');
         header('Content-Length: ' . strlen($decoded_file));
         echo $decoded_file;
         exit;
     } else {
         die('Invalid file');
     }
     ?>
     

  2. 修改原代码中的链接：

     echo '<a href="download_file.php?id=' . $single_custom_task['id'] . '" download="' . $single_custom_task['file_name'] . '">
             <i class="fas fa-file"></i> ' . $single_custom_task['file_name'] . '</a>';
     

• MIME类型不匹配：通用的application/octet-stream可能不被部分浏览器兼容，可根据文件后缀设置对应MIME类型：

  $ext = pathinfo($single_custom_task['file_name'], PATHINFO_EXTENSION);
  $mime_map = [
      'pdf' => 'application/pdf',
      'docx' => 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
      'xlsx' => 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
      'jpg' => 'image/jpeg'
  ];
  $mime_type = $mime_map[$ext] ?? 'application/octet-stream';
  

  然后将链接中的data:application/octet-stream;base64,替换为data:' . $mime_type . ';base64,'。

• HTML拼接错误：避免手动拼接HTML时出现的引号嵌套问题，改用HEREDOC语法输出：

  echo <<<HTML
  <div class="activity-container">
      <h5 id="custom-task" class="text-start">Title : {$single_custom_task['task_name']}</h5>
      <p>Description: {$single_custom_task['task_desc']}</p>
      <a href="data:{$mime_type};base64,{$cleaned_base64}" download="{$single_custom_task['file_name']}">
          <i class="fas fa-file"></i> {$single_custom_task['file_name']}
      </a>
  </div>
  HTML;
  

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