data 协议

2018-07-24

data://

data:// — 数据（RFC 2397）

说明 ¶

自 PHP 5.2.0 起 data:（» RFC 2397）数据流封装器开始有效。

用法 ¶

data://text/plain;base64,
data:资源类型;编码,内容

1	data:[<mime type>][;charset=<charset>][;base64],<encoded data>

第一部分是 data: 协议头，它标识这个内容为一个 data URI 资源。
第二部分是 MIME 类型，表示这串内容的展现方式，比如：text/plain，则以文本类型展示，image/jpeg，以 jpeg 图片形式展示，同样，客户端也会以这个 MIME 类型来解析数据。
第三部分是编码设置，默认编码是 charset=US-ASCII,即数据部分的每个字符都会自动编码为 %xx，
关于编码的测试，可以在浏览器地址框输入分别输入下面两串内容，查看

效果：// output: ä½ å¥½             ->使用默认的编码展示，故乱码
data:text/html,你好  
// output: 你好 -> 使用 UTF-8 展示
data:text/html;charset=UTF-8,你好
// output: 浣犲ソ -> 使用 gbk 展示（浏览器默认编码 UTF-8，故乱码）
data:text/html;charset=gbk,你好
// output: 你好 -> UTF-8 编码，内容先使用 base64 解码，然后展示
data:text/html;charset=UTF-8;base64,5L2g5aW9

第四部分是 base64编码设定，这是一个可选项，base64 编码中仅包含0-9,a-z,A-Z,+,/,=，其中 = 是用来编码补白的。
最后一部分为这个Data URI承载的内容，它可以是纯文本编写的内容，也可以是经过 base64编码的内容。

data:,<文本数据>
data:text/plain,<文本数据>
data:text/html,<HTML代码>
data:text/html;base64,<base64编码的HTML代码>
data:text/css,<CSS代码>
data:text/css;base64,<base64编码的CSS代码>
data:text/javascript,<Javascript代码>
data:text/javascript;base64,<base64编码的Javascript代码>
data:image/gif;base64,base64编码的gif图片数据
data:image/png;base64,base64编码的png图片数据
data:image/jpeg;base64,base64编码的jpeg图片数据
data:image/x-icon;base64,base64编码的icon图片数据

可选项 ¶

封装协议摘要
|属性 |支持
|- |-
|受限于 allow_url_fopen |No
|受限于 allow_url_include |Yes
|允许读取 |Yes
|允许写入 |No
|允许追加 |No
|允许同时读写 |No
|支持 stat() |No
|支持 unlink() |No
|支持 rename() |No
|支持 mkdir() |No
|支持 rmdir() |No

Example

example1

打印 data:// 的内容

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

example2

获取媒体类型

<?php
$fp   = fopen('data://text/plain;base64,', 'r');
$meta = stream_get_meta_data($fp);
// 打印 "text/plain"
echo $meta['mediatype'];
?>