本文档旨在指导开发者如何使用 PHPSpreadsheet 库在 XAMPP 服务器上自动生成并保存 XLSX 文件，尤其是在 WordPress 环境下通过 Cron Jobs 实现定时导出数据并保存为 XLSX 文件的场景。文章将详细介绍如何修改代码，避免直接输出到浏览器，而是将文件保存到服务器指定目录。
在 WordPress 中使用 PHPSpreadsheet 创建 XLSX 文件并保存到服务器，而不是强制用户下载，需要修改代码逻辑，将文件直接写入服务器的文件系统。以下是详细步骤和代码示例：
1. 修改 PHP 代码
不再使用 php://output，而是指定一个服务器上的文件路径来保存 XLSX 文件。
立即学习“PHP免费学习笔记（深入）”；
<?php
require 'vendor/autoload.php'; // 确保已引入 Composer 的自动加载
use PhpOffice\PhpSpreadsheet\Spreadsheet;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
// 创建 Spreadsheet 对象 (示例)
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'Hello World !');
// 设置保存路径
$upload_dir = wp_upload_dir();
$target_path = $upload_dir['basedir'] . '/export/';
// 确保目录存在，如果不存在则创建
if (!is_dir($target_path)) {
mkdir($target_path, 0777, true);
}
$filename = 'my_excel_file_' . date('YmdHis') . '.xlsx'; // 根据需要生成文件名
$filepath = $target_path . $filename;
// 使用 Xlsx Writer 将 Spreadsheet 对象写入文件
$writer = new Xlsx($spreadsheet);
try {
$writer->save($filepath);
$response = array(
'file_name' => $filename,
'op' => 'ok',
'file_path' => $filepath, // 返回文件路径，方便后续操作
);
} catch (Exception $e) {
$response = array(
'op' => 'error',
'message' => '保存文件失败: ' . $e->getMessage(),
);
}
// 返回 JSON 响应
header('Content-Type: application/json');
echo json_encode($response);
exit;
?>注意事项：
- 确保 vendor/autoload.php 路径正确，并且已经通过 Composer 安装了 PHPSpreadsheet 库。
- wp_upload_dir() 函数用于获取 WordPress 上传目录，确保在 WordPress 环境中使用。
- 根据实际情况调整 $target_path 变量，指定文件保存的目录。建议使用 WordPress 上传目录下的子目录，方便管理。
- mkdir($target_path, 0777, true); 用于创建目录，0777 是权限设置，根据服务器环境调整。true 参数表示递归创建目录。
- 错误处理部分非常重要，确保能够捕获文件保存过程中可能出现的异常。
2. 修改 JavaScript 代码
不再使用 data:application/vnd.ms-excel;base64,... 来触发下载，而是根据 PHP 返回的文件路径进行处理。
jQuery.ajax({
url: ajaxurl,
type: 'POST',
dataType: 'json',
data: {
form_data: detail_info,
action: 'frontend_action_without_file' // this is going to be used inside wordpress functions.php
},
error: function(error) {
console.error("Error:", error);
},
success: function(response) {
if (response.op === 'ok') {
console.log("File saved at:", response.file_path);
// 可以选择直接提供下载链接，或者执行其他操作
// 例如，创建一个链接并触发下载
var $a = jQuery("<a>");
$a.attr("href", response.file_path);
$a.attr("download", response.file_name); // 设置下载的文件名
jQuery("body").append($a);
$a[0].click();
$a.remove(); // 移除创建的链接
} else {
console.error("Error saving file:", response.message);
}
}
});注意事项：
- 确保 AJAX 请求能够正确地将数据发送到 PHP 处理程序。
- 在 success 回调函数中，根据 PHP 返回的 file_path 和 file_name 创建下载链接。
- $a.remove(); 用于移除创建的链接，避免在页面上留下多余的元素。
- 如果不需要立即下载，可以根据 file_path 进行其他操作，例如发送邮件通知用户文件已生成。
3. 配置 Cron Job
使用 Cron Job 定时执行 PHP 脚本，自动生成并保存 XLSX 文件。
* * * * * php /path/to/your/wordpress/wp-content/themes/your-theme/generate_excel.php >/dev/null 2>&1
说明：
- * * * * * 表示每分钟执行一次，可以根据需要修改。
- /path/to/your/wordpress/wp-content/themes/your-theme/generate_excel.php 是 PHP 脚本的完整路径。
- >/dev/null 2>&1 用于屏蔽 Cron Job 的输出，避免发送不必要的邮件。
建议：
- 使用绝对路径，避免相对路径导致的问题。
- 测试 Cron Job 配置，确保脚本能够按计划执行。
- 记录 Cron Job 的执行日志，方便排查问题。
4. 安全性考虑
- 文件权限： 确保保存文件的目录具有适当的权限，避免未经授权的访问。
- 输入验证： 对所有输入数据进行验证，防止恶意代码注入。
- 错误处理： 完善错误处理机制，避免敏感信息泄露。
总结
通过以上步骤，可以在 WordPress 中使用 PHPSpreadsheet 自动生成并保存 XLSX 文件到服务器，并通过 Cron Job 定时执行。关键在于修改 PHP 代码，将文件直接写入服务器的文件系统，而不是强制用户下载。同时，需要注意安全性，确保文件和数据的安全。
