Errors

In many conditions the core will return an array with an error key when an error occurred during an task. Depending on which layer this error occurred the array may look different. See the examples below of an system error and an (dns) validation error when importing zones.

array() {
  ["error"]=>
  array() {
    ["code"] => "5001"
    ["desc"] => "Nameserver database unavailable."
  }
}

array() {
  ["errors"]=>
  array() {
    [0]=>
    array() {
      ["record"]=>
      array() {
        ["type"] => "A"
        ["content"] => "192.168.2.999"
        ["name"] => "example.com"
        ["prio"] => "0"
        ["ttl"] => "3600"
      }
      ["code"] => "INVALID_IPV4"
      ["field"] => "content"
      ["desc"] => "IPv4 address does not seem to be valid."
    }
  }
}

The PHP engine might also return errors. When in debug mode all notices, warnings and fatal errors are printed on screen. If debug mode is disabled only fatal errors are returned as catchable exception. For this reason we strongly recommend to surround any operations within an try/catch block to facilitate the catching of potential exceptions.

use solutedns\Dns\Zones;

try {

	$zones = new Zones();
	$zones->session();

	$zones->add('example.com');
	$zones->nsec3('example.com');
	$zones->rectify('example.com');

} catch (Exception $ex) {

	echo 'Caught exception: ',  $ex->getMessage(), "\n";

}

3000

Zone already exists.

3001

Zone could not be found.

3002

Invalid zone name provided.

3003

Slave zone cannot be edited directly.

3004

No zone name has been provided.

4000

Maximum allowed records has been reached.

5000

License failure, see the returned license array to troubleshoot this issue.

5001

Nameserver database is unavailable.

5002

Maximum licensed zones has been reached.

5003

No records found to backup.

5004

No backup found to recover.

5005

No valid PDO object provided to support database.

6000

Unable to login or connect to the SSH service.

6001

An incorrect SSH session was provided.

6002

An SSH error occured: {error-message}

6003

Failed to secure zone.

6004

Unexpected SSH Answer.

7000

One or more nameservers failed to report.

7001

Not all nameservers agree on the SOA serial for this zone.

7002

The registry returned one or more unknown nameservers.

7003

There are NS records in this zone which are not known by the registry.

7004

There is one or more nameservers which do not seem to be authoritative for this zone.

7005

It seems the domain is using an different DNS cluster.

7006

There is one or more record(s) with errors in this zone.

7007

There is one or more record(s) with warnings in this zone.