PHP โอเพนซอร์ส

Registrar API

ไลบรารี PHP เดียวสำหรับจัดการโดเมนบน NameSilo, GoDaddy, Namecheap และ Dynadot — พร้อมอะแดปเตอร์ Cloudflare สำหรับโซน DNS และแคช ตรวจสอบความพร้อมใช้งาน จดทะเบียน ต่ออายุ โอนย้าย เรกคอร์ด DNS และเนมเซิร์ฟเวอร์ ทั้งหมดผ่านอินเทอร์เฟซที่สอดคล้องกันหนึ่งเดียว

composer require josuamarcelc/registrar-api

อะแดปเตอร์

ผู้รับจดทะเบียนที่รองรับ

เลือกอะแดปเตอร์ด้วยชื่อแบรนด์ อะแดปเตอร์ทั้งหมดใช้ลายเซ็นเมธอดเดียวกัน คุณจึงเปลี่ยนผู้รับจดทะเบียนได้โดยไม่ต้องเขียนโค้ดใหม่

NameSilo'namesilo'
GoDaddy'godaddy'
Namecheap'namecheap'
Dynadot'dynadot'
CloudflareDNS / zones

เดโมสด

ตรวจสอบความพร้อมของโดเมน

เรียกใช้ checkAvailability() จริงผ่านอะแดปเตอร์ NameSilo ที่ฝั่งเซิร์ฟเวอร์ ใส่โดเมนได้สูงสุด 10 รายการ คั่นด้วยเครื่องหมายจุลภาค เว้นวรรค หรือขึ้นบรรทัดใหม่ จำกัด 10 ครั้งต่อ 5 นาที

เริ่มต้นอย่างรวดเร็ว

สามบรรทัดสู่การเรียกใช้งานจริง

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

use RegistrarAPI\RegistrarAPI;

$api = RegistrarAPI::make('namesilo', [
  'api_key' => 'YOUR_NAMESILO_API_KEY'
]);

$result = $api->checkAvailability(['example.com', 'mybrand.io']);
print_r($result);

ข้อมูลรับรอง

การตั้งค่าต่ออะแดปเตอร์

อะแดปเตอร์แต่ละตัวรับอาร์เรย์การตั้งค่า ด้านล่างคือค่าขั้นต่ำที่คุณมักต้องใช้

NameSilo
RegistrarAPI::make('namesilo', [
  'api_key' => 'YOUR_KEY',
]);
GoDaddy
RegistrarAPI::make('godaddy', [
  'api_key'    => 'KEY',
  'api_secret' => 'SECRET',
  // optional: 'base' => 'https://api.godaddy.com/v1'
]);
Namecheap
RegistrarAPI::make('namecheap', [
  'api_user'  => 'USERNAME',
  'api_key'   => 'KEY',
  'client_ip' => 'SERVER_PUBLIC_IP',
  // optional: 'base' => 'https://api.namecheap.com/xml.response'
]);
Dynadot
RegistrarAPI::make('dynadot', [
  'api_key' => 'KEY',
]);

เมธอด

การทำงานทั่วไป

อะแดปเตอร์ทุกตัวใช้ลายเซ็นเมธอดเดียวกัน ค่าที่คืนกลับเป็นอาร์เรย์แบบเชื่อมโยงที่ถูกทำให้เป็นมาตรฐาน

// Availability
$api->checkAvailability(['example.com']);

// Lifecycle
$api->registerDomain('example.com', [
  'years'      => 1,
  'privacy'    => true,
  'auto_renew' => true,
  'registrant' => [ /* contact fields */ ],
]);
$api->renewDomain('example.com', 1);
$api->transferDomain('example.com', ['auth_code' => 'EPP']);
$api->getDomain('example.com');

// DNS records
$api->getDNS('example.com');
$api->setDNS('example.com', [
  ['type'=>'A',    'host'=>'@',   'value'=>'203.0.113.10', 'ttl'=>600],
  ['type'=>'CNAME','host'=>'www', 'value'=>'@',            'ttl'=>600],
]);
$api->addDNS('example.com', ['type'=>'TXT','host'=>'@','value'=>'v=spf1 -all','ttl'=>300]);
$api->delDNS('example.com', ['type'=>'TXT','host'=>'@']);

// Nameservers
$api->setNameServers('example.com', ['ns1.host.com','ns2.host.com']);

// Escape hatch — call any raw endpoint the adapter doesn't wrap
$api->raw('domains/suggestions?query=mybrand&limit=5');

รูปแบบการตอบกลับ

สิ่งที่คุณจะได้รับ

okbool — ตรวจสอบความสำเร็จอย่างรวดเร็ว
rawเพย์โหลดต้นฉบับของผู้รับจดทะเบียนที่ถูกแปลงแล้ว (JSON หรือ XML-เป็น-อาร์เรย์)
httpรหัสสถานะ HTTP เมื่อมี
errสตริงข้อผิดพลาดระดับการรับส่งข้อมูล (เฉพาะเมื่อการเรียกล้มเหลว)
available / unavailable / invalidกลุ่มที่ถูกเติมโดย checkAvailability()
recordsอาร์เรย์ของ {type,host,value,ttl,prio?} ที่คืนโดย getDNS()

โบนัส

อะแดปเตอร์ Cloudflare

ไลบรารีเดียวกัน รูปแบบเดียวกัน แต่สำหรับโซน เรกคอร์ด DNS การล้างแคช และสวิตช์ฟรี (Always HTTPS, Auto HTTPS Rewrites, Brotli, Minify, Rocket Loader, Dev Mode)

$cf = RegistrarAPI::make('cloudflare', ['api_token' => 'CF_TOKEN']);
$cf->createZone('example.com');
$cf->setDNS('example.com', [
  ['type'=>'A','host'=>'@','value'=>'198.51.100.10','ttl'=>300,'proxied'=>true],
]);
$cf->purgeEverything('example.com');

ร่วมพัฒนา

เพิ่มผู้รับจดทะเบียนใหม่ในไฟล์เดียว

สร้างคลาสใน src/adapters/ ที่สืบทอดจาก BaseAdapter แล้วเขียนเมธอดนามธรรม Composer จะโหลดให้อัตโนมัติ

namespace RegistrarAPI\Adapters;

use RegistrarAPI\Core\BaseAdapter;

class MyRegistrar extends BaseAdapter {
  protected string $brand = 'myregistrar';

  public function checkAvailability(array $domains): array { /* ... */ }
  public function registerDomain(string $domain, array $opts): array { /* ... */ }
  public function renewDomain(string $domain, int $years=1, array $opts=[]): array { /* ... */ }
  public function transferDomain(string $domain, array $opts): array { /* ... */ }
  public function getDomain(string $domain): array { /* ... */ }
  public function getDNS(string $domain): array { /* ... */ }
  public function setDNS(string $domain, array $records): array { /* ... */ }
  public function addDNS(string $domain, array $record): array { /* ... */ }
  public function delDNS(string $domain, array $selector): array { /* ... */ }
  public function setNameServers(string $domain, array $nameservers): array { /* ... */ }
  public function raw(string $op, array $params=[]): array { /* ... */ }
}