在codeigniter中强制下载文件，应调用 download_helper 中的 force_download() 函数。该函数接收文件名和文件内容（或路径），设置http响应头为 application/octet-stream 并触发浏览器下载对话框。若传入数组参数，可指定附件名称以解决中文文件名乱码问题。
如何传递文件内容与自定义保存名称
通过 force_download() 的第二个参数传入字符串内容，第三个参数传入目标文件名即可实现自定义命名下载。当文件名包含非ASCII字符时，建议将前两个参数放入关联数组中，利用CodeIgniter底层对RFC 5987编码的支持确保兼容性。
$file_content = "This is the content of the file.";
$file_name = "report.txt";
// 方式一：直接传递参数
force_download($file_name, $file_content);
// 方式二：使用数组传递以支持中文文件名
$data = array(
'name' => '报告.txt',
'data' => $file_content
);
force_download($data);
上述代码执行后，浏览器将弹出下载框。方式一下载的文件名为 report.txt；方式二下，若服务器配置正确，文件名将显示为 报告.txt。返回值通常为 void，因为输出已直接写入响应流。
如何从服务器现有路径加载文件进行下载
若文件已存在于服务器磁盘，可将 force_download() 的第二个参数设为文件绝对路径。函数会自动读取文件内容并发送，无需手动使用 file_get_contents()。此方法适用于大文件，但需注意内存限制，因为CodeIgniter默认会将整个文件读入内存再发送。
$file_path = FCPATH . 'uploads/document.pdf';
if (file_exists($file_path)) {
force_download($file_path, NULL);
} else {
show_error('File not found');
}
当 $file_path 指向有效文件时，force_download 会识别路径并自动处理MIME类型检测（若未指定）。若第二个参数为 NULL 且第一个参数是路径，则直接使用路径作为文件名。若文件不存在，需自行处理错误逻辑，避免发送空内容。
下载过程中如何处理权限错误或文件缺失
在使用路径模式下载时，必须验证文件存在性及可读性。若文件被删除或权限不足，force_download 可能抛出警告或发送损坏数据。应在调用前使用 file_exists() 和 is_readable() 进行检查，并结合 show_error() 返回标准404页面。
$file_path = '/var/www/data/secret.docx';
if (!file_exists($file_path)) {
show_error('The requested file does not exist.', 404);
}
if (!is_readable($file_path)) {
show_error('The requested file is not readable.', 403);
}
force_download($file_path, NULL);
此段代码确保了只有合法且可读的文件才会触发下载流程。若检查失败，用户将看到标准的CodeIgniter错误页面，而非空的下载响应。这有助于防止信息泄露和无效请求。
