Streams는 PHP가 제공하는 강력한 도구입니다. 우리는 이를 잘 활용하면 PHP의 생산성을 크게 향상시킬 수 있습니다. Streams의 강력한 기능을 활용하면 애플리케이션이 한 단계 더 발전할 수 있습니다.
다음은 PHP 매뉴얼의 Streams에 대한 설명입니다.
Streams는 PHP 4.3.0 버전에서 도입되었습니다. 데이터 압축 및 기타 클래스 파일의 작업 모드는 이러한 클래스 파일 작업을 위한 공통 함수 인터페이스 세트를 제공합니다. 간단히 말해서 스트림은 스트리밍 동작을 포함하는 리소스 개체입니다. 즉, 선형 방식으로 스트림을 읽고 쓸 수 있습니다. 그리고 fseek()를 사용하여 스트림 내의 어떤 위치로든 이동할 수 있습니다.
각 Streams 객체에는 특수 프로토콜 및 인코딩을 처리하기 위한 관련 코드를 추가할 수 있는 래퍼 클래스가 있습니다. 일반적으로 사용되는 일부 패키징 클래스가 PHP에 내장되어 있으며 사용자 정의 패키징 클래스를 생성하고 등록할 수도 있습니다. 기존 컨텍스트와 필터를 사용하여 래퍼 클래스를 수정하고 향상할 수도 있습니다.
스트림 기본
스트림은 e8ecf1fabecb2bbf3952eba1f0f8a7ec://b4bef09dd2761803871f1d83e55d08b2을 통해 참조할 수 있습니다. 그 중
PHP의 기본 패키징 클래스는 file://입니다. 이는 파일 시스템에 액세스할 때 실제로 스트림을 사용한다는 의미입니다. readfile('/path/to/somefile.txt') 또는 readfile('file:///path/to/somefile.txt')의 두 가지 방법으로 파일의 내용을 읽을 수 있습니다. . readfile('http://google.com/')을 사용하면 PHP는 작동할 HTTP 스트림 래퍼 클래스를 선택합니다.
위에서 언급했듯이 PHP는 많은 내장 패키지 클래스, 프로토콜 및 필터를 제공합니다. 아래 설명된 방법에 따라 이 머신에서 지원하는 패키징 클래스를 쿼리할 수 있습니다.
<?php print_r(stream_get_transports()); print_r(stream_get_wrappers()); print_r(stream_get_filters());
내 머신의 출력 결과는 다음과 같습니다.
Array ( [0] => tcp [1] => udp [2] => unix [3] => udg [4] => ssl [5] => sslv3 [6] => sslv2 [7] => tls ) Array ( [0] => https [1] => ftps [2] => compress.zlib [3] => compress.bzip2 [4] => php [5] => file [6] => glob [7] => data [8] => http [9] => ftp [10] => zip [11] => phar ) Array ( [0] => zlib.* [1] => bzip2.* [2] => convert.iconv.* [3] => string.rot13 [4] => string.toupper [5] => string.tolower [6] => string.strip_tags [7] => convert.* [8] => consumed [9] => dechunk [10] => mcrypt.* [11] => mdecrypt.* )
제공되는 기능이 많습니다. , 꽤 괜찮아 보이는데요?
위의 내장 스트림 외에도 Amazon S3, MS Excel, Google Storage, Dropbox 및 심지어 Twitter에 대한 더 많은 타사 스트림을 작성할 수도 있습니다.
php:// 래퍼 클래스
PHP에는 이 언어의 I/O 스트림을 처리하기 위한 래퍼 클래스가 내장되어 있습니다. 이는 여러 범주로 나눌 수 있습니다. 기본 범주는 php://stdin, php://stdout 및 php://stderr입니다. 이 세 가지 스트림은 각각 기본 I/O 리소스에 매핑됩니다. 동시에, PHP는 POST 요청의 원시 본문에 읽기 전용 방식으로 액세스할 수 있는 php://input도 제공합니다. 이는 특히 POST 요청에 데이터 페이로드를 포함하는 원격 서비스를 처리할 때 매우 유용한 기능입니다.
다음으로 cURL 도구를 사용하여 간단한 테스트를 수행합니다.
curl -d "Hello World" -d "foo=bar&name=John" <a href="http://localhost/dev/streams/php_input.php">http://localhost/dev/streams/php_input.php</a>
PHP 스크립트에서 print_r($_POST)을 사용한 테스트 결과는 다음과 같습니다.
Array ( [foo] => bar [name] => John )
$_POST 배열의 첫 번째 데이터 항목에 액세스할 수 없습니다. 그러나 readfile('php://input')을 사용하면 결과가 달라집니다.
Hello World&foo=bar&name=John
PHP 5.1은 두 개의 패키지를 더 추가합니다: php://memory 및 php://tempstream 읽기용 클래스 임시 데이터를 작성합니다. 래퍼 클래스의 이름에서 알 수 있듯이 이 데이터는 기본 시스템의 메모리나 임시 파일에 저장됩니다.
php://filter는 스트림에 필터 기능을 추가하는 데 사용되는 메타 패키징 클래스입니다. readfile() 또는 file_get_contents()/stream_get_contents()를 사용하여 스트림을 열 때 필터가 활성화됩니다. 다음은 그 예입니다.
<?php // Write encoded data file_put_contents("php://filter/write=string.rot13/resource=file:///path/to/somefile.txt","Hello World"); // Read data and encode/decode readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.google.com");
첫 번째 예에서는 디스크에 저장된 데이터를 인코딩하는 데 필터가 사용됩니다. 두 번째 예에서는 원격 URL에서 데이터를 읽는 두 개의 계단식 필터가 사용됩니다. 필터를 사용하면 애플리케이션에 매우 강력한 기능을 제공할 수 있습니다.
스트림 컨텍스트
컨텍스트는 스트림 관련 매개변수 또는 옵션의 집합입니다. 컨텍스트를 사용하여 래퍼 클래스의 동작을 수정하거나 향상시킵니다. 예를 들어 컨텍스트를 사용하여 HTTP 래퍼를 수정하는 것은 일반적으로 사용되는 사용 시나리오입니다. 이러한 방식으로 cURL 도구를 사용하지 않고도 몇 가지 간단한 네트워크 작업을 완료할 수 있습니다. 예를 들면 다음과 같습니다.
<?php $opts = array( 'http'=>array( 'method'=>"POST", 'header'=> "Auth: SecretAuthTokenrn" . "Content-type: application/x-www-form-urlencodedrn" . "Content-length: " . strlen("Hello World"), 'content' => 'Hello World' ) ); $default = stream_context_get_default($opts); readfile('http://localhost/dev/streams/php_input.php');
首先要定义一个options array,这是个二位数组,可以通过$array['wrapper']['option_name']的形式来访问其中的参数。(注意每个包装类中context的options是不同的)。然后调用stream_context_get_default()来设置这些option,stream_context_get_default()同时还会将默认的context作为结果返回回来。设置完成后,接下来调用readfile(),就会应用刚才设置好的context来抓取内容。
在上面的例子中,内容被嵌入到request的body中,这样远端的脚本就可以使用php://input来读取这些内容。同时,我们还能使用apache_request_headers()来获取request的header,如下所示:
Array ( [Host] => localhost [Auth] => SecretAuthToken [Content-type] => application/x-www-form-urlencoded [Content-length] => 11 )
在上面的例子中是修改默认context的参数,当然我们也可以创建一个新的context,进行交替使用。
<?php $alternative = stream_context_create($other_opts); readfile('http://localhost/dev/streams/php_input.php', false, $alternative);
结论
我们怎样在现实世界中驾驭stream的强大力量呢?使用stream能为我们的程序带来什么现实的好处? 正如前文介绍的那样,stream对所有文件系统相关的功能进行了抽象,所以我第一个想到的应用场景是使用虚拟文件系统的包装类来访问PaaS供应商提供的服务,比如说访问HeroKu或者AppFog,它们实际上都没有真正文件系统。 使用stream只要对我们的应用程序稍作修改,就可以将其移植到云端。 接下来--在我的下一篇文章中--我将介绍如何编写自定义的包装类以实现对特殊文件格式和编码格式的操作。