Skip to content

Latest commit

 

History

History
213 lines (182 loc) · 7.92 KB

CHANGELOG.md

File metadata and controls

213 lines (182 loc) · 7.92 KB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[2.2.0] - 2026-01-06

Added

  • New *OrThrow() methods in the Validator class that throw an InvalidUrlComponentException on invalid values, complementing the existing methods which return null (e.g. Validator::schemeOrThrow(), Validator::userOrThrow(), Validator::passwordOrThrow(), Validator::hostOrThrow(), Validator::pathOrThrow(), etc.).

Fixed

  • Potential issues found with PHPStan 2 on level 8.
  • Updated lists of public suffixes, schemes and default ports.

Deprecated

  • Validator::callValidationByComponentName() – This method dynamically dispatches to component-specific validation methods (e.g. callValidationByComponentName('scheme', 'https') => Validator::scheme('https')) and is no longer needed. Call the corresponding validation method directly instead (e.g. Validator::scheme()).

[2.1.3] - 2024-11-06

Fixed

  • Improvement for PHP 8.4.
  • Update schemes and suffixes lists.

[2.1.2] - 2024-10-24

Fixed

  • Update schemes and suffixes lists.

[2.1.1] - 2024-01-31

Fixed

  • An issue in the Validator, when trying to validate an absolute input URL that contains non ASCII characters.

[2.1.0] - 2023-10-21

Added

  • Method toPsr7() to conveniently get a PSR-7 compatible instance from an Url instance. Basically wrapper for new Uri($urlInstance).

[2.0.5] - 2023-09-19

Fixed

  • Issue with resolving relative URLs.
  • Update schemes and suffixes lists.

[2.0.4] - 2023-06-28

Fixed

  • Support psr/http-message v2.0.

[2.0.3] - 2023-01-30

Fixed

  • As there is the new query string package, replace the last usage of the Helpers::queryStringToArray() method with the Query class from the package, to not have duplicate logic. Also, the package already contains some fixes.

[2.0.2] - 2023-01-14

Changed

  • Updated lists of schemes, suffixes and default ports.

[2.0.1] - 2022-10-11

Fixed

  • When a URL doesn't contain a subdomain part, the subdomain() method returns null.

[2.0.0] - 2022-09-15

Removed

  • BREAKING: Removed access to URL components (scheme, host, path,...) via magic class properties ($this->scheme, $this->host,...). Use method calls instead ($this->scheme(), $this->host(),...).

Changed

  • Required PHP version is now 8.0.
  • Updated schemes and suffixes lists.

Added

  • As the PHP version requirement allows it now, the crwlr/query-string package now is a dependency of this package and doesn't have to be required separately anymore in order for the Url::queryString() method to work.

[1.2.0] - 2022-06-01

Added

  • The new queryString() method can be used to access and manipulate the query via a Query object when the crwlr/query-string package is installed.

Changed

  • Update schemes and suffixes lists.

[1.1.1] - 2022-01-12

Fixed

  • Resolving relative paths without leading slash against a base URL with an empty path.

Changed

  • Update schemes and suffixes lists.

[1.1.0] - 2021-01-10

Added

  • Static method to create PSR-7 Uri object (Url::parsePsr7('https://...')).

Fixed

  • Error when resolving something to a URL with an empty path.

[1.0.2] - 2022-01-05

Changed

  • Run tests also on PHP 8.1 in CI.
  • Update schemes and suffixes lists.

[1.0.1] - 2021-01-04

Fixed

  • Support for PHP 8.0
    • Minor change in Validator because output of PHP's parse_url is different when a URL includes a delimiter for query or fragment but has no actual query or fragment (followed by empty string).
    • Change PHP version requirement in composer.json.
    • Only relevant for development: Temporarily add PHP_CS_FIXER_IGNORE_ENV=1 to composer cs command until PHP Coding Standards Fixer fully supports PHP 8.0.
  • Getting standard ports for schemes on systems where /etc/services file is missing. PHP's getservbyname() function uses that file and when it's missing the function returns false for all schemes. Fixed that by having a list within the package.

[1.0.0] - 2020-05-11

Added

  • Adapter class Uri that implements the PSR-7 UriInterface.
  • New methods in Url class:
    • authority: Get or set the full authority part of the URL.
    • userInfo: Get or set the full userInfo part of the URL.
    • isRelativeReference: Returns true when the current URL is a relative reference.
    • hasIdn: Returns true when the current URL contains an internationalized domain name in the host component.
    • isEqualTo: Compare the current URL to another one.
    • isComponentEqualIn: Compare some component of the current URL to the same component in another URL. Also with separate methods for all available components:
      • isSchemeEqualIn
      • isAuthorityEqualIn
      • isUserEqualIn
      • isPasswordEqualIn
      • isUserInfoEqualIn
      • isHostEqualIn
      • isDomainEqualIn
      • isDomainLabelEqualIn
      • isDomainSuffixEqualIn
      • isSubdomainEqualIn
      • isPortEqualIn
      • isPathEqualIn
      • isQueryEqualIn
      • isFragmentEqualIn
  • New static validation methods in Validator:
    • authority
    • authorityComponents
    • userInfo
    • userInfoComponents
    • user
    • password (alias method pass)
    • domainLabel
    • callValidationByComponentName
  • Extracted parsing the host part (and registrable domain if contained) to separate classes Host and Domain.
  • New class Helpers with some static helper methods that are used in multiple several classes. Also static access to instances of classes Suffixes and Schemes.
  • New InvalidUrlComponentException that is thrown when you're trying to set an invalid new value for some component.

Changed

  • Required PHP version is now 7.2 because PHP 7.0 and 7.1 are no longer actively supported.
  • Instances of the Url class can now be created from relative references (without scheme). In v0.1 creating a new instance from a relative reference threw an Exception. If your application expects this behavior, you can use the isRelativeReference method of the Url object to find out if the URL in question is a relative reference.
  • All methods in Validator are now static and all the component validation methods (scheme, host,...) now return null instead of false for invalid values. Further Validating a full URL was split into 4 different methods:
    • url: Returns the validated URL as string if input is valid (null if invalid).
    • urlAndComponents: Returns an array with validated URL as string and all single validated URL components ( null if invalid).
    • absoluteUrl: Same as url but only absolute URLs are considered valid.
    • absoluteUrlAndComponents: Same as urlAndComponents but only absolute URLs are valid.
  • Switch to idn_to_ascii and idn_to_utf8 (respectively symfony/polyfill-intl-idn ) to handle parse internationalized domain names.
  • InvalidUrlException now extends UnexpectedValueException instead of Exception.
  • Class Store is now abstract.

Removed

  • Method compare in Url. Use isEqualTo or the other new comparison methods listed under "Added" above.
  • Class Parser. Most still needed code is moved to Helpers class.
  • Move static method getStandardPortByScheme from class Url to class Helpers.
  • Method userOrPassword in Validator. Use methods user or password (pass) instead.

Fixed

  • Version 0.1 had an issue that path, query or fragment could have been double encoded in some cases. This shouldn't happen anymore (see method encodePercentCharacter in Validator).