dyninc/dyn-php

Dyn PHP SDK - for interaction with Dyn's product APIs

Dyn PHP SDK

This SDK allows PHP developers to interact with Dyn's product APIs from within their PHP applications. Feedback is welcome - please reach out via pull request, GitHub issue, or via. our Community forum., _(*1)

Requirements

Requires PHP 7.4 or above. The cURL extension is recommended (although not required), and will be used if present., _(*2)

Installation

The best way to install this SDK is with Composer. With Composer installed, run:, _(*3)

composer require dyninc/dyn-php

from the command line., _(*4)

Quickstart - DNS

use Dyn\TrafficManagement;
use Dyn\TrafficManagement\Record\A;

$tm = new TrafficManagement('customerName', 'username', 'password');

// login
$tm->createSession();

// retrieve zone
$zone = $tm->getZone('example.com');

// configure a new record
$record = new A();
$record->setAddress('127.0.0.1');

// create the new record
$zone->createRecord($record, 'test.example.com');

// publish zone changes
$zone->publish();

// logout
$tm->deleteSession();

Quickstart - Email

use Dyn\MessageManagement;
use Dyn\MessageManagement\Mail;

$mm = new MessageManagement('YOUR API KEY');

// setup the message
$mail = new Mail();
$mail->setFrom('user@example.com', 'Joe Bloggs')
     ->setTo('janedoe@example.com')
     ->setSubject('Email sent via. Dyn SDK')
     ->setBody('The text of the email');

// send it
$mm->send($mail);

More detailed examples can be found in the examples folder., _(*5)

API Endpoints Supported

• Traffic Management - Session API: create/destroy/refresh
• Traffic Management - Record API: AAAA A CERT CNAME DHCID DNSKEY DS IPSECKEY KEY LOC MX NAPTR NS NSAP PTR PX RP SOA SPF SRV SSHFP TXT
• Traffic Management - Zone API: list/get/publish/freeze/thaw/getChanges/discardChanges
• Traffic Management - HTTP Redirect service: create/update/list/destroy
• Traffic Management - Dynamic DNS service: create/update/list/destroy
• Message Management - All endpoints supported

Testing

With the Composer packages installed, unit tests can be run from this folder using the command:, _(*6)

./vendor/bin/phpunit --configuration test/phpunit.xml