i4e/php-whmcs-api

php whmcs api client

dev-main 2022-01-10 20:22 UTC

Requires

• php: ^7.4|^8.0
• ext-json: *
• php-http/client-common: ^2.3
• php-http/discovery: ^1.13
• php-http/httplug: ^2.2
• psr/http-client-implementation: ^1.0
• psr/http-factory-implementation: ^1.0
• psr/http-message: ^1.0
• symfony/options-resolver: ^5.0 || ^7.0

Requires (Dev)

• guzzlehttp/guzzle: ^7.0
• http-interop/http-factory-guzzle: ^1.0
• phpstan/phpstan: ^1.3
• phpunit/phpunit: ^8.5.14 || ^9.5.1

MIT

• i4E

README

Simple and PSR7 compatible WHMCS API Client

Installation

Composer

$ composer require "i4e/php-whmcs-api" "guzzlehttp/guzzle:^7.2" "http-interop/http-factory-guzzle:^1.0"

System Requirements

This package requires:

• PHP ^7.4 | ^8.0
• PHP extensions curl, json and mbstring

Usage

Initialize Client

Basic initialisation of the Client.

<?php
require_once __DIR__ . '/vendor/autoload.php';

$client = new \i4e\WhmcsApi\Client();
// Auth Credentials with identifier and secret
$client->authenticate('your_identifier', 'your_secret', \i4e\WhmcsApi\Client::AUTH_API_CREDENTIALS);
// Login Credentials with Username and Password (without md5)
$client->authenticate('your_username', 'your_password', \i4e\WhmcsApi\Client::AUTH_LOGIN_CREDENTIALS);
$client->url('http://<your_whmcs_instance_url>');

Examples

Get clients

$client->client()->getClients(['search' => 'firstname']);

Get all orders

$client->orders()->getOrders();

Call custom API Route

If your WHMCS instance contains custom API routes, you can also call them without extending the code.

$parameters = ['foo' => 'bar'];
$client->custom()->yourCustomApiName($parameters);

Disclaimer

If you are using this client, please refer to the documentation on the WHMCS Developer page. The documentation of the API is very incomplete in some places and in some cases questionably documented.

License

This package is released under the MIT License.