README

Laravel中与WHMCS API交互的接口。

安装

通过Composer安装包。在终端运行Composer require命令

composer require presttec/laravel-whmcs

包将通过Composer包发现自动安装。如果没有，则需要将PrestTEC\Whmcs\WhmcsService服务提供者在您的config/app.php中注册。

可选地，您可以添加别名，如果您更喜欢使用外观

'Whmcs' => PrestTEC\Whmcs\Facades\Whmcs::class

配置

要开始，您需要发布所有供应商资源。

php artisan vendor:publish --provider=PrestTEC\Whmcs\WhmcsServiceProvider

然后打开config\whmcs.php以填写您的WHMCS API凭据

现在您可以在Laravel项目中使用WHMCS API。

Lumen

将包中的配置文件复制到您项目的配置目录

cp vendor/presttec/laravel-whmcs/config/whmcs.php config/whmcs.php

然后打开config\whmcs.php以填写您的WHMCS API凭据。

完成此操作后，在bootstrap/app.php中注册配置文件和服务提供者

$app->configure('whmcs');
$app->register(PrestTEC\Whmcs\WhmcsServiceProvider::class);

现在您可以在Lumen项目中使用WHMCS API。

基本用法

您可以通过调用\WHMCS::{WHMCSAPIFUNCTION}外观直接调用您的WHMCS API。

如果您更喜欢依赖注入，可以像这样注入管理器

use PrestTEC\Whmcs\WhmcsManager;

class WhmcsController extends Controller
{
    private $whmcsManager;

    public function __construct(WhmcsManager $whmcsManager)
    {
        $this->whmcsManager = $whmcsManager;
    }

    public function index()
    {
        $this->whmcsManager->execute('GetInvoice', ['invoiceid' => '1337']);
    }
}

提示：执行命令也将支持您自己创建的WHMCS API命令。

示例

获取客户购买的产品列表

\Whmcs::GetClientsProducts([
    'clientid' => '12345'
]);

检索特定发票

\Whmcs::GetInvoice([
    'invoiceid' => '1337'
]);

支持

请在github上创建问题

许可证

此包根据MIT许可证发布。有关详细信息，请参阅捆绑的LICENSE文件。

为Laravel Whmcs做贡献

如果您发现错误或想要为Laravel Whmcs添加功能，太好了！为了使我能够更快地验证和合并更改，如果您能遵循以下几个基本步骤，那将是极好的

1. 叉项目。
2. 在新的分支中分离出来。 git checkout -b name_of_new_feature_or_bug
3. 制作您的功能添加或错误修复。
4. 为它添加测试。这很重要，这样我就不会无意中在未来版本中破坏它。
5. 提交。
6. 向我发送拉取请求！