PHP 文件上传源码分析(RFC1867)


Posted in PHP onOctober 30, 2009

你总不至于在用户要上传头像的时候告诉用户”请打开FTP客户端,上传文件到https://3water.com/uploads/中, 并以2dk433423l.jpg命名”吧?

而基于HTTP的上传,相对来说易用性和安全性上就比FTP要增强了很多. 可以应用的上传方式有PUT, WEBDAV, 和RFC1867三种, 本文将分析在PHP中,是如何基于RFC1867实现文件上传的.

RFC1867

RCF1867是Form-based File Upload in HTML标准协议, RFC1867标准对HTML做出了两处修改:
 

1 为input元素的type属性增加了一个file选项。
2 input标记可以具有accept属性,该属性能够指定可被上传的文件类型或文件格式列表。

另外,本标准还定义了一种新的mime类型:multipart/form-data,以及当处理一个带有enctype=”multipart/form-data” 并且/或含有<input type=”file”>的标记的表单时所应该采取的行为。

举例来说,当HTML想让用户能够上传一个或更多的文件时,他可以这么写:

<form enctype="multipart/form-data" action="upload.php" method=post>
选择文件:
<input name="userfile" type="file">
文件描述:
<input name="description" type="text">
<input type="submit" value="上传">
</form>

这个表单, 大家一定不陌生, 而对于PHP来说, 它自己另外定义了一个默认表单元素MAX_FILE_SIZE, 用户可以通过这个隐藏的表单元素来建议PHP最多只容许上传文件的大小, 比如对于上面的例子, 我们希望用户上传的文件不能大于5000(5k)字节, 那么可以如下写:

<form enctype="multipart/form-data" action="upload.php" method=post>
<input type="hidden" value="5000" name="MAX_FILE_SIZE"> <!--文件大小-->
选择文件:
<input name="userfile" type="file">
文件描述:
<input name="description" type="text">
<input type="submit" value="上传">
</form>

姑且不说, 这个MAX_FILE_SIZE是多么的不可靠(所以基于浏览器的控制,都是不可靠的), 单纯从实现来讲, 我会慢慢介绍这个MAX_FILE_SIZE是如何起作用的.

当用户选择了一个文件(laruence.txt), 并填写好文件描述(”laruence的个人介绍”), 点击上传后, 发生了什么呢?

表单提交

在用户确定提交以后, 浏览器会发送如下类似格式的数据包到form中action属性指定的页面(在本例中是upload.php):

//请求头
POST /upload.php HTTP/1.0\r\n
...
Host: www.laruence.com\r\n
...
Content-length: xxxxx\r\n
...
Content-type: multipart/form-data, boundary=--------------7d51863950254\r\n
...\r\n\r\n
//开始POST数据内容
---------------7d51863950254
content-disposition: form-data; name="description"
laruence的个人介绍
---------------7d51863950254
content-disposition: form-data; name="userfile"; filename="laruence.txt"
Content-Type: text/plain
... laruence.txt 的内容...
---------------7d51863950254

接下来, 就是服务器, 是如何处理这些数据了.

接受上传

当Web服务器, 此处假设为Apache(另外假设PHP是以module方式安装在Apache上的), 接受到用户的数据时, 首先它根据HTTP请求头, 通过确定MIME TYPE为PHP类型, 然后经过一些过程以后(这部分,可以参看我之前的PHP Life Cycle ppt), 最终会把控制权交给PHP模块.

这个时候, PHP会调用sapi_activate来初始化一个请求, 在这个过程中, 首先判断请求类型, 此时是POST, 从而去调用sapi_read_post_data, 通过Content-type, 找到rfc1867的处理函数rfc1867_post_handler, 从而调用这个handler, 来分析POST来的数据.

关于rfc1867_post_handler这部分的源代码, 可以在mian/rfc1867.c找到, 另外也可以参看我之前的深入理解PHP之文件上传, 其中也列出的源代码.

然后, PHP通过boundary, 对于每一个分段, 都通过检查, 是否同时定义了:

name和filename属性(有名文件上传)
 没有定义name定义了filename(无名上传)
 定义了name没有定义filename(普通数据),

从而进行不同的处理.

if ((cd = php_mime_get_hdr_value(header, "Content-Disposition"))) {
 char *pair=NULL;
 int end=0; while (isspace(*cd)) {
 ++cd;
 }
 while (*cd && (pair = php_ap_getword(&cd, ';')))
 {
 char *key=NULL, *word = pair;
 while (isspace(*cd)) {
 ++cd;
 }
 if (strchr(pair, '=')) {
 key = php_ap_getword(&pair, '=');
 if (!strcasecmp(key, "name")) {
 //获取name字段
 if (param) {
 efree(param);
 }
 param = php_ap_getword_conf(&pair TSRMLS_CC);
 } else if (!strcasecmp(key, "filename")) {
 //获取filename字段
 if (filename) {
 efree(filename);
 }
 filename = php_ap_getword_conf(&pair TSRMLS_CC);
 }
 }
 if (key) {
 efree(key);
 }
 efree(word);
 }

在这个过程中, PHP会去检查普通数据中,是否有MAX_FILE_SIZE.

/* Normal form variable, safe to read all data into memory */
if (!filename && param) {
 unsigned int value_len;
 char *value = multipart_buffer_read_body(mbuff, &value_len TSRMLS_CC);
 unsigned int new_val_len; /* Dummy variable */
 ...... if (!strcasecmp(param, "MAX_FILE_SIZE")) {
 max_file_size = atol(value);
 }
 efree(param);
 efree(value);
 continue;
}

有的话, 就会按照它的值来检查文件大小是否超出.

if (PG(upload_max_filesize) > 0 && total_bytes > PG(upload_max_filesize)) {
 cancel_upload = UPLOAD_ERROR_A;
} else if (max_file_size && (total_bytes > max_file_size)) {
#if DEBUG_FILE_UPLOAD
 sapi_module.sapi_error(E_NOTICE,
 "MAX_FILE_SIZE of %ld bytes exceeded - file [%s=%s] not saved",
 max_file_size, param, filename);
#endif
 cancel_upload = UPLOAD_ERROR_B;
}

通过上面的代码,我们也可以看到, 判断分为俩部, 第一部分是检查PHP默认的上传上限. 第二部分才是检查用户自定义的MAX_FILE_SIZE, 所以表单中定义的MAX_FILE_SIZE并不能超过PHP中设置的最大上传文件大小.

通过对name和filename的判断, 如果是文件上传, 会根据php的设置, 在文件上传目录中创建一个随机名字的临时文件:

if (!skip_upload) {
 /* Handle file */
 fd = php_open_temporary_fd_ex(PG(upload_tmp_dir),
 "php", &temp_filename, 1 TSRMLS_CC);
 if (fd==-1) {
 sapi_module.sapi_error(E_WARNING,
 "File upload error - unable to create a temporary file");
 cancel_upload = UPLOAD_ERROR_E;
 }
}

返回文件句柄, 和临时随机文件名.

之后, 还会有一些验证,比如文件名合法, name合法等.

如果这些验证都通过, 那么就把内容读入, 写入到这个临时文件中.

.....
else if (blen > 0) {
 wlen = write(fd, buff, blen); //写入临时文件.
 if (wlen == -1) {
 /* write failed */
#if DEBUG_FILE_UPLOAD
 sapi_module.sapi_error(E_NOTICE, "write() failed - %s", strerror(errno));
#endif
 cancel_upload = UPLOAD_ERROR_F;
 }
}
....

当循环读入完成后, 关闭临时文件句柄. 记录临时变量名:

zend_hash_add(SG(rfc1867_uploaded_files), temp_filename,
 strlen(temp_filename) + 1, &temp_filename, sizeof(char *), NULL);

并且生成FILE变量, 这个时候, 如果是有名上传, 那么就会设置:

$_FILES['userfile'] //name="userfile"

如果是无名上传, 则会使用tmp_name来设置:

$_FILES['tmp_name'] //无名上传

最终交给用户编写的upload.php处理.

这时在upload.php中, 用户就可以通过move_uploaded_file来操作刚才生成的文件了~

PHP 相关文章推荐
用mysql触发器自动更新memcache的实现代码
Oct 11 PHP
使用PHP获取网络文件的实现代码
Jan 01 PHP
php radio 单选框获取与保持值的实现代码
May 15 PHP
ini_set的用法介绍
Jan 07 PHP
thinkphp3.2.2前后台公用类架构问题分析
Nov 25 PHP
php集成动态口令认证
Jul 21 PHP
分享一个漂亮的php验证码类
Sep 29 PHP
PHP实现判断数组是一维、二维或几维的方法
Feb 06 PHP
PHP实现从上往下打印二叉树的方法
Jan 18 PHP
RSA实现JS前端加密与PHP后端解密功能示例
Aug 05 PHP
laravel框架中控制器的创建和使用方法分析
Nov 23 PHP
Laravel5.1 框架控制器基础用法实例分析
Jan 04 PHP
浅谈PHP 闭包特性在实际应用中的问题
Oct 30 #PHP
php实现jQuery扩展函数
Oct 30 #PHP
PHP 读取和修改大文件的某行内容的代码
Oct 30 #PHP
PHP 批量删除数据的方法分析
Oct 30 #PHP
ThinkPHP php 框架学习笔记
Oct 30 #PHP
php pack与unpack 摸板字符字符含义
Oct 29 #PHP
php 显示指定路径下的图片
Oct 29 #PHP
You might like
php实现文件下载代码分享
2014/08/19 PHP
使用php的HTTP请求的库Requests实现美女图片墙
2015/02/22 PHP
一起来写段JS drag拖动代码
2010/12/09 Javascript
jquery foreach使用示例
2013/09/12 Javascript
JavaScript判断变量是对象还是数组的方法
2014/08/28 Javascript
深入理解JS DOM事件机制
2016/08/06 Javascript
jquery过滤特殊字符',防sql注入的实现方法
2016/08/17 Javascript
jQuery中$.ajax()方法参数解析
2016/10/22 Javascript
JavaScript计算值然后把值嵌入到html中的实现方法
2016/10/29 Javascript
Vue.use源码分析
2017/04/22 Javascript
详解VueJS 数据驱动和依赖追踪分析
2017/07/26 Javascript
手机注册发送验证码倒计时的简单实例
2017/11/15 Javascript
Vue iview-admin框架二级菜单改为三级菜单的方法
2018/07/03 Javascript
解决vue脚手架项目打包后路由视图不显示的问题
2018/09/20 Javascript
原生js实现公告滚动效果
2021/01/10 Javascript
浅谈vue.use()方法从源码到使用
2019/05/12 Javascript
vue基础知识--axios合并请求和slot
2020/06/04 Javascript
python的几种开发工具介绍
2007/03/07 Python
python自然语言编码转换模块codecs介绍
2015/04/08 Python
Python图像灰度变换及图像数组操作
2016/01/27 Python
Python使用defaultdict读取文件各列的方法
2017/05/11 Python
python导入csv文件出现SyntaxError问题分析
2017/12/15 Python
django模板结构优化的方法
2019/02/28 Python
详解Python 函数如何重载?
2019/04/23 Python
python yield关键词案例测试
2019/10/15 Python
python对文件的操作方法汇总
2020/02/28 Python
Python中zipfile压缩文件模块的基本使用教程
2020/06/14 Python
python实现图像随机裁剪的示例代码
2020/12/10 Python
Answear匈牙利:来自全球200多个知名时尚品牌
2017/04/21 全球购物
美国林业供应商:Forestry Suppliers
2019/05/01 全球购物
电大学习个人自我评价范文
2013/10/04 职场文书
劳资人员岗位职责
2013/12/19 职场文书
写给爸爸的道歉信
2014/01/15 职场文书
降消项目实施方案
2014/03/30 职场文书
2015年行政工作总结范文
2015/04/09 职场文书
Go Grpc Gateway兼容HTTP协议文档自动生成网关
2022/06/16 Golang