Understand Streams in PHP, understand phpstreams_PHP tutorial

Understand Streams in PHP, understand phpstreams

　Streams is a powerful tool provided by PHP. We often use it inadvertently. If you make good use of it, it will greatly improve your performance. PHP productivity. Harnessing the power of Streams will take your applications to the next level.

The following is a description of Streams in the PHP manual:

<p>Streams 是在PHP 4.3.0版本被引入的，它被用于统一文件、网络、数据压缩等类文件的操作方式，为这些类文件操作提供了一组通用的函数接口。简而言之，一个stream就是一个具有流式行为的资源对象。也就是说，我们可以用线性的方式来对stream进行读取和写入。并且可以用使用fseek()来跳转到stream内的任意位置。</p>

Each Streams object has a wrapper class, in which relevant code for handling special protocols and encodings can be added. Some commonly used packaging classes have been built into PHP, and we can also create and register custom packaging classes. We can even modify and enhance the wrapper class using existing context and filters.

Stream Basics

Stream can be referenced through ://. Among them, is the name of the packaging class, and the content in is specified by the syntax of the packaging class. The syntax of different packaging classes will be different.

PHP’s default packaging class is file://, which means that when we access the file system, we are actually using a stream. We can read the contents of the file in the following two ways, readfile('/path/to/somefile.txt') or readfile('file:///path/to/somefile.txt'). The methods are equivalent. If you use readfile('http://google.com/'), then PHP will select the HTTP stream wrapper class to operate.

As mentioned above, PHP provides many built-in wrapper classes, protocols and filters. According to the method described below, you can query the packaging classes supported by this machine:

The output on my machine is:

There are a lot of functions provided, does it look good?

In addition to the above built-in Streams, we can also write more third-party Streams for Amazon S3, MS Excel, Google Storage, Dropbox and even Twitter.

php:// packaging class

PHP has a built-in wrapper class for handling I/O streams in this language. It can be divided into several categories. The basic ones are php://stdin, php://stdout, and php://stderr. These three streams are mapped to default I/O resources respectively. At the same time, PHP also provides php://input, through which the raw body in the POST request can be accessed in a read-only manner. This is a very useful feature, especially when dealing with remote services that embed data payloads into POST requests.

Next we use the cURL tool to do a simple test:

The test results of using print_r($_POST) in PHP script are as follows:

We note that the first item of data in the $_POST array cannot be accessed. But if we use readfile('php://input'), the result is different:

PHP 5.1 adds two package classes, php://memory and php://tempstream, for reading and writing temporary data. As the name of the wrapper class implies, this data is stored in memory or temporary files in the underlying system.

php://filter is a meta-package class used to add filter functionality to the stream. The filter will be enabled when opening a stream using readfile() or file_get_contents()/stream_get_contents(). Here is an example:

In the first example, a filter is used to encode the data saved to disk. In the second example, two cascaded filters are used to read data from the remote URL. Using filters can bring extremely powerful functionality to your application.

Stream context

Context is a set of stream-related parameters or options. Use context to modify or enhance the behavior of the wrapper class. For example, using context to modify the HTTP wrapper is a commonly used usage scenario. In this way, we can complete some simple network operations without using the cURL tool. Here is an example:

First, you need to define an options array, which is a two-digit array. The parameters can be accessed in the form of $array['wrapper']['option_name']. (Note that the context options in each wrapper class are different). Then call stream_context_get_default() to set these options. stream_context_get_default() will also return the default context as a result. After the setting is completed, then call readfile(), and the context just set will be used to capture the content.

In the above example, the content is embedded in the request body so that remote scripts can use php://input to read the content. At the same time, we can also use apache_request_headers() to get the header of the request, as shown below:

In the above example, the parameters of the default context are modified. Of course, we can also create a new context and use it alternately.

Conclusion

How do we harness the power of streams in the real world? What practical benefits can using streams bring to our programs? As mentioned earlier, stream abstracts all file system-related functions, so the first application scenario I think of is to use the wrapper class of the virtual file system to access services provided by PaaS providers, such as accessing HeroKu or AppFog , none of them actually have a real file system. Using streams we can port our application to the cloud with only minor modifications. Next - in my next article - I will describe how to write custom wrapper classes to operate on special file formats and encoding formats.