php 8.6导出可导入日历的单次日程时,应生成完整vcalendar和vevent结构,使用稳定uid、utc起止时间及crlf行结束,并对文本值转义、按75字节上限折行。折行必须保留utf-8字符完整,不能按75个中文字符计算。

PHP手册中的PHP: mb_strcut - Manual
先实现文本编码和内容行折叠
<?php
function icsText(string $text):string {
if (!mb_check_encoding($text,'UTF-8')) {
throw new InvalidArgumentException('需要UTF-8文本');
}
return strtr($text,["\"=>"\\","
"=>"\n","
"=>"\n",
"
"=>"\n",","=>"\,",";"=>"\;"]);
}
function foldIcs(string $line):string {
$parts=[]; $first=true;
while (strlen($line)>($first?75:74)) {
$take=mb_strcut($line,0,$first?75:74,'UTF-8');
if ($take==='') throw new RuntimeException('无法折行');
$parts[]=($first?'':' ').$take;
$line=substr($line,strlen($take)); $first=false;
}
$parts[]=($first?'':' ').$line;
return implode("
",$parts);
}
$utc=new DateTimeZone('UTC');
$start=new DateTimeImmutable('2026-11-25 02:00:00',$utc);
$end=new DateTimeImmutable('2026-11-25 03:00:00',$utc);
if ($end<=$start) throw new InvalidArgumentException('结束须晚于开始');
$format='YmdTHisZ';
$lines=['BEGIN:VCALENDAR','VERSION:2.0','PRODID:-//Example//Calendar Export//ZH',
'BEGIN:VEVENT','UID:demo-20261125-001@example.invalid',
'DTSTAMP:'.(new DateTimeImmutable('now',$utc))->format($format),
'DTSTART:'.$start->format($format),'DTEND:'.$end->format($format),
'SUMMARY:'.icsText('PHP项目例会'),
'DESCRIPTION:'.icsText("讨论升级计划;确认负责人
保留测试记录"),
'END:VEVENT','END:VCALENDAR'];
header('Content-Type: text/calendar; charset=UTF-8');
header('Content-Disposition: attachment; filename="event.ics"');
echo implode("
",array_map('foldIcs',$lines))."
";
PHP手册中的PHP: DateTimeInterface::format - Manual
UID与时间字段保持实际含义
示例UID仅用于演示,真实事件首次创建时分配并持久保存,重复导出同一事件要复用。DTSTAMP记录生成或修订时间,DTEND为非包含结束;全部采用UTC并带Z,不需要额外伪造TZID定义。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
检查字节和导入结果
依赖mbstring,续行起始的空格本身占1字节,因此后续片段预算是74字节。检查每个物理行不超过75字节、中文未截断,并在目标日历软件中检查起止与描述换行;本例不包含循环规则、提醒或会议邀请流程。


















