在开发与 xero api 集成的项目时，我遇到了不少挑战。特别是处理 oauth 认证和 orm 模型的复杂性让我头疼不已。最初，我尝试直接使用 xero api，但发现 oauth 流程的复杂性以及数据模型的处理需要大量的自定义代码，这不仅增加了开发时间，还容易出错。幸运的是，我发现了 calcinai/xero-php 库，它大大简化了这些问题。
calcinai/xero-php 是一个 PHP 库，旨在简化与 Xero API 的集成。它提供了一个更清晰的 OAuth 接口和 ORM 样式的抽象，使得与 Xero 的交互变得更加直观和高效。使用 Composer 安装该库非常简单：
composer require calcinai/xero-php
首先，让我们看看如何使用这个库进行 OAuth 2.0 授权流程。这是一个关键步骤，因为它允许你的应用程序访问 Xero 的组织数据。以下是一个简单的例子，展示如何使用 CalcinaiOAuth2ClientProviderXero 进行授权：
session_start(); $provider = new CalcinaiOAuth2ClientProviderXero([ 'clientId' => '{xero-client-id}', 'clientSecret' => '{xero-client-secret}', 'redirectUri' => 'https://example.com/callback-url', ]); if (!isset($_GET['code'])) { $authUrl = $provider->getAuthorizationUrl([ 'scope' => 'openid email profile accounting.transactions' ]); $_SESSION['oauth2state'] = $provider->getState(); header('Location: ' . $authUrl); exit; } elseif (empty($_GET['state']) || ($_GET['state'] !== $_SESSION['oauth2state'])) { unset($_SESSION['oauth2state']); exit('Invalid state'); } else { $token = $provider->getAccessToken('authorization_code', [ 'code' => $_GET['code'] ]); $identity = $provider->getResourceOwner($token); $tenants = $provider->getTenants($token); }
一旦获得访问令牌和租户 ID，你就可以创建 XeroPHPApplication 实例，并开始与 Xero API 进行交互。例如，加载联系人集合：
$xero = new XeroPHPApplication($accessToken, $tenantId); $contacts = $xero->load(XeroPHPModelsAccountingContact::class)->execute(); foreach ($contacts as $contact) { print_r($contact); }
这个库还支持保存资源、处理附件、生成 PDF 等功能。例如，创建并保存一个新的联系人：
立即学习“PHP免费学习笔记（深入）”；
$contact = new XeroPHPModelsAccountingContact($xero); $contact->setName('Test Contact') ->setFirstName('Test') ->setLastName('Contact') ->setEmailAddress('test@example.com'); $contact->save();
使用 calcinai/xero-php 库的优势在于它提供了一个更简洁的 API 接口，减少了处理 OAuth 认证和数据模型的复杂性。通过这个库，我能够更快地开发出与 Xero API 集成的功能，同时减少了错误的发生。
总的来说，calcinai/xero-php 库极大地提高了与 Xero API 集成的效率和可靠性。如果你正在开发一个需要与 Xero 集成的项目，强烈推荐使用这个库来简化你的开发流程。
