Synchronization
syncDomains()
This function is used for the "domain synchronization". This is a feature which runs once per day on the hostware environment to get the current domain settings to keep the hostware database up to date. You can see in the response which data gets updated.
This should also return the domain handle data for all 4 handles. If hostware has no inside the
Parameters
This function gets a collection of domains as a parameter which need to be checked. You can return MORE domains, but hostware will only check and update the domains which are provided inside the input collection.
Type | Name | Description |
|---|---|---|
Collection | $domains | Collection of Domain Models which should be queried |
Response
Array of DomainSyncResponse() class. The array key must be the domain id.
If a requested domain is not available inside the response, hostware will assume it was transferred away and will delete it inside the hostware database.
Type | Name | Description |
|---|---|---|
DomainSyncStatusEnum | $domainStatus | The status of the domain (ACTIVE, INACTIVE, TRANSFERRED_AWAY) |
Bool | $autoRenewActive | The auto renew status |
Carbon or Null | $expiryDate | The date of domain expiry |
Carbon or Null | $registrationDate | The date of domain creation |
Bool | $transferLockActive | The status of transfer lock |
Bool | $privacyActive | The status of privacy protection |
Example Code
Testing
This function gets executed daily in the cronjob / background. Every domain has a column "synced=true/false" inside the database. Every day, this status gets set to false so the domain will be synced once again. After the sync, the column will be set to true.
Reset the domain sync column:
Run the domain sync for a specific domain. You can also remove the domain parameter to let the sync run for all domains inside your portfolio.