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
#hoaproject
IRC 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.