PHP中的gzcompress、gzdeflate、gzencode函数详解


Posted in PHP onJuly 29, 2014

PHP中存在一组看起来很像的压缩解压函数:

压缩函数:gzcompress gzdeflate gzencode

解压函数:gzuncompress gzinflate gzdecode

gzdecode是PHP 5.4.0之后才加入的,使用的时候要注意兼容性问题。

这几个函数都以gz开头,让人想到gzip压缩,而光看函数名却又看不出它们之间的区别,只能查文档。

gzcompress gzdeflate gzencode函数的区别在于它们压缩的数据格式不同:

gzcompress使用的是ZLIB格式;

gzdeflate使用的是纯粹的DEFLATE格式;

gzencode使用的是GZIP格式;

但是有一点是相同的,它们压缩数据时都使用了DEFLATE压缩算法(理论上ZLIB和GZIP格式可以使用其他的压缩算法,但是目前实践中只使用DEFLATE算法),ZLIB和GZIP只不过是在DEFLATE的基础之上加了一些头部和尾部而已。

顺便提一下,HTTP协议中的Content-Encoding: deflate使用的是ZLIB格式而不是纯DEFLATE格式。

从PHP 5.4.0开始,gzcompress和gzdeflate函数加入了第三个参数$encoding,可以是三个常量:

ZLIB_ENCODING_RAW 对应于纯DEFLATE格式;

ZLIB_ENCODING_GZIP 对应于GZIP格式;

ZLIB_ENCODING_DEFLATE 对应于ZLIB格式(注意不是纯DEFLATE格式);

虽然文档没有提及,但是这三个常量也可以用在gzencode函数的第三个参数$encoding_mode中。

其实从PHP 5.4.0开始,这三个函数是一样的,只不过第三个参数的默认值不同;如果调用时传入第三个参数,那么这三个函数返回的数据相同。可以写一个简单的脚本测试:

<?php

$url = 'http://3water.com';

$s1 = gzdeflate($url, 1);

$s2 = gzencode($url, 1, ZLIB_ENCODING_RAW);

if (strcmp($s1, $s2) == 0) echo 'the same';

?>

运行可以看到$s1和$s2是相同的,为什么会这样呢?可以从PHP源码中找到答案,打开php-5.5.4\ext\zip\zlib.c,可以找到这样的代码:

#define 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", &in_buf, &in_len, &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, E_WARNING, "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); \

}


/* 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);

/* }}} */
/* {{{ proto binary gzencode(binary data[, int level = -1[, int encoding = ZLIB_ENCODING_GZIP])

   Encode data with the gzip encoding */

PHP_ZLIB_ENCODE_FUNC(gzencode, PHP_ZLIB_ENCODING_GZIP);

/* }}} */
/* {{{ proto binary gzcompress(binary data[, int level = -1[, int encoding = ZLIB_ENCODING_DEFLATE])

   Encode data with the zlib encoding */

PHP_ZLIB_ENCODE_FUNC(gzcompress, PHP_ZLIB_ENCODING_DEFLATE);

/* }}} */

可以看到,gzdeflate gzencode gzcompress三个函数都是用相同的PHP_ZLIB_ENCODE_FUNC宏定义的(是不是有些泛型的意味?),所以它们当然是相同的。

代码中的注释也承认这几个函数的名字起得不好,至于为什么会用这样的名字就不得而知了。

PHP 相关文章推荐
php 随机生成10位字符代码
Mar 26 PHP
php checkbox 取值详细说明
Aug 19 PHP
php笔记之:php数组相关函数的使用
Apr 26 PHP
PHP生成sitemap.xml地图函数
Nov 13 PHP
php生成数组的使用示例 php全组合算法
Jan 16 PHP
Zend Framework页面缓存实例
Jun 25 PHP
PHP+APACHE实现网址伪静态
Feb 22 PHP
PHP处理postfix邮件内容的方法
Jun 16 PHP
PHP 在数组中搜索给定的简单实例 array_search 函数
Jun 13 PHP
php mysqli查询语句返回值类型实例分析
Jun 29 PHP
PHP 年月日的三级联动实例代码
May 24 PHP
Laravel源码解析之路由的使用和示例详解
Sep 27 PHP
VB中的RasEnumConnections函数返回632错误解决方法
Jul 29 #PHP
php中的curl_multi系列函数使用例子
Jul 29 #PHP
PHP使用CURL_MULTI实现多线程采集的例子
Jul 29 #PHP
PHP实现把文本中的URL转换为链接的auolink()函数分享
Jul 29 #PHP
PHP自带函数给数字或字符串自动补齐位数
Jul 29 #PHP
Win2003+apache+PHP+SqlServer2008 配置生产环境
Jul 29 #PHP
php实现读取超大文件的方法
Jul 28 #PHP
You might like
PHP实现操作redis的封装类完整实例
2015/11/14 PHP
php上传图片类及用法示例
2016/05/11 PHP
js脚本学习 比较实用的基础
2006/09/07 Javascript
静态页面的值传递(三部曲)
2006/09/25 Javascript
jquery插件制作 图片走廊 gallery
2012/08/17 Javascript
浅析hasOwnProperty方法的应用
2013/11/20 Javascript
js中reverse函数的用法详解
2013/12/26 Javascript
javascript实现复选框选中属性
2015/03/25 Javascript
jQuery实现两个select控件的互移操作
2016/12/22 Javascript
JavaScript中闭包的详解
2017/04/01 Javascript
关于vue.js v-bind 的一些理解和思考
2017/06/06 Javascript
在vue中获取dom元素内容的方法
2017/07/10 Javascript
微信小程序movable view移动图片和双指缩放实例代码
2017/08/08 Javascript
JS字符串去除连续或全部重复字符的实例
2018/03/08 Javascript
Webpack之tree-starking 解析
2018/09/11 Javascript
js异步上传多张图片插件的使用方法
2018/10/22 Javascript
jQuery实现获取当前鼠标位置并输出功能示例
2019/01/05 jQuery
react组件从搭建脚手架到在npm发布的步骤实现
2019/01/09 Javascript
vue+elementUI实现表格关键字筛选高亮
2020/10/26 Javascript
Angular短信模板校验代码
2020/09/23 Javascript
ES5和ES6中类的区别总结
2020/12/21 Javascript
Python函数可变参数定义及其参数传递方式实例详解
2015/05/25 Python
python实现八大排序算法(1)
2017/09/14 Python
Python2包含中文报错的解决方法
2018/07/09 Python
Python中的Numpy矩阵操作
2018/08/12 Python
使用python实现unix2dos和dos2unix命令的例子
2019/08/13 Python
Python 自由定制表格的实现示例
2020/03/20 Python
HTMl5的存储方式sessionStorage和localStorage详解
2014/03/18 HTML / CSS
教师岗位职责
2013/11/17 职场文书
初中三好学生事迹材料
2014/01/13 职场文书
公司员工检讨书
2014/02/08 职场文书
公司年会搞笑主持词
2014/03/24 职场文书
安全协议书范本
2014/04/21 职场文书
Python实现列表拼接和去重的三种方式
2021/07/02 Python
漫画「请问您今天要来点兔子吗?」最新杂志彩页公开
2022/03/24 日漫
基于Android10渲染Surface的创建过程
2022/08/14 Java/Android