latheesan-k/laravel-xero

Laravel 4 的 Xero 服务提供商

dev-master 2014-12-04 17:37 UTC

This package is not auto-updated.

Last update: 2024-10-02 07:42:49 UTC


README

最初是从 https://github.com/VentureCraft/xero-laravel 分支出来的,并更新以支持更新的 API 功能(例如 ContactGroups 和分页结果等...)。

一个简单的 Laravel 4 服务提供商,用于集成 PHP Xero API

安装

可以通过 Composer 安装 Xero 服务提供商,通过在您的项目 composer.json 文件中指定 latheesan-k/laravel-xero 包并设置 minimum-stabilitydev 来实现。

{
	"require": {
		"laravel/framework": "4.0.*",
		"latheesan-k/laravel-xero": "dev-master"
	},
	"minimum-stability": "dev"
}

使用方法

要使用 Xero 服务提供商,您必须在启动 Laravel 应用程序时注册该提供程序。

使用 Laravel 配置

创建一个包含以下选项的新的 app/config/xero.php 配置文件

return array(
    'key'           => '<your-xero-key>',
    'secret'        => '<your-xero-secret>',
    'publicPath'    => app_path() .'/config/xero/publickey.cer',
    'privatePath'   => app_path() .'/config/xero/privatekey.pem'
);

app/config/app.php 中找到 providers 键并注册 Xero 服务提供商。

    'providers' => array(
        // ...
        'Latheesan\LaravelXero\LaravelXeroServiceProvider',
    )

app/config/app.php 中找到 aliases 键并添加我们的 LaravelXero 别名。

    'aliases' => array(
        // ...
        'LaravelXero' 	  => 'Latheesan\LaravelXero\Facades\LaravelXero',
    )

设置应用程序

创建公钥和私钥,并将它们保存到 /app/config/xero/ 作为 publickey.cer 和 privatekey.pem。

有关设置密钥的更多信息,请参阅 Xero 文档

示例用法

在 Xero 中创建联系人

$contact = array(
    array(
       	"Name"        => 'Company Name Ltd',
       	"FirstName"   => 'John',
		"LastName"    => 'Doe',
	)
);

$xero_contact = LaravelXero::Contacts($contact);

带有 WHERE 子句和分页的 GET Contacts

$where = "ContactNumber!=null&IsCustomer=true";
$page  = 1;

print_r(LaravelXero::Contacts(false, false, $where, false, $page));

参考