PHPOffice/PhpSpreadsheet中HTML输出时mailto超链接的解析问题

在PHPOffice/PhpSpreadsheet项目中，当使用HTML写入器输出包含mailto超链接的电子表格时，会遇到一个常见问题：单元格内容会被替换为mailto URL本身，而不是保留原始的超链接文本。

问题现象

当开发者在单元格中设置如下内容：

1. 单元格文本："Mail Me!"
2. 超链接地址："mailto:[e-mail]"

期望的HTML输出应该是：

<td class="column0 style0 s"><a href="mailto:[e-mail]" title="">Mail Me!</a></td>

但实际得到的却是：

<td class="column0 style0 s">mailto:[e-mail]</td>

问题根源

这个问题源于Html.php文件中的URL解析逻辑。在解析超链接时，代码会检查URL的协议类型，但当前实现只考虑了http、https、file、ftp和s3这几种协议，而忽略了mailto协议。

具体来说，问题出在这一行条件判断：

if ($parseScheme === 1 && !in_array($matches[1], ['http', 'https', 'file', 'ftp', 's3'], true)) {

解决方案

要解决这个问题，只需将mailto协议添加到允许的协议列表中：

if ($parseScheme === 1 && !in_array($matches[1], ['http', 'https', 'file', 'ftp', 's3', 'mailto'], true)) {

技术背景

在HTML输出过程中，PhpSpreadsheet会处理单元格中的各种数据类型和格式，包括超链接。对于超链接的处理，系统需要：

1. 解析URL的协议部分
2. 验证协议是否受支持
3. 根据协议类型决定如何生成HTML标签

mailto协议是RFC 6068标准定义的URI方案，专门用于创建指向电子邮件地址的链接。在Web开发中，mailto链接被广泛用于"联系我们"、"发送邮件"等功能。

影响范围

这个问题仅影响HTML格式的输出，其他输出格式如Excel、PDF等不受影响。该问题至少存在于1.28及更高版本中。

最佳实践

在使用PhpSpreadsheet生成包含电子邮件链接的HTML时，开发者应该：

1. 明确设置单元格的显示文本
2. 正确设置mailto超链接
3. 如果需要自定义输出，可以考虑继承Html写入器并重写相关方法

总结

这个问题的修复相对简单，但反映了在URL协议处理时需要全面考虑各种常见协议类型的重要性。对于类似的开源项目维护，建议：

1. 建立完整的协议支持列表
2. 为URI处理编写全面的测试用例
3. 考虑未来可能支持的其他协议类型

通过这样的改进，可以确保PhpSpreadsheet在各种使用场景下都能提供稳定可靠的HTML输出功能。