本教程详细介绍了如何将包含多个标题和开始日期的php数组数据有效地传递给fullcalendar 3日历组件。文章涵盖了两种主要方法：一是通过直接json编码将php数组注入到javascript配置中，适用于静态或少量事件；二是通过fullcalendar的json事件源机制，利用ajax动态加载事件，这是一种更灵活和推荐的解决方案，尤其适用于大型或动态更新的日历数据。教程提供了具体的代码示例和最佳实践建议，帮助开发者构建功能完善的日历应用。
在现代Web应用中，日历组件如FullCalendar广泛用于展示和管理事件。当数据来源于后端（例如PHP）时，如何将复杂的PHP数组结构转换为FullCalendar可识别的事件格式，是开发者常遇到的挑战。本教程将深入探讨如何高效地将包含多个事件的PHP数组传递给FullCalendar 3。
理解 FullCalendar 的事件数据格式
FullCalendar 3 要求事件数据是一个包含事件对象的数组。每个事件对象至少需要包含 title（事件标题）和 start（事件开始时间）属性。可选地，还可以包含 end（事件结束时间）、url（点击事件跳转链接）等。
例如，一个包含多个事件的JavaScript数组结构如下：
events: [
{
title: 'All Day Event',
start: '2021-12-02'
},
{
title: 'Long Event',
start: '2021-12-02',
end: '2021-12-04'
},
{
title: 'Click for Google',
url: 'https://google.com/',
start: '2021-12-24'
}
]因此，无论PHP数组最初是什么结构，最终都需要转换为这种“数组中包含关联数组（或对象）”的形式，以便FullCalendar能够正确解析。
立即学习“PHP免费学习笔记（深入）”；
方法一：直接通过 JSON 编码注入事件数据
对于事件数量不多或事件数据相对静态的场景，可以直接在PHP中构建符合FullCalendar要求的数组，然后将其JSON编码并直接注入到JavaScript代码中。
1. 构建符合 FullCalendar 格式的 PHP 数组
如果您的PHP数组是 ["2021-12-02" => "SG-12345-0 : xx, yy", ...] 这种键值对形式，其中键是日期，值是标题，您需要将其转换为一个包含多个关联数组的数组，每个关联数组代表一个事件。
原始 PHP 数组示例：
$arrayDate = [ "2021-12-02" => "SG-12345-0 : xx, yy", "2021-12-03" => "SG-156645-0 : aa, bb", "2021-12-02" => "SG-13435-0 : cc, dd", // 注意：键重复，实际应用中可能需要合并或处理 "2021-12-04" => "SG-76864-0 : ee, ff" ];
转换为 FullCalendar 兼容格式的 PHP 数组：
您需要遍历原始数组（如果它不是直接兼容的），并构建一个新的数组。
基于Intranet/Internet 的Web下的办公自动化系统，采用了当今最先进的PHP技术，是综合大量用户的需求,经过充分的用户论证的基础上开发出来的，独特的即时信息、短信、电子邮件系统、完善的工作流、数据库安全备份等功能使得信息在企业内部传递效率极大提高，信息传递过程中耗费降到最低。办公人员得以从繁杂的日常办公事务处理中解放出来，参与更多的富于思考性和创造性的工作。系统力求突出体系结构简明
"SG-12345-0 : xx, yy",
"2021-12-03" => "SG-156645-0 : aa, bb",
"2021-12-02" => "SG-13435-0 : cc, dd",
"2021-12-04" => "SG-76864-0 : ee, ff"
];
$eventsForFullCalendar = [];
foreach ($rawEvents as $date => $title) {
// 确保日期是唯一的，或者根据业务逻辑处理重复日期
// 此处简单添加，如果日期重复，FullCalendar会显示多个事件
$eventsForFullCalendar[] = [
"start" => $date,
"title" => $title
];
}
// 如果PHP数组已经是这种格式，则无需额外转换：
$arrayDate = [
["start" => "2021-12-02", "title" => "SG-12345-0 : xx, yy"],
["start" => "2021-12-03", "title" => "SG-156645-0 : aa, bb"],
["start" => "2021-12-02", "title" => "SG-13435-0 : cc, dd"],
["start" => "2021-12-04", "title" => "SG-76864-0 : ee, ff"]
];
?>2. 将 PHP 数组 JSON 编码并注入 JavaScript
使用 json_encode() 函数将PHP数组转换为JSON字符串，然后直接在FullCalendar的 events 配置项中输出。
FullCalendar PHP Events
注意事项：
- 这种方法适用于事件数量较少的情况。如果事件数据量大，直接将大量JSON注入HTML会增加页面加载时间。
- 确保 json_encode() 的输出是有效的JSON，且没有未转义的特殊字符，否则可能导致JavaScript错误。
方法二：使用 FullCalendar JSON 事件源（推荐）
对于动态事件、大量事件或需要根据用户操作（如切换月份）加载不同事件的场景，FullCalendar的JSON事件源机制是更优的选择。这种方法通过AJAX请求动态获取事件数据，提高了性能和灵活性。
1. 配置 FullCalendar 使用事件源 URL
在FullCalendar的配置中，不再直接提供 events 数组，而是指定一个URL，FullCalendar将向该URL发起AJAX请求以获取事件数据。
当FullCalendar需要事件数据时（例如初始化、切换月份、日期范围改变），它会自动向 get-events.php 发送一个AJAX请求。这个请求会包含 start 和 end 参数（ISO 8601格式），表示FullCalendar当前视图的开始和结束日期。
2. 创建 PHP 后端脚本 (get-events.php)
这个PHP脚本负责接收FullCalendar发送的请求，根据 start 和 end 参数从数据库或其他数据源查询相关事件，然后将事件数据以JSON格式返回。
"2021-12-01", "title" => "项目启动会"],
["start" => "2021-12-02", "title" => "SG-12345-0 : xx, yy"],
["start" => "2021-12-03", "title" => "SG-156645-0 : aa, bb"],
["start" => "2021-12-02", "title" => "SG-13435-0 : cc, dd"],
["start" => "2021-12-04", "title" => "SG-76864-0 : ee, ff"],
["start" => "2021-12-10", "title" => "产品发布会", "end" => "2021-12-12"],
["start" => "2021-12-25", "title" => "圣诞节派对"],
];
$filteredEvents = [];
foreach ($allEvents as $event) {
// 简单的日期过滤逻辑
// 实际应用中，应使用更健壮的日期比较方法，例如将日期转换为时间戳或DateTime对象
if ($event['start'] >= $start_date && $event['start'] <= $end_date) {
$filteredEvents[] = $event;
} elseif (isset($event['end']) && $event['end'] >= $start_date && $event['start'] <= $end_date) {
// 考虑跨越事件的过滤
$filteredEvents[] = $event;
}
}
// 将过滤后的事件数据 JSON 编码并输出
echo json_encode($filteredEvents);
?>注意事项：
- 安全性： 在实际应用中，务必对从 $_GET 或 $_POST 获取的参数进行严格的输入验证和过滤，以防止SQL注入等安全漏洞。
- 性能： 确保数据库查询是高效的，尤其是在处理大量事件数据时。
- 错误处理： PHP脚本应处理查询失败、数据格式错误等情况，并返回适当的HTTP状态码或错误信息，以便前端进行处理。
- 跨域： 如果FullCalendar页面和PHP事件源脚本不在同一个域，需要处理CORS（跨域资源共享）问题。
总结
将PHP数组传递给FullCalendar 3主要有两种策略：直接JSON编码注入和使用JSON事件源。直接注入适用于小型、静态数据集，而JSON事件源则是处理动态、大量事件数据的推荐方法，它提供了更好的性能、可扩展性和用户体验。在选择方法时，请根据您的项目需求和数据特性进行权衡。无论哪种方法，核心都是将PHP数据转换为FullCalendar所期望的事件对象数组格式。
