PHP Laravel邮件中实现iCalendar对应.ics文件点击下载的问题

失效原因 #

绝大多数主流邮件客户端（Gmail、Outlook、国内主流邮箱等）出于安全限制，默认屏蔽data:协议的URI跳转及下载行为，同时也不支持<a>标签的download属性，因此网页端可正常运行的内联data URI下载代码，放到邮件中就会失效。

调整方案 #

不需要修改你现有的ICS内容base64值，只需要新增一个公开路由用于返回ICS文件，再修改邮件内的按钮链接即可：

步骤1：新增ICS下载路由 #

在routes/web.php中添加如下代码：

use Illuminate\Support\Facades\Route;
use Illuminate\Http\Response;

Route::get('/download-calendar', function () {
    // 直接使用你现有代码中的ICS base64值解码
    $icsContent = base64_decode('QkVHSU46VkNBTEVOREFSDQpWRVJTSU9OOjIuMA0KQkVHSU46VkVWRU5UDQpVSUQ6ZWViODI5NGI0MjQzNWI3NDAwMDdjOGE0YzM5OGQ5NzkNClNVTU1BUlk6U2tpcHBlZCB0b3BpY3MgZnJvbSBsYXN0IHNlc3Npb24NCkRUU1RBUlQ7VFpJRD1BbWVyaWNhL05ld19Zb3JrOjIwMjEwOTE3VDEwMzAwMA0KRFRFTkQ7VFpJRD1BbWVyaWNhL05ld19Zb3JrOjIwMjEwOTE3VDExMzAwMA0KREVTQ1JJUFRJT046RGVzY3JpcHRpb24gRGVzY3JpcHRpb24gRGVzY3JpcHRpb24gRGVzY3JpcHRpb24gRGVzY3JpcHRpb24gRGVzY3JpcHRpb24gDQpFTkQ6VkVWRU5UDQpFTkQ6VkNBTEVOREFS');
    
    return response($icsContent, 200, [
        'Content-Type' => 'text/calendar; charset=utf-8',
        'Content-Disposition' => 'attachment; filename="Cal.ics"',
    ]);
})->name('download.calendar');

如果你的日历事件是动态生成的，可以给路由增加事件ID、用户ID等参数，对应输出不同的ICS内容即可。

步骤2：修改邮件内的按钮代码 #

邮件客户端对<button>标签的兼容性较差，推荐直接用行内样式给<a>标签模拟按钮效果，链接指向刚才新增的路由地址：

<a href="{{ route('download.calendar') }}" style="display:inline-block;padding:10px 16px;background-color:#2d3748;color:#ffffff;text-decoration:none;border-radius:4px;">
  iCalendar
</a>

调整后用户在邮件内点击按钮，会跳转到浏览器直接下载ICS文件，所有主流邮件客户端都支持该逻辑。

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