DNS

Bibliothèque Badcow DNS

L'objectif de ce projet est de créer des représentations d'objets abstraites des enregistrements DNS dans PHP. Le projet se compose de diverses classes représentant des objets DNS (tels que Zone , ResourceRecord et divers types RData ), un analyseur pour convertir des fichiers texte de style Bind aux objets PHP et les constructeurs pour créer des enregistrements de liaison esthétiquement agréables.

La bibliothèque peut analyser et coder les messages DNS permettant aux développeurs de créer des plates-formes client / serveur DNS dans Pure PHP.

Statut de construction

Contenu

1. Exemple d'utilisation
2. Exemple de sortie
3. Types pris en charge
4. Analyser les enregistrements de liaison

Exemple d'utilisation

 require_once ' /path/to/vendor/autoload.php ' ;

use Badcow  DNS  Classes ;
use Badcow  DNS  Zone ;
use Badcow  DNS  Rdata  Factory ;
use Badcow  DNS  ResourceRecord ;
use Badcow  DNS  AlignedBuilder ;

$ zone = new Zone ( ' example.com. ' );
$ zone -> setDefaultTtl ( 3600 );

$ soa = new ResourceRecord ;
$ soa -> setName ( ' @ ' );
$ soa -> setClass (Classes:: INTERNET );
$ soa -> setRdata (Factory:: Soa (
    ' example.com. ' ,
    ' post.example.com. ' ,
    ' 2014110501 ' ,
    3600 ,
    14400 ,
    604800 ,
    3600
));

$ ns1 = new ResourceRecord ;
$ ns1 -> setName ( ' @ ' );
$ ns1 -> setClass (Classes:: INTERNET );
$ ns1 -> setRdata (Factory:: Ns ( ' ns1.nameserver.com. ' ));

$ ns2 = new ResourceRecord ;
$ ns2 -> setName ( ' @ ' );
$ ns2 -> setClass (Classes:: INTERNET );
$ ns2 -> setRdata (Factory:: Ns ( ' ns2.nameserver.com. ' ));

$ a = new ResourceRecord ;
$ a -> setName ( ' sub.domain ' );
$ a -> setRdata (Factory:: A ( ' 192.168.1.42 ' ));
$ a -> setComment ( ' This is a local ip. ' );

$ a6 = new ResourceRecord ;
$ a6 -> setName ( ' ipv6.domain ' );
$ a6 -> setRdata (Factory:: Aaaa ( ' ::1 ' ));
$ a6 -> setComment ( ' This is an IPv6 domain. ' );

$ mx1 = new ResourceRecord ;
$ mx1 -> setName ( ' @ ' );
$ mx1 -> setRdata (Factory:: Mx ( 10 , ' mail-gw1.example.net. ' ));

$ mx2 = new ResourceRecord ;
$ mx2 -> setName ( ' @ ' );
$ mx2 -> setRdata (Factory:: Mx ( 20 , ' mail-gw2.example.net. ' ));

$ mx3 = new ResourceRecord ;
$ mx3 -> setName ( ' @ ' );
$ mx3 -> setRdata (Factory:: Mx ( 30 , ' mail-gw3.example.net. ' ));

$ zone -> addResourceRecord ( $ soa );
$ zone -> addResourceRecord ( $ mx2 );
$ zone -> addResourceRecord ( $ ns1 );
$ zone -> addResourceRecord ( $ mx3 );
$ zone -> addResourceRecord ( $ a );
$ zone -> addResourceRecord ( $ a6 );
$ zone -> addResourceRecord ( $ ns2 );
$ zone -> addResourceRecord ( $ mx1 );

$ builder = new AlignedBuilder ();
echo $ builder -> build ( $ zone );

Sortir

 $ ORIGIN example.com.
$ TTL 3600
@            IN SOA  (
                     example.com.      ; MNAME
                     post.example.com. ; RNAME
                     2014110501        ; SERIAL
                     3600              ; REFRESH
                     14400             ; RETRY
                     604800            ; EXPIRE
                     3600              ; MINIMUM
                     )

; NS RECORDS
@            IN NS   ns1.nameserver.com.
@            IN NS   ns2.nameserver.com.

; A RECORDS
sub.domain      A    192.168.1.42; This is a local ip.

; AAAA RECORDS
ipv6.domain     AAAA ::1; This is an IPv6 domain.

; MX RECORDS
@               MX   10 mail-gw1.example.net.
@               MX   20 mail-gw2.example.net.
@               MX   30 mail-gw3.example.net.

Ce qui précède est un exemple du AlignedBuilder qui crée des enregistrements beaucoup plus esthétique. Vous pouvez également utiliser le Flat ZoneBuilder , dont la sortie est ci-dessous:

 . . .
echo ZoneBuilder:: build ( $ zone );

 $ ORIGIN example.com.
$ TTL 3600
@ IN SOA example.com. post.example.com. 2014110501 3600 14400 604800 3600
@ MX 20 mail-gw2.example.net.
@ IN NS ns1.nameserver.com.
@ MX 30 mail-gw3.example.net.
sub.domain A 192.168.1.42; This is a local ip.
ipv6.domain AAAA ::1; This is an IPv6 domain.
@ IN NS ns2.nameserver.com.
@ MX 10 mail-gw1.example.net.

Types pris en charge

Tous les types DNS omniprésents sont pris en charge. Pour plus de détails sur les types pris en charge, voir la documentation.

Analyser les enregistrements de liaison

Les enregistrements de liaison peuvent être analysés dans des objets PHP à l'aide de BadcowDNSParserParser

 $ file = file_get_contents ( ' /path/to/example.com.txt ' );
$ zone = Badcow  DNS  Parser Parser:: parse ( ' example.com. ' , $ file ); //Badcow Zone Object

Aussi simple que ça.

Plus d'exemples peuvent être trouvés dans les documents