weew/url

Simple url wrapper.

v2.2.0 2017-02-22 17:29 UTC

Requires

• weew/collections: ^1.0
• weew/contracts: ^1.1
• weew/helpers-array: ^1.0.0
• weew/helpers-string: ^1.0.0
• weew/url-matcher: ^1.1

Requires (Dev)

• phpunit/phpunit: ^4.7
• satooshi/php-coveralls: ^0.6.1

MIT

• Maxim Kott

README

Table of contents

• Installation
• Overview
• Instantiation
• Parsing
• Building
• Matching
• Parsing
• Replacing

Installation

composer require weew/url

Overview

Currently this library is able to parse and build urls of such format and complexity:

// protocol://username:[e-mail]:port/path?key=value#fragment

For example:

// https://john:[e-mail]:8080/my/path?query=value&some=value#hashtag

Instantiation

Creating a new url is very easy:

$url = new Url('http://username:[e-mail]:80/some/path?query=value#fragment');

Parsing

Url containts manny segments which can be accessed trough convenient methods:

echo $url->getProtocol();
// http

echo $url->getHost();
// subdomain.domain.com

echo $url->getDomain();
// domain

echo $url->getSubdomain();
// subdomain

echo $url->getTLD();
// com

echo $url->getPort();
// 80

echo $url->getPath();
// /some/path

echo $url->getQuery();
// query=value

echo $url->getFragment();
// fragment

echo $url->getUsername();
// username

echo $url->getPassword();
// password

Building

You can modify url segments in the same manner.

$url->setProtocol('https');

$url->setHost('another.domain.net');
// or
$url->setDomain('domain');
$url->setSubdomain('another');
$url->setTLD('net');

$url->setPort(8080);
$url->setPath('my/path');
$url->addPath('here');
$url->getQuery()->set('some', 'value');
$url->setFragment('hashtag');
$url->setUsername('john');
$url->setPassword('doe');

echo $url;
// https://john:[e-mail]:8080/my/path/here?query=value&some=value#hashtag

Matching

You can match url path against a pattern.

$url = new Url('users/1');
// true
$url->match('users/{id}');

$url = new Url('users');
// false
$url->match('users/{id}');

Placeholders can be optional by adding the ? sign at the end.

$url = new Url('users/1');
// true
$url->match('users/{id?}');

$url = new Url('users');
// true
$url->match('users/{id?}');

Placeholders can have custom patterns.

$url = new Url('users/1');
// true
$url->match('users/{id}', [
    'id' => '[0-9]+',
]);

$url = new Url('users/abc');
// false
$url->match('users/{id}', [
    'id' => '[0-9]+',
]);

For further documentation check out the weew/url-matcher package;

Parsing

Retrieving placeholder values is very trivial.

$url = new Url('users/1');
$dictionary = $url->parse('users/{id}');
// 1
$dictionary->get('id');

For further documentation check out the weew/url-matcher package;

Replacing

You can replace placeholders inside your path with values.

$url = new Url('{subdomain}.service.com/users/{id}/profile');
$url->replace('subdomain', 'api');
$url->replace('id', 1);

// or 
$url->replaceAll(['subdomain' => 'api', 'id' => 1]);

// api.service.com/users/1/profile
$url->toString();