sensson/laravel-directadmin

DirectAdmin integration for Laravel

v0.0.3 2024-06-04 06:27 UTC

This package is auto-updated.

Last update: 2024-11-08 16:50:03 UTC


README

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

PHP library for interacting with the DirectAdmin API in Laravel.

Installation

You can install the package via composer:

composer require sensson/laravel-directadmin
php artisan vendor:publish --tag="laravel-directadmin-config"

Usage

You will need the following credentials to authenticate:

  • DIRECTADMIN_SERVER
  • DIRECTADMIN_USERNAME
  • DIRECTADMIN_PASSWORD

A simple example

You can call any DirectAdmin API by using the DirectAdmin facade:

<?php
use Sensson\DirectAdmin\Facades\DirectAdmin;

$result = DirectAdmin::post('{DIRECTADMIN_API_CALL}', []);
$result = DirectAdmin::get('{DIRECTADMIN_API_CALL}', []);

The first parameter is the API command you want to call. The second parameter is an array of parameters that will be passed to the API as well. This is optional and by default an empty array is used.

You can use the post or get method to call the API.

JSON API

We also support the new JSON API. For example, to get the admin usage, you can use the following command:

$result = DirectAdmin::get('api/admin-usage', []);

Impersonation

If you want to run an API call as a different user, and you are authenticated as an admin or reseller, you can use the become method:

$result = DirectAdmin::become('user')->post('{DIRECTADMIN_API_CALL}');

This will run the DIRECTADMIN_API_CALL as the user user.

Debugging

You can enable debugging by calling the debug method:

$result = DirectAdmin::debug()->post('{DIRECTADMIN_API_CALL}', []);

This will enable debugging for the HTTP request. This can help you identify issues with the DirectAdmin server.

More information

For more information on the available commands, please refer to the DirectAdmin API documentation.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.