1tomany / data-uri

v7.0.3 2026-09-16 20:10 UTC

Requires

• php: >=8.5
• ext-ctype: *
• ext-fileinfo: *
• ext-mbstring: *
• symfony/config: ^7.2|^8.0|^8.1
• symfony/console: ^7.2|^8.0|^8.1
• symfony/dependency-injection: ^7.2|^8.0|^8.1
• symfony/filesystem: ^7.2|^8.0|^8.1
• symfony/http-kernel: ^7.2|^8.0|^8.1
• symfony/serializer: ^7.2|^8.0|^8.1

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.93
• mikey179/vfsstream: ^1.6
• phpstan/phpstan: ^2.1.55
• phpunit/phpunit: ^13.1.11

Replaces

• 1tomany/data-uri-bundle: *

MIT

• Vic Cherubini

• symfony
• dataURI
• data-uri
• data uri
• rfc 2397
• rfc2397
• 2397

Published on Packagist.org on 2026-09-16 20:11 UTC

README

This simple library allows you to easily convert a wide variety of data into a temporary file represented by a lightweight immutable value object. It also includes Symfony bundle integration for autowiring, serialization, and console usage.

Installation

composer require 1tomany/data-uri

API Overview

The three methods exposed by this library are:

• OneToMany\DataUri\DataDecoder::decode()
• OneToMany\DataUri\DataDecoder::decodeBase64()
• OneToMany\DataUri\DataDecoder::decodeText()

Each method returns a OneToMany\DataUri\Record\TemporaryFile value object which implements the interface OneToMany\DataUri\Contract\Record\TemporaryFileInterface. By default, the TemporaryFile object will delete any filesystem resources it knows about when it is explicitly destructed or garbage collected.

The DataDecoder::decode() method is the most versatile as it allows for a wide variety of inputs:

• A data URI defined in RFC2397
• A file from an accessible filesystem
• A public HTTP or HTTPS URL

DataDecoder::decode()

The DataDecoder::decode() method has the following arguments:

• mixed $data The data, file, or URL to decode.
• string|FileType|null $type = null The MIME type of the temporary file. If empty, the type will be determined using either the file's extension or the mime_content_type() function. You may want to explicitly provide this argument when the file can be multiple types. For example, mime_content_type() may return text/plain for Markdown files, which is correct, however, you may wish to use the more specific MIME type text/markdown.
• string|null $name = null The name for the temporary file. This is useful for handling file uploads where the original filename is preferred over the random one PHP assigns. A randomly generated name will be used if this is empty and a name cannot be resolved.

Inside DataDecoder::decode()

Under the hood, DataDecoder::decode() uses the fopen() and stream_get_contents() functions, which means the data passed to it can be any stream that PHP supports.

DataDecoder::decodeBase64()

This method is to be used when the data is known to be base64 encoded but NOT encoded as a data URI.

The DataDecoder::decodeBase64() method has the following parameters:

• string $data The base64 encoded string.
• string|FileType $type The MIME type of the data.
• string|null $name = null See DataDecoder::decode().

DataDecoder::decodeText()

This method is to be used when the data is known to be plaintext.

The DataDecoder::decodeText() method has the following arguments:

• string $text The plaintext string.
• string|FileType $type = FileType::Txt The MIME type of the text.
• string|null $name = null See DataDecoder::decode().

Symfony Integration

The package includes OneToMany\DataUri\DataUriBundle. Symfony Flex enables it automatically after installation, and OneToMany\DataUri\DataDecoder can then be autowired without additional service configuration:

<?php

use OneToMany\DataUri\DataDecoder;

final readonly class DecodeData
{
    public function __construct(
        private DataDecoder $dataDecoder,
    ) {
    }
}

No bundle configuration is necessary. The bundle also:

• registers OneToMany\DataUri\Serializer\TemporaryFileNormalizer with Symfony's Serializer component
• provides the onetomany:data-uri:encode-file console command for converting a file to a base64-encoded data URI

The framework-independent API remains available by constructing DataDecoder directly.

Examples

Run and inspect the decode.php file for examples on how to use the DataDecoder::decode() method.

php examples/decode.php [--all]

Credits

• Vic Cherubini, 1:N Labs, LLC

License

The MIT License