Download the PHP package hoa/dns without Composer
On this page you can find all versions of the php package hoa/dns. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package dns
Hoa is a modular, extensible and
structured set of PHP libraries.
Moreover, Hoa aims at being a bridge between industrial and research worlds.
Hoa\Dns
This library allows to create a domain name resolver.
Installation
With Composer, to include this library into
your dependencies, you need to
require hoa/dns:
For more installation procedures, please read the Source page.
Testing
Before running the test suites, the development dependencies must be installed:
Then, to run all the test suites:
For more information, please read the contributor guide.
Quick usage
As a quick overview, we propose to create our own resolution server for the top
level domain .hoa. We start by modifying the local resolver in order to add a
new resolution host: ours.
Specify a resolution server
On Mac OS X, the simplest way is to write in /etc/resolver/hoa the following
declarations:
On Linux, we will use DNSMasq
(often already installed). Then, we edit the file /etc/dnsmasq.conf by adding:
And do not forget to restart:
For Windows, it is more complicated. You should read the documentation.
Create a resolution server
Well, now, we will create our resolution server that will listen
127.0.0.1:57005 (57005 = 0xDEAD) in UDP. Thus, in the Resolution.php
file:
All query for the top level domain .hoa will be resolved to 127.0.0.1 (note:
we do not look at the type, which should be A or AAAA respectively for IPv4
and IPv6).
Finally, let say we have a HTTP server that runs on 127.0.0.1:8888 and the
index responds yeah \o/, then we start our resolver:
And we make an HTTP request on foo.hoa (that will be resolve to 127.0.0.1):
We see that foo.hoa is resolved to 127.0.0.1!
Documentation
The
hack book of Hoa\Dns contains
detailed information about how to use this library and how it works.
To generate the documentation locally, execute the following commands:
More documentation can be found on the project's website: hoa-project.net.
Getting help
There are mainly two ways to get help:
- On the
#hoaprojectIRC channel, - On the forum at users.hoa-project.net.
Contribution
Do you want to contribute? Thanks! A detailed contributor guide explains everything you need to know.
License
Hoa is under the New BSD License (BSD-3-Clause). Please, see
LICENSE for details.
Related projects
The following projects are using this library:
- ec2dns, ec2dns is a set of command line tools that makes it easy to display public hostnames of EC2 instances and ssh into them via their tag name.