php 8.6导入vcf联系人时,可以用sabre/vobject读取单张vcard,先校验文档,再分别遍历tel和email。一个联系人可能有多个电话和邮箱,只读取第一个属性会丢失信息;显示姓名等字段也应作为普通文本输出。

官方文档:vCard解析与属性读取
安装并确认输入类型
composer require sabre/vobject:^5.0 composer check-platform-reqs
以下示例接收单张vCard文件。包含多张联系人的导出文件需要先使用库提供的拆分读取方式,不能把所有BEGIN:VCARD拼成一个联系人。

官方文档:遍历多个联系方式
读取姓名与多值联系方式
<?php
require __DIR__ . '/vendor/autoload.php';
use Sabre\VObject\Reader;
use Sabre\VObject\Component\VCard;
$file = __DIR__ . '/contact.vcf';
if (!is_file($file) || filesize($file) > 1024 * 1024) {
throw new RuntimeException('VCF文件不存在或过大');
}
$card = Reader::read(file_get_contents($file));
if (!$card instanceof VCard) {
throw new RuntimeException('需要单张vCard');
}
foreach ($card->validate() as $issue) {
if ($issue['level'] === 3) {
throw new RuntimeException($issue['message']);
}
}
$row = ['name' => (string) $card->FN, 'phones' => [], 'emails' => []];
foreach ($card->TEL as $tel) {
$row['phones'][] = ['value' => (string) $tel, 'type' => (string) $tel['TYPE']];
}
foreach ($card->EMAIL as $email) {
$row['emails'][] = (string) $email;
}
echo json_encode($row, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);TYPE用于描述家庭、工作或传真等用途,不能将它当成号码本身。结构化姓名N和地址ADR等由多个部分组成,应使用getParts()读取,而不是按逗号手工拆分。
保留原始语义再做业务归并
validate()的级别3表示文档无效,级别2是互操作警告,级别1表示此前问题已自动修复。示例不启用REPAIR,因此不会为了通过校验主动修改对象。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
号码规范化和联系人合并是后续业务规则:同名不一定是同一人,电话或邮箱也不等于账号已完成验证。导入前先预览变更,保存原始联系人标识,避免把多个联系方式覆盖成一个值。
立即学习“PHP免费学习笔记(深入)”;


















