略微加速

PHP官方手册 - 互联网笔记

PHP - Manual: streamWrapper

2025-10-31

streamWrapper 类

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

简介

允许实现自定义协议处理程序和流，以便与其它文件系统函数（比如 fopen()、 fread() 等）一起使用。

注意:

这不是真实的类，只是如何定义协议的原型类。

注意:

不使用此处描述的方法而使用其它方式可能会导致未定义行为。

一旦流函数尝试访问与其关联的协议，就会初始化此类的实例。

类摘要

class streamWrapper {
/* 属性 */
public resource $context;
/* 方法 */
public __construct()
public dir_closedir(): bool
public dir_opendir(string $path, int $options): bool
public dir_readdir(): string
public dir_rewinddir(): bool
public mkdir(string $path, int $mode, int $options): bool
public rename(string $path_from, string $path_to): bool
public rmdir(string $path, int $options): bool
public stream_cast(int $cast_as): resource
public stream_close(): void
public stream_eof(): bool
public stream_flush(): bool
public stream_lock(int $operation): bool
public stream_metadata(string $path, int $option, mixed $value): bool
public stream_open(
    string $path,
    string $mode,
    int $options,
    ?string &$opened_path
): bool
public stream_read(int $count): string|false
public stream_seek(int $offset, int $whence = SEEK_SET): bool
public stream_set_option(int $option, int $arg1, int $arg2): bool
public stream_stat(): array|false
public stream_tell(): int
public stream_truncate(int $new_size): bool
public stream_write(string $data): int
public unlink(string $path): bool
public url_stat(string $path, int $flags): array|false
public __destruct()
}

属性

资源 context

当前 context，或者没有 context 传递给调用函数，则为 null。

使用 stream_context_get_options() 解析 context。

注意:

此属性必须是 public，以便 PHP 可以使用使用实际的 context 资源填充它。

参见

目录

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误
＋添加备注

用户贡献的备注 4 notes

up
14
isaac dot z dot no dot foster at spam dot gmail dot please dot com
14 years ago
It's worth noting that the interface defined by yannick at gmail should not always be implemented by a stream wrapper class, as several of the methods should not be implemented if the class has no use for them (as per the manual).

Specifically, mkdir, rename, rmdir, and unlink are methods that "should not be defined" if the wrapper has no use for them. The consequence is that the appropriate error message will not be returned.

If the interface is implemented, you won't have the flexibility to not implement those methods.

Not trying to be academic, but it was useful for me.
up
1
info at ensostudio dot ru
4 years ago
THIS METHODS NOT REQUIRED, you can implement only part of their: directories, files, etc.
For example, "glob://" support minimal syntax, glob() more powerful, you can replace/extend native wrapper: check options in table https://www.php.net/manual/ru/wrappers.glob , you need create wrapper only with 'dir_...dir' methods. For more info, see https://www.php.net/manual/en/class.globiterator.php#125220
up
2
Anonymous
13 years ago
Here is a very simple stream wrapper which calls your callback function for reads:

<?php

class CallbackUrl
{
const WRAPPER_NAME = 'callback';

public $context;
private $_cb;
private $_eof = false;

private static $_isRegistered = false;

public static function getContext($cb)
{
if (!self::$_isRegistered) {
stream_wrapper_register(self::WRAPPER_NAME, get_class());
self::$_isRegistered = true;
}
if (!is_callable($cb)) return false;
return stream_context_create(array(self::WRAPPER_NAME => array('cb' => $cb)));
}

public function stream_open($path, $mode, $options, &$opened_path)
{
if (!preg_match('/^r[bt]?$/', $mode) || !$this->context) return false;
$opt = stream_context_get_options($this->context);
if (!is_array($opt[self::WRAPPER_NAME]) ||
!isset($opt[self::WRAPPER_NAME]['cb']) ||
!is_callable($opt[self::WRAPPER_NAME]['cb'])) return false;
$this->_cb = $opt[self::WRAPPER_NAME]['cb'];
return true;
}

public function stream_read($count)
{
if ($this->_eof || !$count) return '';
if (($s = call_user_func($this->_cb, $count)) == '') $this->_eof = true;
return $s;
}

public function stream_eof()
{
return $this->_eof;
}
}

class Test {
private $_s;
public function __construct($s)
{
$this->_s = $s;
}
public function read($count) {
return fread($this->_s, $count);
}
}

$t = new Test(fopen('/etc/services', 'r'));
$fd = fopen('callback://', 'r', false, CallbackUrl::getContext(array($t, 'read')));
while(($buf = fread($fd, 128)) != '') {
print $buf;
}
?>
up
2
yannick dot battail at gmail dot com
15 years ago
a php interface for wrapper

<?php
interface WrapperInterface
{
/**
* resource context
*
* @var resource
*/
//public $context;

/**
* constructor
*
*/
public function __construct();

/**
*
*
* @return bool
*/
public function dir_closedir();

/**
* Enter description here...
*
* @param string $path
* @param int $options
* @return bool
*/
public function dir_opendir($path , $options);

/**
* Enter description here...
*
* @return string
*/
public function dir_readdir();

/**
* Enter description here...
*
* @return bool
*/
public function dir_rewinddir();

/**
* Enter description here...
*
* @param string $path
* @param int $mode
* @param int $options
* @return bool
*/
public function mkdir($path , $mode , $options);

/**
* Enter description here...
*
* @param string $path_from
* @param string $path_to
* @return bool
*/
public function rename($path_from , $path_to);

/**
* Enter description here...
*
* @param string $path
* @param int $options
* @return bool
*/
public function rmdir($path , $options);

/**
* Enter description here...
*
* @param int $cast_as
* @return resource
*/
public function stream_cast($cast_as);

/**
* Enter description here...
*
*/
public function stream_close();

/**
* Enter description here...
*
* @return bool
*/
public function stream_eof();

/**
* Enter description here...
*
* @return bool
*/
public function stream_flush();

/**
* Enter description here...
*
* @param mode $operation
* @return bool
*/
public function stream_lock($operation);

/**
* Enter description here...
*
* @param string $path
* @param string $mode
* @param int $options
* @param string &$opened_path
* @return bool
*/
public function stream_open($path , $mode , $options , &$opened_path);

/**
* Enter description here...
*
* @param int $count
* @return string
*/
public function stream_read($count);

/**
* Enter description here...
*
* @param int $offset
* @param int $whence = SEEK_SET
* @return bool
*/
public function stream_seek($offset , $whence = SEEK_SET);

/**
* Enter description here...
*
* @param int $option
* @param int $arg1
* @param int $arg2
* @return bool
*/
public function stream_set_option($option , $arg1 , $arg2);

/**
* Enter description here...
*
* @return array
*/
public function stream_stat();

/**
* Enter description here...
*
* @return int
*/
public function stream_tell();

/**
* Enter description here...
*
* @param string $data
* @return int
*/
public function stream_write($data);

/**
* Enter description here...
*
* @param string $path
* @return bool
*/
public function unlink($path);

/**
* Enter description here...
*
* @param string $path
* @param int $flags
* @return array
*/
public function url_stat($path , $flags);
}

?>
＋添加备注

官方地址：https://www.php.net/manual/en/class.streamwrapper.php

有任何技术问题请点击这里 网站运营推广招聘
IT PHP 编程语言 开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试 数据库 网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法 正则表达式 Redis 互联网 MySql 软件 运维 JavaScript 国际 架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR MongoDB 运营 Python MemCache 商业 硬件 电子 娱乐 设计 摄影 nginx WordPress 游戏 HTTP 团建 数码电器 Docker
冷却塔厂家 广告
php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南 使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象 常用的php ADODB使用方法集锦 ADOConnection 公用函数 利用php soap实现web service adodb连接mysql多个数据库的问题 mysql面试题 [PHP] inet_pton/inet_ntop IP地址转换函数 PHP json解析（json_decode）页面工具 PHP7添加redis扩展 PHP注释规范
联系我们 半月雨文化 可降解耗材网 蓝云环保 78免费小説 上海网站seo优化 工程造价 币安app官网下载 币安app官网下载 coinbase GamestoPlayatWork 明星排行榜 seo查询
北京半月雨文化科技有限公司.版权所有 京ICP备12026184号-3