initial
This commit is contained in:
Evgeny Zinoviev
commit
b75f1a4ab8
307
FastDNS.php
Normal file
307
FastDNS.php
Normal file
@ -0,0 +1,307 @@
|
||||
<?php
|
||||
|
||||
class FastDNS {
|
||||
|
||||
const API_HOST = 'https://fastdns.fv.ee';
|
||||
const MAIL_SERVICE_MAIN = 0;
|
||||
const MAIL_SERVICE_YANDEX = 2;
|
||||
const MAIL_SERVICE_GMAIL = 1;
|
||||
|
||||
protected $jwtToken;
|
||||
protected $expire;
|
||||
|
||||
/**
|
||||
* @param string $token
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function auth(string $token) {
|
||||
$url = self::API_HOST.'/login_token';
|
||||
$ch = curl_init();
|
||||
curl_setopt($ch, CURLOPT_URL, $url);
|
||||
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
|
||||
curl_setopt($ch, CURLOPT_POST, true);
|
||||
curl_setopt($ch, CURLOPT_HTTPHEADER, [
|
||||
'Accept: application/json',
|
||||
'Authenticate: '.$token
|
||||
]);
|
||||
$body = curl_exec($ch);
|
||||
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
||||
curl_close($ch);
|
||||
|
||||
$response = jsonDecode($body);
|
||||
if ($code != 200)
|
||||
throw new FastDNSException($response['message'], $response['code']);
|
||||
|
||||
$this->jwtToken = $response['token'];
|
||||
$this->expire = $response['expire'];
|
||||
}
|
||||
|
||||
/**
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getDomains() {
|
||||
return $this->get('/api/domains', []);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $id
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getDomain($id) {
|
||||
return $this->get('/api/domains/'.$id);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param $name
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getDomainByName($name) {
|
||||
return $this->get('/api/domains/'.$name.'/name');
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $name
|
||||
* @param string $ip
|
||||
* @param int $mail_service
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function createDomain(string $name, string $ip, int $mail_service = self::MAIL_SERVICE_MAIN) {
|
||||
return $this->post('/api/domains', [
|
||||
'name' => $name,
|
||||
'ip' => $ip,
|
||||
'mail_service' => $mail_service
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* No idea what this does and what "required" means
|
||||
*
|
||||
* @param $domain_id
|
||||
* @param int $required
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function updateDomain($domain_id, int $required) {
|
||||
return $this->put('/api/domains/'.$domain_id, [
|
||||
'required' => $required
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function deleteDomain(int $domain_id) {
|
||||
return $this->delete('/api/domains/'.$domain_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getRecords(int $domain_id) {
|
||||
return $this->get('/api/domains/'.$domain_id.'/records');
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @param string $name
|
||||
* @param string $type
|
||||
* @param string $content
|
||||
* @param int $ttl
|
||||
* @param string $tag
|
||||
* @param int $flag
|
||||
* @param int $priority
|
||||
* @param int $weight
|
||||
* @param int $port
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function createRecord(
|
||||
int $domain_id,
|
||||
string $name,
|
||||
string $type,
|
||||
string $content,
|
||||
int $ttl,
|
||||
string $tag = '',
|
||||
int $flag = 0,
|
||||
int $priority = 5,
|
||||
int $weight = 0,
|
||||
int $port = 0) {
|
||||
return $this->post('/api/domains/'.$domain_id.'/records', [
|
||||
'name' => $name,
|
||||
'type' => $type,
|
||||
'content' => $content,
|
||||
'ttl' => $ttl,
|
||||
'tag' => $tag,
|
||||
'flag' => $flag,
|
||||
'priority' => $priority,
|
||||
'weight' => $weight,
|
||||
'port' => $port
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @param string $record_id
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getRecord(int $domain_id, string $record_id) {
|
||||
return $this->get('/api/domains/'.$domain_id.'/records/'.$record_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @param string $record_id
|
||||
* @param string $name
|
||||
* @param string $type
|
||||
* @param string $content
|
||||
* @param int $ttl
|
||||
* @param string $tag
|
||||
* @param int $flag
|
||||
* @param int $priority
|
||||
* @param int $weight
|
||||
* @param int $port
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function updateRecord(
|
||||
int $domain_id,
|
||||
string $record_id,
|
||||
string $name,
|
||||
string $type,
|
||||
string $content,
|
||||
int $ttl,
|
||||
string $tag = '',
|
||||
int $flag = 0,
|
||||
int $priority = 5,
|
||||
int $weight = 0,
|
||||
int $port = 0) {
|
||||
|
||||
// если здесь передавать все поля, то сервер возвращает ошибку "запись уже существует",
|
||||
return $this->put('/api/domains/'.$domain_id.'/records/'.$record_id, [
|
||||
// 'type' => $type,
|
||||
'content' => $content,
|
||||
'name' => $name,
|
||||
// 'ttl' => $ttl,
|
||||
// 'tag' => $tag,
|
||||
// 'flag' => $flag,
|
||||
// 'priority' => $priority,
|
||||
// 'weight' => $weight,
|
||||
// 'port' => $port
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param int $domain_id
|
||||
* @param string $record_id
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function deleteRecord(int $domain_id, string $record_id) {
|
||||
return $this->delete('/api/domains/'.$domain_id.'/records/'.$record_id);
|
||||
}
|
||||
|
||||
/**
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
public function getUserInfo() {
|
||||
return $this->get('/api/me');
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $endpoint
|
||||
* @param array $params
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
protected function get(string $endpoint, array $params = []) {
|
||||
return $this->request('GET', $endpoint, $params);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $endpoint
|
||||
* @param array $params
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
protected function post(string $endpoint, array $params = []) {
|
||||
return $this->request('POST', $endpoint, $params);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $endpoint
|
||||
* @param array $params
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
protected function put(string $endpoint, array $params = []) {
|
||||
return $this->request('PUT', $endpoint, $params);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $endpoint
|
||||
* @param array $params
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
protected function delete(string $endpoint, array $params = []) {
|
||||
return $this->request('DELETE', $endpoint, $params);
|
||||
}
|
||||
|
||||
/**
|
||||
* @param string $method
|
||||
* @param string $endpoint
|
||||
* @param array $params
|
||||
* @return mixed
|
||||
* @throws FastDNSException
|
||||
*/
|
||||
protected function request(string $method, string $endpoint, array $params = []) {
|
||||
if (!$this->jwtToken)
|
||||
throw new FastDNSException(__METHOD__.': JWT token is null, forgot to authorize?');
|
||||
|
||||
$url = self::API_HOST.$endpoint;
|
||||
$ch = curl_init();
|
||||
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
|
||||
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
|
||||
if (!empty($params)) {
|
||||
if ($method === 'POST' || $method == 'PUT') {
|
||||
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
|
||||
curl_setopt($ch, CURLOPT_POSTFIELDS, jsonEncode($params));
|
||||
} else if ($method === 'GET') { // Probably never used
|
||||
$url .= '?'.http_build_query($params);
|
||||
}
|
||||
}
|
||||
curl_setopt($ch, CURLOPT_URL, $url);
|
||||
curl_setopt($ch, CURLOPT_HTTPHEADER, [
|
||||
'Accept: application/json',
|
||||
'Authorization: Bearer '.$this->jwtToken
|
||||
]);
|
||||
$body = curl_exec($ch);
|
||||
$code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
|
||||
curl_close($ch);
|
||||
|
||||
$response = jsonDecode($body);
|
||||
if ($code >= 400) {
|
||||
if (!empty($response['code']) && !empty($response['message'])) {
|
||||
$message = $response['message'];
|
||||
$code = $response['code'];
|
||||
} else {
|
||||
$message = $response['errors']['name'] ?? $body;
|
||||
}
|
||||
throw new FastDNSException($message, $code);
|
||||
}
|
||||
|
||||
return $response;
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
class FastDNSException extends Exception {}
|
||||
25
LICENSE
Normal file
25
LICENSE
Normal file
@ -0,0 +1,25 @@
|
||||
BSD 2-Clause License
|
||||
|
||||
Copyright (c) 2021, Evgeny Zinoviev
|
||||
All rights reserved.
|
||||
|
||||
Redistribution and use in source and binary forms, with or without
|
||||
modification, are permitted provided that the following conditions are met:
|
||||
|
||||
1. Redistributions of source code must retain the above copyright notice, this
|
||||
list of conditions and the following disclaimer.
|
||||
|
||||
2. Redistributions in binary form must reproduce the above copyright notice,
|
||||
this list of conditions and the following disclaimer in the documentation
|
||||
and/or other materials provided with the distribution.
|
||||
|
||||
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
||||
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
|
||||
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
|
||||
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
|
||||
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
|
||||
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
|
||||
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
||||
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
28
README.md
Normal file
28
README.md
Normal file
@ -0,0 +1,28 @@
|
||||
# php-fastdns
|
||||
|
||||
Клиент к FastVPS DNS API. Позволяет создавать, редактировать, удалять домены и записи.
|
||||
|
||||
Полезно для автоматизации, если у вас много доменов/поддоменов.
|
||||
|
||||
## Использование
|
||||
|
||||
```php
|
||||
$fastdns = new FastDNS();
|
||||
try {
|
||||
// авторизуемся
|
||||
$fastdns->auth('ВАШ ТОКЕН');
|
||||
|
||||
// готово
|
||||
// для примера, получим список доменов
|
||||
$domains = $fastdns->getDomains();
|
||||
var_dump($domains);
|
||||
} catch (FastDNSException $e) {
|
||||
// что-то пошло не так
|
||||
}
|
||||
```
|
||||
|
||||
Все доступные методы и параметры смотрите в классе, он простой.
|
||||
|
||||
## Лицензия
|
||||
|
||||
BSD-2c
|
||||
Loading…
x
Reference in New Issue
Block a user