Frame PHP SDK

This is a lightweight PHP SDK for the Frame payment gateway. It uses Guzzle for making API requests and returns the responses as an array/object by default. The SDK communicates with the https://api.framepayments.com endpoint.

Installation

To install the SDK, add the following to your composer.json file:

"require": {
    "frame-payments/frame-php-sdk": "^1.0"
}

Then run composer install to add the SDK to your project.

Usage

First, set your API key using the setApiKey method in the Auth class:

use Frame\Auth;

Auth::setApiKey('YOUR_API_KEY');

After setting the API key, you can use the Client class to make requests to the Frame API. The Client class has four methods: create, get, update, and delete. Each of these methods takes two parameters: the endpoint and an optional body.

Here are some examples:

use Frame\Client;

$create = Client::create('charges', [] /* body can be placed here */);

$get = Client::get('charges', [] /* body can be placed here */);

$update = Client::update('charges', [] /* body can be placed here */);

$delete = Client::delete('charges', [] /* body can be placed here */);

By default, the response from these methods will be an object. If you want to get the response as an array, you can use the toArray method.

$response = Frame\Client::get('charges');
$arrayResponse = $response->toArray();

Error Handling

This SDK uses exceptions for error handling. If an error occurs during a request, an Exception will be thrown. You can catch these exceptions to handle errors in your application.

try {
    $response = Frame\Client::get('charges');
} catch (Frame\Exception $e) {
    echo 'Error: ' . $e->getMessage();
}

Helpers

The SDK also includes a Helpers class with useful methods. For example, you can use the convertAlpha2ToAlpha3 method to convert a country code from ISO 3166-1 alpha-2 to ISO 3166-1 alpha-3.

$alpha3 = Frame\Helpers::convertAlpha2ToAlpha3('US');

Testing

The SDK includes a comprehensive test suite using PHPUnit. To run the tests:

Prerequisites

• PHP 8.1 or higher
• Composer
• Docker (for containerized testing)

Running Tests

Option 1: Using Docker (Recommended)

# Build the test image
docker build -t frame-php-sdk-tests .

# Run all tests
docker run --rm frame-php-sdk-tests ./vendor/bin/phpunit

# Run tests with pretty output
docker run --rm frame-php-sdk-tests ./vendor/bin/phpunit --testdox

# Run specific test suites
docker run --rm frame-php-sdk-tests ./vendor/bin/phpunit tests/Unit/
docker run --rm frame-php-sdk-tests ./vendor/bin/phpunit tests/Integration/

Option 2: Local PHP/Composer

# Install dependencies
composer install

# Run all tests
composer test
# or
./vendor/bin/phpunit

# Run tests with coverage
composer test-coverage
# or
./vendor/bin/phpunit --coverage-html coverage

Contributing

Contributions are welcome. Please submit a pull request or create an issue if you have any improvements or find any bugs.