Composer 安装 php-vcard-parser 需指定 GitHub 仓库地址并使用 dev-master 版本；解析 vcf 文件需先检测编码并转 UTF-8；提取字段应遍历 VCardProperty 并忽略大小写匹配 TYPE；批量解析须分块处理以防内存溢出。
Composer 安装 php-vcard-parser 时提示找不到包
这个库没有发布到 Packagist 官方源，直接 composer require php-vcard-parser/php-vcard-parser 会失败，报错 Could not find package php-vcard-parser/php-vcard-parser。它只托管在 GitHub，必须手动指定仓库地址。
正确做法是：在项目根目录执行
composer require php-vcard-parser/php-vcard-parser:dev-master --repository-url=https://api.github.com/repos/marcus1002/php-vcard-parser
注意三点：
-
dev-master是必需的，因为作者没打正式 tag，用^1.0或*都会失败 -
--repository-url必须带，且 URL 要和 GitHub 仓库实际 API 地址一致（不是网页地址） - 如果项目已启用
minimum-stability: stable，需临时加--stability-flags=php-vcard-parser/php-vcard-parser:dev，否则 Composer 拒绝安装 dev 分支
解析手机导出的 .vcf 文件时中文乱码或字段为空
Android 和 iPhone 导出的 vCard 多为 UTF-8 编码，但部分国产厂商（如华为、小米）默认用 GBK/GB2312，而 VCardParser 默认按 UTF-8 解析，导致乱码或 parse() 返回空数组。
立即学习“PHP免费学习笔记（深入）”；
解决方法是先检测并转码：
$raw = file_get_contents('contacts.vcf');
$encoding = mb_detect_encoding($raw, ['UTF-8', 'GBK', 'BIG5'], true);
if ($encoding !== 'UTF-8') {
$raw = mb_convert_encoding($raw, 'UTF-8', $encoding);
}
$parser = new \VCardParser\VCardParser();
$result = $parser->parse($raw);
关键点：
- 别依赖
file_get_contents自动识别编码——它不会做字符集探测 -
mb_detect_encoding()第三个参数设为true才能强制返回最可能的编码，否则可能返回false - 某些 vCard 含 BOM 头（如 UTF-8-BOM），
mb_convert_encoding能自动处理；但若手动 strip BOM，反而可能破坏结构
从解析结果提取手机号、邮箱等字段时取不到值
vCard 标准版本差异大（2.1 / 3.0 / 4.0），字段写法不统一。比如手机号在 vCard 3.0 中是 TEL;TYPE=CELL:，而 4.0 改为 TEL;TYPE="cell":（带引号），VCardParser 对 4.0 支持有限，getCellPhone() 可能返回 null。
更可靠的方式是遍历原始属性：
$vcard = $result[0]; // 假设只有一个联系人
foreach ($vcard->getProperties() as $prop) {
if ($prop->getName() === 'TEL') {
$type = $prop->getParam('TYPE');
if (stripos($type, 'cell') !== false || stripos($type, 'mobile') !== false) {
$phone = $prop->getValue();
break;
}
}
}
注意：
-
getProperties()返回的是VCardProperty对象数组，不是关联键值对 -
getParam('TYPE')返回字符串（如"CELL"或"cell"），大小写不敏感，要用stripos - 部分 vCard 把多个号码写在同一行用分号隔开（
TEL;TYPE=HOME,WORK:+8613800138000;+8613900139000），getValue()返回完整字符串，需额外用explode(';', ...)拆分
批量解析大量 .vcf 文件时内存溢出
该库会把整个 vCard 内容加载进内存再解析，单个 1MB 的 vcf 文件就可能占用 3–4MB PHP 内存。如果一次读 100 个文件，很容易触发 Allowed memory size exhausted。
规避方式只有两个：
- 用
ini_set('memory_limit', '256M')临时调高限制（仅限 CLI 环境，Web 环境不推荐） - 改用逐块读取 + 流式解析：先用
fopen()读取文件，按BEGIN:VCARD/END:VCARD分割块，每次只传一个 vCard 块给$parser->parse()，避免一次性加载全部内容
真正麻烦的不是代码量，而是 vCard 行折叠规则（每行最多 75 字符，续行以空格开头）——VCardParser 内部已处理，但你自己分割时必须先还原折叠行，否则解析失败。这点容易被忽略。
