webignition / absolute-url-deriver
Derives an absolute URL from relative and source URLs
Installs: 14 359
Dependents: 11
Suggesters: 0
Security: 0
Stars: 13
Watchers: 3
Forks: 1
Open Issues: 0
Requires
- php: >=7.2
- webignition/uri: >=0.3,<1
Requires (Dev)
README
Overview
Derives absolute URL from relative and source URLs.
Useful when:
- extracting full HREF URLs for links in a HTML document
- determining absolute new URL for a 301 redirect where the HTTP server returned a relative Location value
Usage
The "Hello World" example
<?php use webignition\AbsoluteUrlDeriver\AbsoluteUrlDeriver; use webignition\Uri\Uri; $base = 'https://example.com'; $relative = '/path?query#fragment'; $this->assertEquals( 'https://example.com/path?query#fragment', AbsoluteUrlDeriver::derive(new Uri($base), new Uri($relative)) );
Building
Using as a library in a project
If used as a dependency by another project, update that project's composer.json and update your dependencies.
"require": {
"webignition/absolute-url-deriver": ">=3,<4"
}
Developing
This project has external dependencies managed with composer. Get and install this first.
# Make a suitable project directory
mkdir ~/absolute-url-deriver && cd ~/absolute-url-deriver
# Clone repository
git clone git@github.com:webignition/absolute-url-deriver.git .
# Retrieve/update dependencies
composer install
Testing
Have look at the project on travis for the latest build status, or give the tests a go yourself.
cd ~/absolute-url-deriver
phpunit tests