PHP中的gzcompress、gzdeflate、gzencode函数详解
@H_301_0@PHP中存在一组看起来很像的压缩解压函数：
@H_
301_0@压缩
函数：gzcompress gzdeflate gzencode
@H_
301_0@解压
函数：gzuncompress gzinflate gzdecode
@H_
301_0@gzdecode是
PHP 5.4.0之后才加入的，使用的时候要注意兼容性问题。
@H_
301_0@这几个
函数都以gz开头，让人想到gzip压缩，而光看
函数名却又看不出它们之间的区别，只能查文档。
@H_
301_0@gzcompress gzdeflate gzencode
函数的区别在于它们压缩的数据格式不同：
@H_
3010@gzcompress使用的是ZLIB格式；
@H3010@gzdeflate使用的是纯粹的DEFLATE格式；
@H3010@gzencode使用的是GZIP格式；
@H3010@但是有一点是相同的，它们压缩数据时都使用了DEFLATE压缩算法（理论上ZLIB和GZIP格式可以使用其他的压缩算法，但是目前实践中只使用DEFLATE算法），ZLIB和GZIP只不过是在DEFLATE的基础之上加了一些头部和尾部而已。
@H3010@顺便提一下，HTTP协议中的Content-Encoding: deflate使用的是ZLIB格式而不是纯DEFLATE格式。
@H301_0@从
PHP 5.4.0开始，gzcompress和gzdeflate
函数加入了第三个参数$encoding，可以是三个常量：
@H_
301_0@ZLIB_ENCODING
RAW 对应于纯DEFLATE格式；
@H301_0@ZLIB_ENCODING
GZIP 对应于GZIP格式；
@H301_0@ZLIB_ENCODING
DEFLATE 对应于ZLIB格式（注意不是纯DEFLATE格式）；
@H301_0@虽然文档没有提及，但是这三个常量也可以用在gzencode
函数的第三个参数$encoding
mode中。
@H301_0@其实从
PHP 5.4.0开始，这三个
函数是一样的，只不过第三个参数的默认值不同；如果
调用时传入第三个参数，那么这三个
函数返回的数据相同。可以写一个简单的脚本测试：
@H_
301_0@<div class="codetitle">
<a style="CURSOR: pointer" data="47738" class="copybut" id="copybut47738" onclick="doCopy('code47738')"> 代码如下: <div class="codebody" id="code47738">
<?php
$url = '
http://jb51.cc';
$s1 = gzdeflate($url,1);
$s2 = gzencode($url,1,ZLIB_ENCODING_RAW);
if (strcmp($s1,$s2) == 0) echo 'the same';
?>
PHP_ZLIB_ENCODE_FUNC(name,default_encoding) \
static
PHP_FUNCTION(name) \
{ \
char *in_buf,*out_buf; \
int in_len; \
size_t out_len; \
long level = -1; \
long encoding = default_encoding; \
if (default_encoding) { \
if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"s|ll",&in_buf,&in_len,&level,&encoding)) { \
return; \
} \
} else { \
if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC,"sl|l",&encoding,&level)) { \
return; \
} \
} \
if (level < -1 || level > 9) { \
PHP_error_docref(NULL TSRMLS_CC,E_WARNING,"compression level (%ld) must be within -1..9",level); \
RETURN_FALSE; \
} \
switch (encoding) { \
case
PHP_ZLIB_ENCODING_RAW: \
case
PHP_ZLIB_ENCODING_GZIP: \
case
PHP_ZLIB_ENCODING_DEFLATE: \
break; \
default: \
PHP_error_docref(NULL TSRMLS_CC,"encoding mode must be either ZLIB_ENCODING_RAW,ZLIB_ENCODING_GZIP or ZLIB_ENCODING_DEFLATE"); \
RETURN_FALSE; \
} \
if (SUCCESS !=
PHP_zlib_encode(in_buf,in_len,&out_buf,&out_len,encoding,level TSRMLS_CC)) { \
RETURN_FALSE; \
} \
RETURN_STRINGL(out_buf,out_len,0); \
}
@H_
301_0@
/* NOTE: The naming of these userland functions was quite unlucky */
/* {{{ proto binary gzdeflate(binary data[,int level = -1[,int encoding = ZLIB_ENCODING_RAW])
Encode data with the raw deflate encoding */
PHP_ZLIB_ENCODE_FUNC(gzdeflate,
PHP_ZLIB_ENCODING_RAW);
/* }}} */
@H_
301_0@/* {{{ proto binary gzencode(binary data[,int encoding = ZLIB_ENCODING_GZIP])
Encode data with the gzip encoding */
PHP_ZLIB_ENCODE_FUNC(gzencode,
PHP_ZLIB_ENCODING_GZIP);
/* }}} */
@H_
301_0@/* {{{ proto binary gzcompress(binary data[,int encoding = ZLIB_ENCODING_DEFLATE])
Encode data with the zlib encoding */
PHP_ZLIB_ENCODE_FUNC(gzcompress,
PHP_ZLIB_ENCODING_DEFLATE);
/* }}} */
