PHP使用PHPMailer发iCal至Outlook时描述字段被覆盖问题求助

在PHP环境中使用PHPMailer向Outlook发送iCal邀请时，邀请能正常发送，其他功能也没问题，但VEVENT中的DESCRIPTION字段会被Outlook替换为邮件的Body内容，这个问题在Google Calendar中不会出现。

生成iCal的PHP代码 #

// My ical code look like this
$ical = 'BEGIN:VCALENDAR' . "\r\n" .
    'PRODID:test' . "\r\n" .
    'VERSION:2.0' . "\r\n" .
    'CALSCALE:GREGORIAN' . "\r\n" .
    'METHOD:REQUEST' . "\r\n" .
    'BEGIN:VEVENT' . "\r\n" .
    'DTSTAMP:'.$date_created."\r\n" .
    'CREATED:' . $date_created .  "\r\n" .
    'LAST-MODIFIED:' . $date_modified .  "\r\n" .
    'DTSTART:' . $date_start . "\r\n" .
    'DTEND:' . $date_end . "\r\n" .
    'DESCRIPTION: I am a comment, hello!' . "\r\n" .
    'ORGANIZER;CN=' . $from . ':mailto:' . $from_mail .  "\r\n" .
    'UID:' . $uid . "\r\n" .
    'ATTENDEE;CUTYPE=INDIVIDUAL;RSVP=FALSE;CN=' . $user_name . ';X-NUM-GUESTS=0:mailto:' . $user_mail . "\r\n" .
    'LOCATION: test street'.  "\r\n" .
    'SEQUENCE:0'. "\r\n" .
    'STATUS:CONFIRMED' .   "\r\n" .
    'SUMMARY:Hello I am a title' . "\r\n" .
    'TRANSP:OPAQUE' . "\r\n" .
    'CLASS:PUBLIC' . "\r\n" .
    'PRIORITY:5' . "\r\n" .
    'BEGIN:VALARM' . "\r\n" .
    'DESCRIPTION:I am a comment, hello!'  . "\r\n" .
    'TRIGGER;RELATED=START:-PT15M' . "\r\n" .
    'ACTION:DISPLAY' . "\r\n" .
    'END:VALARM' . "\r\n" .
    'END:VEVENT' . "\r\n" .
    'TZID:Europe/Paris' . "\r\n" .
    'END:VCALENDAR';

// then send with something like this
$mail = new PHPMailer();
$mail->setMailerForSystem();
$mail->From     = $mail_user;
$mail->FromName = $name_user;
$mail->Subject  = $subject;
$mail->IsHTML(true);
$mail->Body    = $html_body;
$mail->AltBody = $alt_body;
$mail->Ical = $ical;
$mailer->AddStringAttachment($ical, "Invit", "7bit", "text/calendar; charset=utf-8;");
$mail->Send();

最终生成的Invit文件内容 #

BEGIN:VCALENDAR
PRODID:test
VERSION:2.0
CALSCALE:GREGORIAN
METHOD:REQUEST
BEGIN:VEVENT
DTSTAMP:20230707T093555Z
CREATED:20230707T093555Z
LAST-MODIFIED:20230707T093555Z
DTSTART:20230708T073900
DTEND:20230708T080900
DESCRIPTION:I am a comment, hello!
ORGANIZER;CN=test test:mailto:mymail@outlook.test
UID:test2-uid
ATTENDEE;CUTYPE=INDIVIDUAL;RSVP=FALSE;CN=testr testr;X-NUM-GUESTS=0:mailto:yourmail@outlook.test
LOCATION: test street
SEQUENCE:0
STATUS:CONFIRMED
SUMMARY:Hello I am a title
TRANSP:OPAQUE
CLASS:PUBLIC
PRIORITY:5
BEGIN:VALARM
DESCRIPTION:I am a comment, hello!
TRIGGER;RELATED=START:-PT15M
ACTION:DISPLAY
END:VALARM
END:VEVENT
TZID:Europe/Paris
END:VCALENDAR

解决思路 #

• 移除重复的iCal添加方式：当前代码同时用了$mail->Ical和AddStringAttachment添加iCal内容，Outlook可能优先识别邮件关联的iCal数据而非附件，建议只保留$mail->Ical = $ical这一行，删除附件添加代码。
• 修正Content-Type参数：如果坚持用附件方式，需要在Content-Type中添加method=REQUEST，改为：

  $mailer->AddStringAttachment($ical, "Invit", "7bit", "text/calendar; charset=utf-8; method=REQUEST");
  

• 规范DESCRIPTION字段格式：Outlook对iCal字段的换行和特殊字符处理严格，若DESCRIPTION有多行，需用折叠换行（每行不超过75字符，换行前加空格），或者将换行符转义为\\n。例如：

  DESCRIPTION:I am a comment, hello!\\nThis is a new line
  

• 补全时区定义：当前iCal仅添加了TZID:Europe/Paris，缺少完整的VTIMEZONE块，Outlook可能因时区解析异常覆盖字段。需要添加标准的时区定义，比如：

  BEGIN:VTIMEZONE
  TZID:Europe/Paris
  BEGIN:STANDARD
  DTSTART:19701025T030000
  TZOFFSETFROM:+0200
  TZOFFSETTO:+0100
  RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU
  END:STANDARD
  BEGIN:DAYLIGHT
  DTSTART:19700329T020000
  TZOFFSETFROM:+0100
  TZOFFSETTO:+0200
  RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU
  END:DAYLIGHT
  END:VTIMEZONE
  

• 简化邮件Body内容：尝试将邮件Body改为无关联的简单文本（比如"请查收日历邀请"），测试是否还会替换DESCRIPTION，排除内容相似导致的自动替换。

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