README

支持Laravel的PHP Caspeco API库。

安装

使用Composer在项目的根目录中要求此软件包。

composer require hoy/caspeco

使用Laravel？

将服务提供者添加到 config/app.php 中的 providers 数组。

Hoy\Caspeco\CaspecoServiceProvider::class

如果您想使用 facade，可以在 config/app.php 中添加对您的别名的引用。

'Caspeco' => Hoy\Caspeco\Facades\Caspeco::class

配置

Caspeco需要连接配置。要开始，您需要发布所有供应商资产

php artisan vendor:publish

这将在您的应用中创建一个 config/caspeco.php 文件，您可以修改它以设置配置。同时，请确保检查此软件包中原始配置文件在发布之间的更改。

默认连接名称

此选项 default 是您可能指定要使用以下哪个连接作为所有工作的默认连接的地方。当然，您可以使用多个连接同时使用管理器类。此设置的默认值为 main。

Caspeco连接

此选项 connections 是为您的应用程序设置每个连接的地方。示例配置已包含在内，但您可以根据需要添加任意数量的连接。

使用

CaspecoManager

这是最感兴趣的类。它绑定到ioc容器上的 caspeco，并且可以通过 Facades\Caspeco facade来访问。该类通过扩展AbstractManager实现ManagerInterface。该接口和抽象类都是Graham Campbell的Graham Campbell的Laravel Manager软件包的一部分，因此您可能想查看该存储库中的文档以了解如何使用管理器类。注意，返回的连接类将始终是 Hoy\Caspeco\Caspeco 的实例。

Facades\Caspeco

此外观将动态将静态方法调用传递到ioc容器中的 caspeco 对象，默认情况下是 CaspecoManager 类。

CaspecoServiceProvider

此类没有有趣的公共方法。应将此类添加到 config/app.php 中的提供者数组。此类将设置ioc绑定。

示例

在这里，您可以看到这个包有多么简单易用。默认情况下，适配器为 main。在配置文件中输入您的认证信息后，它将直接工作

// You can alias this in config/app.php.
use Hoy\Caspeco\Facades\Caspeco;

Caspeco::charges()->find($id);
// We're done here - how easy was that, it just works!

Caspeco::charges()->capture($id);
// This example is simple and there are far more methods available.

Caspeco 管理器会表现得像 Hoy\Caspeco\Caspeco。如果您想调用特定的连接，可以使用连接方法实现

use Hoy\Caspeco\Facades\Caspeco;

// Writing this…
Caspeco::connection('main')->customers()->find($id);

// …is identical to writing this
Caspeco::customers()->find($id);

// and is also identical to writing this.
Caspeco::connection()->customers()->find($id);

// This is because the main connection is configured to be the default.
Caspeco::getDefaultConnection(); // This will return main.

// We can change the default connection.
Caspeco::setDefaultConnection('alternative'); // The default is now alternative.

如果您像我一样喜欢使用依赖注入而不是外观（facade），则可以注入管理器

use Hoy\Caspeco\CaspecoManager;

class Foo
{
	protected $caspeco;

	public function __construct(CaspecoManager $caspeco)
	{
		$this->caspeco = $caspeco;
	}

	public function bar($id)
	{
		$this->caspeco->customers()->find($id);
	}
}

App::make('Foo')->bar();

文档

此包中还有一些未在此处记录的方法。相反，请参阅 Caspeco 的文档。如果您有任何疑问，请毫不犹豫地提出问题。

许可

Caspeco 遵循 MIT 许可协议 (MIT)。