Add DNSRecordGetterDirect, allowing to specify the nameserver to use for the query. (#20)

Author: btafoya

.idea/spfcheck.iml

@@ -1,5 +1,10 @@
+sudo: required
+
 language: php
 
+services:
+  - docker
+
 php:
   - 5.4
   - 5.5
@@ -16,6 +21,7 @@ matrix:
 before_script:
   - composer self-update
   - composer install --prefer-source --no-interaction --dev
+  - docker run -d --rm --name pdns -p 53:53/udp -p 53:53/tcp -p 80:80 -e "WEBPASSWD=password" raspberrypython/powerdns-sqlite3:latest
 
 script:
   - mkdir -p build/logs

.travis.yml

@@ -13,20 +13,28 @@ Run `composer require mika56/spfcheck` or add this to your composer.json:
 ```json
 {
   "require": {
-    "mika56/spfcheck": "dev-master"
+    "mika56/spfcheck": "^1"
   }
 }
 ```
 
 ## Usage
-Create a new instance of SPFCheck. The constructor requires a DNSRecordGetterInterface to be passed. Currently, only DNSRecordGetter exists, which uses PHP's DNS functions to get data.
+Create a new instance of SPFCheck. The constructor requires a DNSRecordGetterInterface to be passed. Currently, you have two options:
+- `DNSRecordGetter` which uses PHP's DNS functions to get data
+- `DNSRecordGetterDirect` which uses the [PHP DNS Direct Query Module](https://github.com/purplepixie/phpdns) to get data.
 ```php
 <?php
 use Mika56\SPFCheck\SPFCheck;
 use Mika56\SPFCheck\DNSRecordGetter;
 
 require('vendor/autoload.php');
-$checker = new SPFCheck(new DNSRecordGetter());
+
+$checker = new SPFCheck(new DNSRecordGetter()); // Uses php's dns_get_record method for lookup.
+var_dump($checker->isIPAllowed('127.0.0.1', 'test.com'));
+
+// or
+
+$checker = new SPFCheck(new DNSRecordGetterDirect("8.8.8.8")); // Uses phpdns, allowing you to set the nameserver you wish to use for the dns queries.
 var_dump($checker->isIPAllowed('127.0.0.1', 'test.com'));
 ```
 

README.md

@@ -12,11 +12,16 @@
         {
             "name": "Mikael Peigney",
             "email": "[email protected]"
+        },
+        {
+            "name": "Brian Tafoya",
+            "email": "[email protected]"
         }
     ],
     "require": {
         "symfony/http-foundation": "2.8.* || ^3.0",
-        "php": ">=5.4"
+        "php": ">=5.4",
+        "purplepixie/phpdns": "^2.0"
     },
     "autoload": {
         "psr-4": {