好的，各位亲爱的观众，欢迎来到“PHP魔法学院”！🧙♂️ 今天我们要学习的科目是——“PHP Stream：I/O流处理”！ 别担心，这可不是什么晦涩难懂的魔咒，而是一种让你操控数据“河流”的强大力量！🌊
第一章：Stream的“前世今生”——什么是Stream？
话说江湖上流传着一句话：“有水的地方，就有江湖。” 在计算机的世界里，数据就是水，而Stream就是一条条蜿蜒曲折的河流，连接着不同的数据源头和目的地。
想象一下，你要把一个大文件从硬盘搬到服务器，或者从网络上下载一张精美壁纸，亦或是把用户输入的数据保存到数据库。这些过程都需要数据的流动，而Stream就是负责控制这些流动的“水管工”。 👷♂️
那么，Stream到底是什么呢？
简而言之，Stream是PHP中一种抽象的I/O（Input/Output，输入/输出）接口。它提供了一种统一的方式来处理不同类型的数据源和目标，比如：
- 文件（file://）
- 网络连接（http://, ftp://, socket://）
- 内存数据（php://memory, php://temp）
- 压缩文件（zlib://, bzip2://）
- 加密数据（openssl://）
- 标准输入/输出（php://stdin, php://stdout, php://stderr）
看到了吗？Stream就像一个“万能转换器”，可以把各种各样的数据源变成统一的“流”，让你用相同的方式去读取和写入。
为什么我们需要Stream？
如果没有Stream，你可能需要针对每一种数据源编写不同的代码。比如，读取文件用fopen()，下载网页用curl，操作数据库用mysqli_*函数。这简直是程序员的噩梦！ 🤯
有了Stream，你就可以用一套简单的API（Application Programming Interface，应用程序编程接口）来处理所有这些情况，代码更简洁，可维护性更高，简直不要太爽！ 😎
第二章：Stream的“十八般武艺”——Stream API详解
Stream API就像一套精妙的武功，掌握了它，你就能轻松驾驭数据的流动。让我们来学习一下Stream API的“十八般武艺”吧！
1. 打开你的“任督二脉”——fopen()
fopen()函数是打开Stream的“钥匙”。它接受两个主要的参数：
$filename：你要打开的数据源的URL，比如"file://data.txt"，"http://example.com"。$mode：打开Stream的模式，比如"r"（只读），"w"（只写），"a"（追加）。
<?php
// 打开一个文件进行读取
$handle = fopen("file://data.txt", "r");
if ($handle) {
// 读取文件内容
while (($line = fgets($handle)) !== false) {
echo $line;
}
// 关闭文件
fclose($handle);
} else {
echo "无法打开文件！";
}
// 打开一个URL进行读取
$handle = fopen("http://example.com", "r");
if ($handle) {
// 读取网页内容
$content = stream_get_contents($handle);
echo $content;
// 关闭连接
fclose($handle);
} else {
echo "无法打开URL！";
}
?>就像武侠小说里打通任督二脉一样，fopen()函数会返回一个资源类型的“Stream上下文”（Stream Context），你可以用它来读取和写入数据。
2. 读取数据的“乾坤大挪移”——fread(), fgets(), fgetc(), stream_get_contents()
有了Stream上下文，你就可以用这些函数来读取数据了：
fread($handle, $length)：从Stream中读取指定长度的字节。fgets($handle)：从Stream中读取一行数据。fgetc($handle)：从Stream中读取一个字符。stream_get_contents($handle)：从Stream中读取所有剩余的内容。
<?php
$handle = fopen("file://data.txt", "r");
if ($handle) {
// 读取10个字节
$data = fread($handle, 10);
echo "读取10个字节：" . $data . "<br>";
// 读取一行
$line = fgets($handle);
echo "读取一行：" . $line . "<br>";
// 读取一个字符
$char = fgetc($handle);
echo "读取一个字符：" . $char . "<br>";
// 读取所有剩余内容
$content = stream_get_contents($handle);
echo "读取所有剩余内容：" . $content . "<br>";
fclose($handle);
}
?>这些函数就像武侠小说里的“乾坤大挪移”，可以让你随心所欲地从Stream中获取数据。
3. 写入数据的“排山倒海”——fwrite(), fputs()
fwrite()和fputs()函数是向Stream中写入数据的“利器”。它们接受两个主要的参数：
$handle：Stream上下文。$string：要写入的数据。
<?php
$handle = fopen("file://output.txt", "w");
if ($handle) {
// 写入数据
fwrite($handle, "Hello, world!n");
fputs($handle, "This is a test.n");
fclose($handle);
echo "数据写入成功！";
} else {
echo "无法打开文件进行写入！";
}
?>这两个函数就像武侠小说里的“排山倒海”，可以让你把数据像海啸一样倾泻到Stream中。
4. “关门放狗”——fclose()
fclose()函数是关闭Stream的“闸门”。用完Stream之后，一定要记得关闭它，释放资源。
<?php
$handle = fopen("file://data.txt", "r");
if ($handle) {
// ... 读取数据 ...
// 关闭Stream
fclose($handle);
echo "Stream已关闭！";
}
?>“关门放狗”是个玩笑，但关闭Stream可不是玩笑！ 否则，你的程序可能会消耗大量资源，甚至崩溃。 😱
5. “窥探天机”——stream_get_meta_data()
stream_get_meta_data()函数可以让你获取Stream的元数据，比如：
timed_out：是否超时。blocked：是否阻塞。unread_bytes：未读取的字节数。stream_type：Stream的类型。wrapper_type：封装器的类型。wrapper_data：封装器的数据。
<?php
$handle = fopen("http://example.com", "r");
if ($handle) {
$meta_data = stream_get_meta_data($handle);
print_r($meta_data);
fclose($handle);
}
?>这个函数就像武侠小说里的“窥探天机”，可以让你了解Stream的内部状态。
6. “移形换影”——stream_context_create(), stream_context_set_option()
stream_context_create()函数可以创建一个Stream上下文资源，stream_context_set_option()函数可以设置Stream上下文的选项。
<?php
// 创建一个Stream上下文
$context = stream_context_create();
// 设置HTTP请求头的User-Agent
stream_context_set_option($context, "http", "user_agent", "My Custom User Agent");
// 打开一个URL，使用自定义的Stream上下文
$handle = fopen("http://example.com", "r", false, $context);
if ($handle) {
$content = stream_get_contents($handle);
echo $content;
fclose($handle);
}
?>这两个函数就像武侠小说里的“移形换影”，可以让你改变Stream的行为，实现更高级的功能。
第三章：Stream的“七十二变”——Stream Wrapper
Stream Wrapper是Stream的“七十二变”，它可以让你像操作本地文件一样操作各种各样的数据源。
PHP内置了很多Stream Wrapper，比如：
file://：本地文件系统。http://：HTTP URL。ftp://：FTP URL。php://stdin：标准输入。php://stdout：标准输出。php://memory：内存数据流。php://temp：临时文件流。data://：数据URL。glob://：查找匹配的文件路径。zlib://：压缩数据流。bzip2://：Bzip2压缩数据流。ssh2.sftp://：SSH2安全文件传输协议。rar://：RAR压缩文件。
你也可以自定义Stream Wrapper，实现更复杂的功能。
举个例子：使用http:// Stream Wrapper下载网页
<?php
// 使用http:// Stream Wrapper下载网页
$content = file_get_contents("http://example.com");
echo $content;
?>是不是很简单？就像读取本地文件一样！ 😎
再举个例子：使用php://stdin Stream Wrapper读取用户输入
<?php
// 使用php://stdin Stream Wrapper读取用户输入
echo "请输入你的名字：";
$name = trim(fgets(fopen("php://stdin", "r")));
echo "你好，" . $name . "！";
?>这个例子演示了如何使用php://stdin Stream Wrapper来读取用户在命令行中的输入。
最后举个例子：使用data:// Stream Wrapper嵌入图片
<?php
// 使用data:// Stream Wrapper嵌入图片
$image_data = base64_encode(file_get_contents("image.png"));
$image_src = "data:image/png;base64," . $image_data;
echo "<img src='" . $image_src . "'>";
?>这个例子演示了如何使用data:// Stream Wrapper将图片嵌入到HTML代码中，而不需要单独上传图片文件。
第四章：Stream的“葵花宝典”——Stream Filter
Stream Filter是Stream的“葵花宝典”，它可以让你在读取和写入数据的时候对数据进行过滤和转换。
PHP内置了很多Stream Filter，比如：
string.rot13：ROT13编码/解码。string.toupper：转换为大写。string.tolower：转换为小写。string.strip_tags：去除HTML标签。convert.base64-encode：Base64编码。convert.base64-decode：Base64解码。convert.quoted-printable-encode：Quoted-printable编码。convert.quoted-printable-decode：Quoted-printable解码。zlib.inflate：解压缩。zlib.deflate：压缩。
你也可以自定义Stream Filter，实现更复杂的转换。
举个例子：使用string.rot13 Stream Filter加密数据
<?php
// 创建一个临时文件
$temp = tmpfile();
// 向临时文件中写入数据
fwrite($temp, "Hello, world!");
// 重置文件指针
rewind($temp);
// 应用string.rot13 Stream Filter
stream_filter_append($temp, "string.rot13", STREAM_FILTER_READ);
// 读取加密后的数据
$encrypted_data = stream_get_contents($temp);
echo "加密后的数据：" . $encrypted_data . "<br>";
// 关闭临时文件
fclose($temp);
?>这个例子演示了如何使用string.rot13 Stream Filter对数据进行加密。
再举个例子：使用convert.base64-encode Stream Filter编码数据
<?php
// 创建一个临时文件
$temp = tmpfile();
// 向临时文件中写入数据
fwrite($temp, "Hello, world!");
// 重置文件指针
rewind($temp);
// 应用convert.base64-encode Stream Filter
stream_filter_append($temp, "convert.base64-encode", STREAM_FILTER_READ);
// 读取编码后的数据
$encoded_data = stream_get_contents($temp);
echo "Base64编码后的数据：" . $encoded_data . "<br>";
// 关闭临时文件
fclose($temp);
?>这个例子演示了如何使用convert.base64-encode Stream Filter对数据进行Base64编码。
第五章：Stream的“实战演练”——Stream的应用场景
Stream的应用场景非常广泛，让我们来看几个实际的例子：
1. 文件上传
<?php
// 获取上传的文件名
$filename = $_FILES["file"]["name"];
// 获取上传的临时文件名
$temp_file = $_FILES["file"]["tmp_name"];
// 打开上传的临时文件
$source = fopen($temp_file, "r");
// 打开目标文件
$destination = fopen("uploads/" . $filename, "w");
// 将数据从临时文件复制到目标文件
stream_copy_to_stream($source, $destination);
// 关闭文件
fclose($source);
fclose($destination);
echo "文件上传成功！";
?>这个例子演示了如何使用Stream API来实现文件上传功能。
2. 下载文件
<?php
// 要下载的文件URL
$file_url = "http://example.com/file.zip";
// 设置HTTP请求头
header("Content-Type: application/zip");
header("Content-Disposition: attachment; filename=file.zip");
// 打开文件
$source = fopen($file_url, "r");
// 将文件内容输出到浏览器
fpassthru($source);
// 关闭文件
fclose($source);
exit;
?>这个例子演示了如何使用Stream API来实现文件下载功能。
3. 处理大型CSV文件
<?php
// 打开CSV文件
$handle = fopen("data.csv", "r");
if ($handle) {
// 循环读取每一行
while (($data = fgetcsv($handle, 1000, ",")) !== false) {
// 处理每一行数据
$num = count($data);
echo "<p> $num fields in line " . $row . ": <br></p>n";
$row++;
for ($c=0; $c < $num; $c++) {
echo $data[$c] . "<br>n";
}
}
// 关闭文件
fclose($handle);
}
?>这个例子演示了如何使用Stream API来处理大型CSV文件，避免一次性将整个文件加载到内存中。
第六章：Stream的“注意事项”——Stream的坑
虽然Stream很强大，但也有一些需要注意的地方：
- 资源管理： 使用完Stream之后，一定要记得关闭它，释放资源。
- 错误处理： 在使用Stream API的时候，要做好错误处理，避免程序崩溃。
- 性能优化： 在处理大型数据的时候，要注意性能优化，比如使用缓冲区，避免频繁的I/O操作。
- 安全性： 在处理用户输入的数据的时候，要注意安全性，避免安全漏洞。
结语：
恭喜各位！🎉 经过今天的学习，你们已经掌握了PHP Stream的“十八般武艺”，可以开始用它来操控数据的“河流”了！ 🌊
记住，Stream是一种强大的工具，可以让你更高效地处理各种各样的数据源和目标。 但是，也要注意Stream的“坑”，避免掉入陷阱。
希望今天的课程对你有所帮助！ 如果你还有什么问题，欢迎随时提问。 我们下次再见！ 👋