The League of Extraordinary Packages

Our Packages:

Presented by The League of Extraordinary Packages

Getting Started

Uri parser

Uri schemes

Uri manipulations

Uri components

Upgrading Guide

Data URI

To ease working with Data URIs, the library comes bundle with a URI specific Data class. This class follows RFC2397

Instantiation

In addition to the defined named constructors, because data URI represents files, you can also instantiate a new data URI object from a file path using the createFromPath named constructor

<?php

use League\Uri\Schemes\Data as DataUri;

$uri = DataUri::createFromPath('path/to/my/png/image.png');
echo $uri; //returns 'data:image/png;charset=binary;base64,...'
//where '...' represent the base64 representation of the file

If the file is not readable or accessible an UriException exception will be thrown. The class uses PHP’s finfo class to detect the required mediatype as defined in RFC2045.

Validation

Even though all URI properties are defined and accessible attempt to set any component other than the path will result in the object throwing a UriException exception. As adding data to theses URI parts will generate an invalid Data URI.

<?php

use League\Uri\Schemes\Data as DataUri;

$uri = DataUri::createFromPath('path/to/my/png/image.png');
$uri->getHost(); //return '' an empty string
$uri->withHost('example.com'); // will throw an League\Uri\Schemes\UriException