PHP生成iCalendar文件时foreach添加多事件触发文件损坏报错

• 问题现象：单条事件导入日历完全正常，通过foreach循环批量生成多事件时触发解析报错Some events in the calendar file could not be added. The calendar file may be corrupt.
• 数据背景：数据库存储的日期字段格式为Y-m-d
• 报错界面参考：
• 原有实现代码：

<?php
require_once("zapcallib.php");
include('../dbcon/db.php');

$ical = "BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//[YOUR WEBSITE], Inc.//EN";

foreach($db->query("SELECT * FROM rezervasyondurumu where evid='1'") as $listele) {
  $baslangic= $listele['baslangic'];
  $bitis= $listele['bitis'];
  $ical .= "\nBEGIN:VEVENT";
  $ical .= "\nUID: ".$listele['aciklama'] ." fewofethiye.com";
  $ical .= "\nDTSTAMP:" . date('Ymd');
  $ical .= "\nORGANIZER:catalog@example.com";
  $ical .= "\nDTSTART:".date("Ymd", strtotime($baslangic));
  $ical .= "\nDTEND:".date("Ymd", strtotime($bitis));
  $ical .= "\nSUMMARY:".$listele['aciklama'];
  $ical .= "\nDESCRIPTION:" .$listele['aciklama'];
  $ical .= "\nEND:VEVENT";
}

$ical .= "\nEND:VCALENDAR";

header("Content-type: text/calendar; charset=utf-8");
header("Content-Disposition: inline; filename=calendar.ics");
echo $ical;
?>

核心异常诱因 #

• 行分隔符不符合规范：iCalendar（RFC5545）标准要求所有行必须使用\r\n作为分隔符，单条事件时解析器会做兼容判断可以正常识别，多事件拼接后累计的格式偏差就会触发解析失败。
• DTSTAMP字段格式错误：标准要求DTSTAMP必须是带时间的完整UTC时间格式（YYYYMMDDTHHMMSSZ），现有代码只输出年月日格式，不符合字段校验规则。
• UID存在重复风险：直接用文本说明字段拼接UID，若多条记录的说明内容一致，会生成完全重复的事件唯一标识，解析器判定文件结构异常。
• 文本字段未做特殊字符转义：如果说明字段包含逗号、分号、反斜杠等ICS保留字符，直接拼接会破坏文件的字段边界，导致后续事件解析错位。
• 异常日期无兜底处理：若数据库取出的日期值格式不合法，strtotime会返回false，后续生成的时间为1970年的无效值，对应事件无法通过校验。

修正后的参考代码 #

<?php
require_once("zapcallib.php");
include('../dbcon/db.php');

// 按规范使用\r\n作为全文档的行分隔符
$ical = "BEGIN:VCALENDAR\r\n
VERSION:2.0\r\n
PRODID:-//[YOUR WEBSITE], Inc.//EN";

foreach($db->query("SELECT * FROM rezervasyondurumu where evid='1'") as $listele) {
  $baslangic= $listele['baslangic'];
  $bitis= $listele['bitis'];

  // 跳过日期异常的无效记录
  $startTs = strtotime($baslangic);
  $endTs = strtotime($bitis);
  if ($startTs === false || $endTs === false) continue;

  // 生成全局唯一的事件UID，避免重复
  $eventUid = md5($listele['aciklama'] . $startTs . $endTs) . "@fewofethiye.com";
  // 转义文本字段中的ICS特殊字符
  $safeText = addcslashes($listele['aciklama'], ',;\\');

  $ical .= "\r\nBEGIN:VEVENT";
  $ical .= "\r\nUID:" . $eventUid;
  // 输出符合标准的UTC时间戳
  $ical .= "\r\nDTSTAMP:" . gmdate('Ymd\THis\Z');
  $ical .= "\r\nORGANIZER;CN=Catalog:mailto:catalog@example.com";
  // 全天事件明确标记VALUE=DATE类型，避免时间解析歧义
  $ical .= "\r\nDTSTART;VALUE=DATE:" . date("Ymd", $startTs);
  $ical .= "\r\nDTEND;VALUE=DATE:" . date("Ymd", $endTs);
  $ical .= "\r\nSUMMARY:" . $safeText;
  $ical .= "\r\nDESCRIPTION:" . $safeText;
  $ical .= "\r\nEND:VEVENT";
}

$ical .= "\r\nEND:VCALENDAR";

header("Content-type: text/calendar; charset=utf-8");
header("Content-Disposition: inline; filename=calendar.ics");
echo $ical;
?>

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