data://

data:// — Data (RFC 2397)

Description

The data: (» RFC 2397) stream wrapper.

Usage

data://text/plain;base64,

Options

**Wrapper Summary**
Attribute	Supported
Restricted by allow_url_fopen	Yes
Restricted by allow_url_include	Yes
Allows Reading	Yes
Allows Writing	No
Allows Appending	No
Allows Simultaneous Reading and Writing	No
Supports stat()	No
Supports unlink()	No
Supports rename()	No
Supports mkdir()	No
Supports rmdir()	No

Examples

Example #1 Print data:// contents

<?php
// prints "I love PHP"
echo file_get_contents('data://text/plain;base64,SSBsb3ZlIFBIUAo=');
?>

Example #2 Fetch the media type

<?php
$fp   = fopen('data://text/plain;base64,', 'r');
$meta = stream_get_meta_data($fp);

// prints "text/plain"
echo $meta['mediatype'];
?>

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 3 notes

down

from dot php dot net at brainbox dot cz ¶

14 years ago

When passing plain string without base64 encoding, do not forget to pass the string through URLENCODE(), because PHP automatically urldecodes all entities inside passed string (and therefore all + get lost, all % entities will be converted to the corresponding characters).



In this case, PHP is strictly compilant with the RFC 2397. Section 3 states that passes data should be either in base64 encoding or urlencoded.



VALID USAGE:

<?php

$fp = fopen('data:text/plain,'.urlencode($data), 'rb'); // urlencoded data

$fp = fopen('data:text/plain;base64,'.base64_encode($data), 'rb'); // base64 encoded data

?>



Demonstration of invalid usage:

<?php

$data = 'Günther says: 1+1 is 2, 10%40 is 20.';



$fp = fopen('data:text/plain,'.$data, 'rb'); // INVALID, never do this

echo stream_get_contents($fp);

// Günther says: 1 1 is 2, 10@ is 20. // ERROR



$fp = fopen('data:text/plain,'.urlencode($data), 'rb'); // urlencoded data

echo stream_get_contents($fp);

// Günther says: 1+1 is 2, 10%40 is 20. // OK



// Valid option 1: base64 encoded data

$fp = fopen('data:text/plain;base64,'.base64_encode($data), 'rb'); // base64 encoded data

echo stream_get_contents($fp);

// Günther says: 1+1 is 2, 10%40 is 20. // OK

?>

down

admin deskbitz net ¶

14 years ago

If you want to create a gd-image directly out of a sql-database-field you might want to use:



<?php

$jpegimage = imagecreatefromjpeg("data://image/jpeg;base64," . base64_encode($sql_result_array['imagedata']));

?>



this goes also for gif, png, etc using the correct "imagecreatefrom$$$"-function and mime-type.

down

sandaimespaceman at gmail dot com ¶

16 years ago

Now PHP supports data: protocol w/out "//" like data:text/plain, not data://text/plain,

I tried it.

＋add a note