Merge pull request #223 from jeremykendall/develop

Prepare 5.3.0 release

Author: nyamsprod

.php_cs

@@ -1,5 +1,16 @@
 <?php
 
+$header = <<<EOF
+PHP Domain Parser: Public Suffix List based URL parsing.
+
+@see http://github.com/jeremykendall/php-domain-parser for the canonical source repository
+
+@copyright Copyright (c) 2017 Jeremy Kendall (http://jeremykendall.net)
+
+For the full copyright and license information, please view the LICENSE
+file that was distributed with this source code.
+EOF;
+
 $finder = PhpCsFixer\Finder::create()
     ->in(__DIR__.'/src')
     ->in(__DIR__.'/tests')
@@ -10,6 +21,12 @@ return PhpCsFixer\Config::create()
         '@PSR2' => true,
         'array_syntax' => ['syntax' => 'short'],
         'concat_space' => ['spacing' => 'none'],
+        'header_comment' => [
+            'commentType' => 'PHPDoc',
+            'header' => $header,
+            'location' => 'after_open',
+            'separate' => 'both',
+        ],
         'new_with_braces' => true,
         'no_blank_lines_after_phpdoc' => true,
         'no_empty_phpdoc' => true,
@@ -24,6 +41,7 @@ return PhpCsFixer\Config::create()
         'phpdoc_order' => true,
         'phpdoc_scalar' => true,
         'phpdoc_to_comment' => true,
+        'phpdoc_summary' => true,
         'psr0' => true,
         'psr4' => true,
         'return_type_declaration' => ['space_before' => 'none'],

CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All Notable changes to `PHP Domain Parser` **5.x** series will be documented in this file
 
+## 5.3.0 - 2018-05-22
+
+### Added
+
+- `Pdp\PublicSuffixListSection` interface implemented by `Pdp\Rules` and `Pdp\PublicSuffix`
+- `Pdp\DomainInterface` interface implemented by `Pdp\Domain` and `Pdp\PublicSuffix`
+- `Pdp\Domain::getContent` replaces `Pdp\Domain::getDomain`
+- `Pdp\Domain::withLabel` adds a new label to the `Pdp\Domain`.
+- `Pdp\Domain::withoutLabel` removes labels from the `Pdp\Domain`.
+- `Pdp\Domain::withPublicSuffix` updates the `Pdp\Domain` public suffix part.
+- `Pdp\Domain::withSubDomain` updates the `Pdp\Domain` sub domain part.
+- `Pdp\Domain::append` appends a label to `Pdp\Domain`.
+- `Pdp\Domain::prepend` prepends a label to `Pdp\Domain`.
+- `Pdp\Domain::resolve` attach a public suffix to the `Pdp\Domain`.
+- `Pdp\Domain::isResolvable` tells whether the current `Pdp\Domain` can have a public suffix attached to it or not.
+- `Pdp\PublicSuffix::createFromDomain` returns a new `Pdp\PublicSuffix` object from a `Pdp\Domain`object
+- `Pdp\Exception` sub namespace to organize exception. All exception extends the `Pdp\Exception` class to prevent BC break.
+
+### Fixed
+
+- `Pdp\Domain` domain part computation (public suffix, registrable domain and sub domain)
+- `Pdp\Domain` and `Pdp\PublicSuffix` host validation compliance to RFC improved
+- Improve `Pdp\Converter` and `Pdp\Manager` class to better report error on IDN conversion.
+- Improve `Pdp\Installer` vendor directory resolution see [PR #222](https://github.com/jeremykendall/php-domain-parser/pull/222)
+- `Pdp\Exception` nows extends `InvalidArgumentException` instead of `RuntimeException`
+
+### Deprecated
+
+- `Pdp\Domain::getDomain` use instead `Pdp\Domain::getContent`
+- `Pdp\Rules::ALL_DOMAINS` use the empty string instead
+
+### Removed
+
+- None
+
 ## 5.2.0 - 2018-02-23
 
 ### Added