README

ewshelper 是一个围绕 php-ews 的小型封装，它可以帮助您通过 PHP 管理您的 Exchange 联系人。
它可以处理非常大的列表，同时帮助您规范化联系人数据。

安装

使用 composer 一次性安装

composer require vielhuber/ewshelper

然后将其添加到您的文件中

require __DIR__ . '/vendor/autoload.php';
use vielhuber\ewshelper\ewshelper;
$ewshelper = new ewshelper('**host**', '**username**', '**password**');

用法

获取所有联系人

$ewshelper->getContacts();

通过 ID 获取联系人

$ewshelper->getContact('**id**');

规范化姓名和电话

$ewshelper->normalizeData();

删除重复项

$ewshelper->removeDuplicates();

添加新联系人

$ewshelper->addContact([
    'first_name' => 'Max',
    'last_name' => 'Mustermann',
    'company_name' => 'Musterfirma',
    'emails' => ['max@mustermann.de'],
    'phones' => ['private' => ['0123456789'], 'business' => ['9876543210']],
    'url' => 'https://www.mustermann.de',
    'categories' => ['test']
]);

更新联系人

$ewshelper->updateContact('**id**', [
    'first_name' => 'Max',
    'last_name' => 'Mustermann',
    'company_name' => 'Musterfirma',
    'emails' => ['max@mustermann.de'],
    'phones' => ['private' => ['0123456789'], 'business' => ['9876543210']],
    'url' => 'https://www.mustermann.de',
    'categories' => ['test']
]);

删除联系人

$ewshelper->removeContact('**id**');

同步联系人

以下辅助函数获取类别 test 中的所有 Exchange 联系人，
删除那些不在提供的数组中存在的联系人，并创建在 Exchange 中尚不存在的新联系人。

$ewshelper->syncContacts('test', [
    [
        'first_name' => 'Max',
        'last_name' => 'Mustermann',
        'company_name' => 'Musterfirma',
        'emails' => ['max@mustermann.de'],
        'phones' => ['private' => ['0123456789'], 'business' => ['9876543210']],
        'url' => 'https://www.mustermann.de',
        'categories' => ['test']
    ],
    [
        'first_name' => 'Erika',
        'last_name' => 'Mustermann',
        'company_name' => 'Musterfirma',
        'emails' => ['erika@mustermann.de'],
        'phones' => ['private' => ['0123456789'], 'business' => ['9876543210']],
        'url' => 'https://www.mustermann.de',
        'categories' => ['test']
    ]
]);

关于 Outlook 的注意事项

在删除电话号码或对现有联系人进行大量更改时，
建议使用 清除脱机项目 函数。