Merge branch 'develop'

Author: jeremykendall

.php_cs

@@ -0,0 +1,16 @@
+<?php
+
+require_once './vendor/autoload.php';
+
+$finder = \Symfony\CS\Finder\DefaultFinder::create()
+    ->in('src/')
+    ->in('tests/');
+
+return \Symfony\CS\Config\Config::create()
+    ->setUsingCache(true)
+    ->fixers([
+        '-concat_without_spaces',
+        'concat_with_spaces',
+        'ordered_use',
+    ])
+    ->finder($finder);

.travis.yml

@@ -5,6 +5,7 @@ php:
   - 5.4
   - 5.5
   - 5.6
+  - hhvm
 
 script: phpunit
 

README.md

@@ -49,7 +49,7 @@ Create a `composer.json` file in the root of your project:
 ``` json
 {
     "require": {
-        "jeremykendall/php-domain-parser": "~1.3"
+        "jeremykendall/php-domain-parser": "~2.0"
     }
 }
 ```
@@ -136,8 +136,12 @@ $publicSuffix = $url->host->publicSuffix;
 support was added in version `1.4.0`. Both unicode domains and their ASCII equivalents
 are supported.
 
-**IMPORTANT**: PHP's [intl](http://php.net/manual/en/book.intl.php) extension is
+**IMPORTANT**: 
+
+* PHP's [intl](http://php.net/manual/en/book.intl.php) extension is
 required for the [IDN functions](http://php.net/manual/en/ref.intl.idn.php).
+* PHP's [mb_string](http://php.net/manual/en/book.mbstring.php) extension is
+required for [mb_strtolower](http://php.net/manual/en/function.mb-strtolower.php).
 
 #### Unicode
 
@@ -276,6 +280,24 @@ class Pdp\Uri\Url\Host#7 (3) {
 }
 ```
 
+### Validation of Public Suffixes
+
+Public Suffix validation is available by calling `Parser::isValidSuffix()`:
+
+```
+var_dump($parser->isValidSuffix('www.example.faketld');
+// false
+
+var_dump($parser->isValidSuffix('www.example.com.au');
+// true
+```
+
+A suffix is considered invalid if it is not contained in the [Public Suffix List](http://publicsuffix.org/).
+
+> Huge thanks to [@SmellyFish](https://github.com/SmellyFish) for submitting 
+> [Add a way to validate TLDs](https://github.com/jeremykendall/php-domain-parser/pull/36) 
+> to add public suffix validation to the project.  
+
 ### Retrieving Domain Components Only ###
 
 If you're only interested in a domain component, you can use the parser to

build.xml

@@ -3,31 +3,40 @@
 
     <property file="build.properties" />
 
+    <target name="clean" description="Clean build path">
+        <delete dir="${project.basedir}/build" />
+        <mkdir dir="${project.basedir}/build" />
+        <mkdir dir="${project.basedir}/build/coverage" />
+        <mkdir dir="${project.basedir}/build/docs" />
+    </target>
+
     <target name="phpunit" description="Running unit tests">
         <exec
             passthru="${passthru}"
             dir="${project.basedir}"
-			command="phpunit" />
+            command="phpunit" />
     </target>
 
     <target name="php-cs-fixer" description="PHP Codings Standards fixer">
         <exec
             passthru="${passthru}"
-            command="php-cs-fixer --verbose fix library/" />
+            command="php-cs-fixer --verbose fix" />
     </target>
 
     <target name="phpdoc" description="Generate API documentation">
         <exec
             passthru="${passthru}"
             command="phpdoc
-                -d ${project.basedir}/library
-                -t ${project.basedir}/docs
-                --title='PHP Domain Parser'
-                --defaultpackagename='Pdp'
-                --force" />
+            -d ${project.basedir}/src
+            -t ${project.basedir}/build/docs
+            --title='PHP Domain Parser'
+            --defaultpackagename='Pdp'
+            --template='responsive-twig'
+            --force" />
     </target>
-    
+
     <target name="build" description="Build app">
+        <phingCall target="clean" />
         <phingCall target="php-cs-fixer" />
         <phingCall target="phpunit" />
         <phingCall target="phpdoc" />

composer.json

@@ -1,12 +1,21 @@
 {
     "name": "jeremykendall/php-domain-parser",
     "description": "Public Suffix List based URL parsing implemented in PHP.",
+    "homepage": "https://github.com/jeremykendall/php-domain-parser",
+    "support": {
+        "issues": "https://github.com/jeremykendall/php-domain-parser/issues",
+        "source": "https://github.com/jeremykendall/php-domain-parser"
+    },
     "license": "MIT",
     "authors": [
         {
             "name": "Jeremy Kendall",
             "homepage": "http://about.me/jeremykendall",
             "role": "Developer"
+        },
+        {
+            "name": "Contributors",
+            "homepage": "https://github.com/jeremykendall/php-domain-parser/graphs/contributors"
         }
     ],
     "bin": [
@@ -25,15 +34,15 @@
         "ext-mbstring": "*"
     },
     "require-dev": {
-        "mikey179/vfsStream": "1.2.*",
-        "phpunit/phpunit": "4.*"
+        "mikey179/vfsStream": "~1.4",
+        "phpunit/phpunit": "~4.4"
     },
     "autoload": {
         "psr-0": {
-            "Pdp\\": "library/"
+            "Pdp\\": "src/"
         },
         "files": [
-            "library/mb-parse-url.php"
+            "src/pdp-parse-url.php"
         ]
     }
 }