sensson / laravel-directadmin
DirectAdmin integration for Laravel
Fund package maintenance!
Sensson
Requires
- php: ^8.2
- guzzlehttp/guzzle: ^7
- illuminate/contracts: ^10.0||^11.0
- spatie/laravel-package-tools: ^1.16
Requires (Dev)
- larastan/larastan: ^2.9
- laravel/pint: ^1.14
- nunomaduro/collision: ^8.1.1||^7.10.0
- orchestra/testbench: ^9.0.0||^8.22.0
- pestphp/pest: ^2.34
- pestphp/pest-plugin-arch: ^2.7
- pestphp/pest-plugin-laravel: ^2.3
- phpstan/extension-installer: ^1.3
- phpstan/phpstan-deprecation-rules: ^1.1
- phpstan/phpstan-phpunit: ^1.3
- spatie/laravel-ray: ^1.35
README
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.