What is this?
-------------

This is the EPP ClientToolkit for the .AT EPP Registry based on Metaregistrar EPP library.
The Toolkit consists of a Metaregistrar composer package and commandline
wrappers around the Metaregistrar PHP EPP Client for an easier startup. For more
information on Metaregistrar please check the README.md in the directory
vendor/metaregistrar/php-epp-client

Metaregistrar and the wrapper are written in PHP and have been tested on
different Linux distributions.

Content of this tarball
-----------------------

The directory vendor/metaregistrar contains a upstream version of Metaregistrar
PHP EPP Client Version 1.0.13
(https://github.com/metaregistrar/php-epp-client). This Version
includes the implemenation of RFC 5910 which if needed for the 
DNSSEC-implementation of the .AT-registry.

The directory wrapper/ contains a sample implementation of Metaregistrar based
commandlinewrappers for each EPP transaction.

PHP requirements
-------------------

Make sure to use at least PHP7 (we recommend at least PHP8) as well as ext-dom and ext-libxml extensions.


Install
-------

Tarball:
Unpack the contents of this tarball and make sure your PHP cli binary is in PATH.

Source code:
- checkout the code
- run `composer install`

How to use
----------

NIC.AT provides commandline wrappers for an easier startup. Here is an example 
commandline wrapper call for a createdomain transaction:

php createdomain.php --server <user>:<password>@<server>:<port> \
                     --logdir /tmp/epp --domain testdomain.at \
                     --nameserver ns1.test1234.at/2001:628:453:4302::53/2001:628:453:4302::54/192.193.54.34\
                     --nameserver ns1.testdomain.at/1.2.3.4 \
                     --registrant XY1231234 \
                     --techc XY1231234 \
                     --cltrid my-cltrid-0815
     
This command connects to the given registry at <server>:<port>, authenticates 
with the given username/password and does a "create domain" transaction with 
the given parameters.

Such command line wrappers are available for all supported epp transactions. 
Do get the possible parameters for one wrapper just call them without any 
parameters.