Comment utiliser les flux et le wrapper de PHP-tutoriel php-php.cn

Aujourd'hui, je vais vous parler des concepts et de l'utilisation des flux et wrappers PHP. Permettez-moi de le résumer pour tout le monde.

Nous savons que le concept de flux a été introduit dans php4.3. Il s'agit d'une abstraction de données en streaming et est utilisé pour unifier les opérations de données, telles que les données de fichiers, les données réseau, les données compressées, etc. que les mêmes données peuvent être partagées. Un ensemble de fonctions, les fonctions du système de fichiers de PHP sont un tel partage. Par exemple, la fonction file_get_contents() peut ouvrir des fichiers locaux et accéder aux URL. Pour faire simple, un flux est un objet ressource qui présente un comportement de données en continu.

Lisez et écrivez de manière linéaire et pouvez effectuer une recherche n'importe où dans le flux.

Le flux est quelque peu similaire à la couche d'abstraction de la base de données. En termes de couche d'abstraction de la base de données, quelle que soit la base de données utilisée, les données sont exploitées de la même manière au-dessus de la couche d'abstraction. les données. Peu importe qu'elles soient locales. Qu'il s'agisse d'un fichier, d'un fichier distant, d'un fichier compressé, etc., tant qu'il s'agit de données en streaming, la méthode de fonctionnement est la même.

Avec le concept de stream, le concept de wrapper est dérivé. Chaque flux correspond à une sorte de wrapper. Le flux est un concept généré dans une perspective de fonctionnement unifié, et le wrapper est dérivé de la compréhension de. Un concept découlant du contenu des données en streaming, c'est-à-dire comment cette méthode de fonctionnement unifiée fonctionne ou configure différents contenus

Ces contenus sont tous présentés en streaming, mais les règles de contenu sont différentes, comme http ; Les données transmises par le protocole se présentent sous la forme d'un flux, mais seul le wrapper http comprend la signification des données transmises par le protocole http. On peut comprendre qu'un flux est un tuyau avec de l'eau qui coule, mais ce qui en sort. sont des données, et le wrapper est le package. Un interprète à l'extérieur du canal de flux qui comprend la signification des données qui sortent et peut les manipuler.

Le manuel officiel dit : "Un wrapper est un code supplémentaire qui indique au flux comment gérer un protocole ou un encodage spécial." Comprenez-vous ce que signifie cette phrase ?

L'emballage peut être emboîté. Une fois qu'un flux est enveloppé dans un emballage, il peut également être enveloppé dans la couche externe. À ce stade, l'emballage intérieur agit comme un flux par rapport à l'emballage extérieur
Le. Le document de développement du langage C implémenté au bas de PHP lui-même a cette explication :

L'API stream opère à deux niveaux différents : au niveau de base, l'API définit l'objet php_stream pour représenter la source de données de streaming, et à un niveau légèrement supérieur Au niveau, l'API définit l'objet php_stream_wrapper.

Il enveloppe l'objet php_stream de niveau inférieur pour offrir la possibilité de récupérer le contenu et les métadonnées de l'URL, d'ajouter des paramètres de contexte et d'ajuster le comportement du wrapper

Chaque flux est ouvert Vous pouvez ; appliquez n'importe quel nombre de filtres dessus, et les données du flux seront traitées par le filtre. Je pense que le filtre de mots est un peu inexact et trompeur.

Le sens littéral semble être de supprimer certaines données. Il devrait être appelé un ajusteur de données, car il peut supprimer certaines données, les ajouter et les modifier. Cependant, pour des raisons historiques, il est également appelé. un ajusteur de données. C’est un filtre, et tout le monde a juste besoin de le comprendre.

Nous voyons souvent les mots suivants pour expliquer leurs différences :

Ressources et données : les ressources sont un terme plus macro, incluant généralement des données, tandis que les données sont un terme plus concret lors du développement de programmes. on dit souvent qu'il s'agit de données, alors que dans la planification logicielle, on dit que ce sont des ressources. Ce sont des synonymes, tout comme la différence entre la conception de logiciels et le développement de programmes.

Contexte et paramètres : le contexte est un terme relativement macro, souvent utilisé dans la communication. Plus précisément, il s'agit des paramètres d'une communication elle-même, et le terme paramètre est souvent utilisé dans des choses plus spécifiques, telles que les fonctions

Les éléments conceptuels sont expliqués ci-dessus, jetons un coup d'œil au contenu spécifique :

Veuillez consulter ici les protocoles et les wrappers pris en charge par php : http://php.net/manual/zh/ wrappers .php :

(Note de l'auteur : Le titre original est : Protocoles pris en charge et protocoles d'emballage. La traduction chinoise est un peu trompeuse. Pour être précis, il s'agit des protocoles et wrappers pris en charge. C'est très clair à partir de la page anglaise )
Prise en charge par défaut Il existe certains protocoles et wrappers, veuillez utiliser la fonction stream_get_wrappers() pour afficher Vous pouvez également personnaliser un wrapper et l'enregistrer avec stream_wrapper_register()
Bien que la RFC 3986 puisse utiliser : comme délimiteur, PHP. autorise uniquement ://, Veuillez donc utiliser le format "scheme://target" pour l'URL

file:// — 访问本地文件系统，在用文件系统函数时默认就使用该包装器
http:// — 访问 HTTP(s) 网址
ftp:// — 访问 FTP(s) URLs
php:// — 访问各个输入/输出流（I/O streams）
zlib:// — 压缩流
data:// — 数据（RFC 2397）
glob:// — 查找匹配的文件路径模式
phar:// — PHP 归档
ssh2:// — Secure Shell 2
rar:// — RAR
ogg:// — 音频流
expect:// — 处理交互式的流

Copier après la connexion

Comment implémenter un wrapper personnalisé :

Utiliser fopen, fwrite, fread , fgets, feof, Lorsque les fonctions du système de fichiers telles que rewind, file_put_contents, file_get_contents, etc. fonctionnent sur des flux, les données sont d'abord transmises à l'objet de classe wrapper défini, puis le wrapper opère sur le flux.

Comment implémenter un wrapper de flux personnalisé ? PHP fournit un prototype de classe, qui n'est qu'un prototype, pas une interface ou une classe, et ne peut pas être utilisé pour l'héritage :

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

Copier après la connexion

在这个原型里面定义的方法，根据自己需要去定义，并不要求全部实现，这就是为什么不定义成接口的原因，因为有些实现根本用不着某些方法，
这带来很多灵活性，比如包装器是不支持删除目录rmdir功能的，那么就不需要实现streamWrapper::rmdir
由于未实现它，如果用户在包装器上调用rmdir将有错误抛出，要自定义这个错误那么也可以实现它并在其内部抛出错误
streamWrapper也不是一个预定义类，测试class_exists("streamWrapper")就知道，它只是一个指导开发者的原型

官方手册提供了一个例子：http://php.net/manual/zh/stream.streamwrapper.example-1.php

本博客提供一个从drupal8系统中抽取修改过的包装器例子，请看drupal8源码分析关于流那一部分

流系列函数，官方手册：http://php.net/manual/zh/ref.stream.php

常用的函数如下：

stream_bucket_append函数：为队列添加数据　
stream_bucket_make_writeable函数：从操作的队列中返回一个数据对象
stream_bucket_new函数：为当前队列创建一个新的数据
stream_bucket_prepend函数：预备数据到队列　
stream_context_create函数：创建数据流上下文
stream_context_get_default函数：获取默认的数据流上下文
stream_context_get_options函数：获取数据流的设置
stream_context_set_option函数：对数据流、数据包或者上下文进行设置
stream_context_set_params函数：为数据流、数据包或者上下文设置参数
stream_copy_to_stream函数：在数据流之间进行复制操作
stream_filter_append函数：为数据流添加过滤器
stream_filter_prepend函数：为数据流预备添加过滤器
stream_filter_register函数：注册一个数据流的过滤器并作为PHP类执行
stream_filter_remove函数：从一个数据流中移除过滤器
stream_get_contents函数：读取数据流中的剩余数据到字符串
stream_get_filters函数：返回已经注册的数据流过滤器列表
stream_get_line函数：按照给定的定界符从数据流资源中获取行
stream_get_meta_data函数：从封装协议文件指针中获取报头/元数据
stream_get_transports函数：返回注册的Socket传输列表
stream_get_wrappers函数：返回注册的数据流列表
stream_register_wrapper函数：注册一个用PHP类实现的URL封装协议
stream_select函数：接收数据流数组并等待它们状态的改变
stream_set_blocking函数：将一个数据流设置为堵塞或者非堵塞状态
stream_set_timeout函数：对数据流进行超时设置
stream_set_write_buffer函数：为数据流设置缓冲区
stream_socket_accept函数：接受由函数stream_ socket_server()创建的Socket连接
stream_socket_client函数：打开网络或者UNIX主机的Socket连接
stream_socket_enable_crypto函数：为一个已经连接的Socket打开或者关闭数据加密
stream_socket_get_name函数：获取本地或者网络Socket的名称
stream_socket_pair函数：创建两个无区别的Socket数据流连接
stream_socket_recvfrom函数：从Socket获取数据，不管其连接与否
stream_socket_sendto函数：向Socket发送数据，不管其连接与否
stream_socket_server函数：创建一个网络或者UNIX Socket服务端
stream_wrapper_restore函数：恢复一个事先注销的数据包
stream_wrapper_unregister函数：注销一个URL地址包

Copier après la connexion

相信看了这些案例你已经掌握了方法，更多精彩请关注php中文网其它相关文章！