pandi-id / php-epp-id
A High Level EPP (Extensible Provisioning Protocol) TCP/SSL Client for PHP
Requires
- php: >=5.5.0
- ext-intl: *
- ext-openssl: *
- guzzlehttp/guzzle: ^6.3
- php-coveralls/php-coveralls: ^2.1
Requires (Dev)
This package is auto-updated.
Last update: 2024-05-05 12:58:07 UTC
README
This is a modified files from AfriCC
php-epp-id is a High Level Extensible Provisioning Protocol (EPP) TCP/SSL client written in modern PHP.
Released under the GPLv3 License, feel free to contribute (fork, create meaningful branchname, issue pull request with thus branchname)!
Requirements
- PHP 5.5+
- php-ext-intl
- php-ext-openssl
Features
- modern PHP standards
- high-level usage (Plug & Play)
- simplified client (auto login/logout, auto inject clTRID)
- SSL (+local-cert)
- XPath like setter to simplify the creation of complex XML structures
- XML based responses for direct traversal via XPath
- RFC 5730, RFC 5731, RFC 5732, RFC 5733, RFC 5734 & RFC 3915
Install
Via Composer
$ composer require pandi-id/php-epp-id
Usage
See the examples folder for a more or less complete usage reference.
Basic Client Connection
this will automatically login on connect() and logout on close()
<?php require 'vendor/autoload.php'; use Pandi\EPP\Client as EPPClient; $epp_client = new EPPClient([ 'host' => 'epptest.org', 'username' => 'foo', 'password' => 'bar', 'services' => [ 'urn:ietf:params:xml:ns:domain-1.0', 'urn:ietf:params:xml:ns:contact-1.0' ], 'debug' => true, ]); try { $greeting = $epp_client->connect(); } catch(Exception $e) { echo $e->getMessage() . PHP_EOL; unset($epp_client); exit(1); } $epp_client->close();
Create Frame Objects
setXXX() indicates that value can only be set once, re-calling the method will overwrite the previous value.
addXXX() indicates that multiple values can exist, re-calling the method will add values.
<?php require 'vendor/autoload.php'; use Pandi\EPP\Frame\Command\Create\Host as CreateHost; $frame = new CreateHost; $frame->setHost('ns1.example.com'); $frame->setHost('ns2.example.com'); $frame->addAddr('8.8.8.8'); $frame->addAddr('8.8.4.4'); $frame->addAddr('2a00:1450:4009:809::1001'); echo $frame; // or send frame to previously established connection $epp_client->sendFrame($frame);
Parse Response
You can either access nodes directly by passing through a xpath or use the data() Method which will return an assoc array.
use Pandi\EPP\Frame\Command\Check\Domain as DomainCheck; use Pandi\EPP\Frame\Response; $frame = new DomainCheck; $frame->addDomain('example.org'); $frame->addDomain('example.net'); $frame->addDomain('example.com'); $response = $epp_client->request($frame); if (!($response instanceof Response)) { echo 'response error' . PHP_EOL; unset($epp_client); exit(1); } echo $response->code() . PHP_EOL; echo $response->message() . PHP_EOL; echo $response->clientTransactionId() . PHP_EOL; echo $response->serverTransactionId() . PHP_EOL; $data = $response->data(); if (empty($data) || !is_array($data)) { echo 'empty response data' . PHP_EOL; unset($epp_client); exit(1); } foreach ($data['chkData']['cd'] as $cd) { printf('Domain: %s, available: %d' . PHP_EOL, $cd['name'], $cd['@name']['avail']); }
Credits
License
php-epp-id is released under the GPLv3 License. See the bundled LICENSE file for details.