<p> 异步的文件上传是在现代的AJAX实现的Web应用里面经常要遇到,必须解决的问题。但是标准的AJAX类(XmlHttpRequest)无法实现传输文件的功能。因此,这里讨论的内容就是如何在AJAX的技术的基础之上构建异步的文件上传功能。在这个功能当中需要使用到内置的框及(IFRAME)来传输文件。这个功能实现的效果是页面在上传文件的时候,用户还可以使用该页面并且填写文件描述。</p><p> 这个例子是我们引用AJAX的经典案例进行分析的。</p><p> 系统环境</p><p> ・ 较新版本的浏览器。例如Opera,Firefox或者 Internet Explorer。</p><p> ・ PHP 4.3.0 或更高版本</p><p> ・ PHP 5 版本</p><p> ・ PHP 中的 'short_open_tag' 选项开启(否则会发生解析错误)。</p><p> 功能分析</p><p> 通过内置的IFRAME(框架)进行文件上传。具备包括三个部分组成。</p><p> ・ 在页面中间有一个简单的<form...表单,表单只包含了<input type="file" ... >控件。这个表单的目标链接就是一个隐藏得IFRAME(通过 CSS的风格" display: none;"实现)并且表单里面唯一一个控件的OnChange事件用来触发JavaScript函数。这个函数的作用是检查用户提交的扩展名,然后提交表单。</p><p> ・ 在服务器端用PHP编写了一个处理过程(用FILEFRAME坐注释了)。这个处理过程用来把从客户端上传的文件进行检查后保存在服务器,并且通过Javascript代码的形式返回给用户。返回给用户的Javascript脚本通过"parent.window.document"更改了用户现在正在查看的页面,设置了文件的名称并启用了让用户提交表单的按钮。启用按钮的操作是通过getElementById函数实现的。</p><p> ・ 在主页面还有一个表单,它包含了用户提交的描述和隐藏的文件名。用户可以在文件上传的同时填写文件的描述。当文件上传结束以后,用户点击按钮,就可以看上传以后返回给用户的文件信息了。(通过返回来的文件名和用户输入的描述构成文件信息)。</p>
<p> </p>
<p> 可能你会说这么操作不符合常理:文件在用户确认之前就已经被提交了。如果用户没有提交的话,情况会如何呢。你可以自己在扩展处理被用户放弃的文件。</p><p> 这个例子把文件存储在一个文件系统的目录下。你需要在脚本开始运行的时候配置下这个目录,具体的包含这个目录信息的变量是$upload_dir 和$web_upload_dir。这里有一个对目录是否可写的权限检查。</p><p> 这里我们用到了以下几个PHP函数:</p><p> ・ move_uploaded_file - 转移一经上传到服务器的文件</p><p> ・ fopen - 打开文件</p><p> ・ fwrite - 把内容写入文件</p><p> ・ fclose - 关闭文件</p><p> ・ str_replace - 替换字符串</p><p> ・ filesize - 返回文件大小</p><p> ・ filemtime - 返回处理时间</p><p> 你可以通过手册查到这些函数如果使用。请注意要把HTM(<, >, &)标记替换为(<, > 和 &).</p><p> 源代码</p><code><?php<br />$upload_dir = "/var/www/anyexample/aeu"; // 文件存储的路径<br />$web_upload_dir = "/aeu"; // 文件在Web目录下的路径<br />$tf = $upload_dir.'/'.md5(rand()).".test";<br />$f = @fopen($tf, "w");<br />if ($f == false)<br />die("Fatal error! {$upload_dir} is not writable. Set 'chmod 777 {$upload_dir}'<br />or something like this");<br />fclose($f);<br />unlink($tf);<br />//处理上传的文件<br />if (isset($_POST['fileframe']))<br />{<br /> $result = 'ERROR';<br /> $result_msg = 'No FILE field found';<br /> if (isset($_FILES['file'])) // 从浏览器接受文件<br /> {<br />if ($_FILES['file']['error'] == UPLOAD_ERR_OK) // 没有错误<br />{<br /> $filename = $_FILES['file']['name']; // 文件名<br /> move_uploaded_file($_FILES['file']['tmp_name'], $upload_dir.'/'.$filename);<br /> // 处理的主过程-转移文件到 $upload_dir<br /> $result = 'OK';<br />}<br />elseif ($_FILES['file']['error'] == UPLOAD_ERR_INI_SIZE)<br /> $result_msg = 'The uploaded file exceeds the upload_max_filesize directive in php.ini';<br />else<br /> $result_msg = 'Unknown error';<br /> }<br /> echo '<html><head><title>-</title></head><body>';<br /> echo '<script language="JavaScript" type="text/javascript">'."<br />";<br /> echo 'var parDoc = window.parent.document;';<br /> '<br /> if ($result == 'OK')<br /> {<br />echo 'parDoc.getElementById("upload_status").value = "file successfully uploaded";';<br />echo 'parDoc.getElementById("filename").value = "'.$filename.'";';<br />echo 'parDoc.getElementById("filenamei").value = "'.$filename.'";';<br />echo 'parDoc.getElementById("upload_button").disabled = false;';<br /> }<br /> else<br /> {<br />echo 'parDoc.getElementById("upload_status").value = "ERROR: '.$result_msg.'";';<br /> }<br /> echo "<br />".'</script></body></html>';<br /> exit();<br />}<br />function safehtml($s)<br />{<br /> $s=str_replace("&", "&", $s);<br /> $s=str_replace("<", "<", $s);<br /> $s=str_replace(">", ">", $s);<br /> $s=str_replace("'", "'", $s);<br /> $s=str_replace(""", """, $s);<br /> return $s;<br />}<br />if (isset($_POST['description']))<br />{<br /> $filename = $_POST['filename'];<br /> $size = filesize($upload_dir.'/'.$filename);<br /> $date = date('r', filemtime($upload_dir.'/'.$filename));<br /> $description = safehtml($_POST['description']);<br /> $html =<<<END<br /> <html><head><title>{$filename} [uploaded by IFRAME Async file uploader]</title></head><br /> <body><br /><h1>{$filename}</h1><br /><p>This is a file information page for your uploaded file. Bookmark it, or send to anyone...</p><br /><p>Date: {$date}</p><br /><p>Size: {$size} bytes</p><br /><p>Description:<br /><pre>{$description}</pre><br /></p><br /><p><a href="{$web_upload_dir}/{$filename}" style="font-size: large;">download file</a><br><br /><a href="{$PHP_SELF}" style="font-size: small;">back to file uploading</a><br><br /><a href="{$web_upload_dir}/upload-log.html" style="font-size: small;">upload-log</a></p><br /><br><br>Example by <a href="http://www.anyexample.com/">AnyExample</a><br /> </body></html><br /> END;<br /> <br /> $f = fopen($upload_dir.'/'.$filename.'-desc.html', "w");<br /> fwrite($f, $html);<br /> fclose($f);<br /> $msg = "File {$filename} uploaded,<br /> <a href='{$web_upload_dir}/{$filename}-desc.html'>see file information page</a>";<br /> $f = fopen($upload_dir."/upload-log.html", "a");<br /> fwrite($f, "<p>$msg</p><br />");<br /> fclose($f);<br /> setcookie('msg', $msg);<br /> header("Location: http://".$_SERVER['HTTP_HOST'].$PHP_SELF);<br /> exit();<br />}<br />if (isset($_COOKIE['msg']) && $_COOKIE['msg'] != '')<br />{<br /> if (get_magic_quotes_gpc())<br />$msg = stripslashes($_COOKIE['msg']);<br /> else<br />$msg = $_COOKIE['msg'];<br />setcookie('msg', '');<br />}<br />?><br /><!-- Beginning of main page --><br /><html><head><br /><title>IFRAME Async file uploader example</title><br /></head><br /><body><br /><?php<br /> if (isset($msg))<br />echo '<p style="font-weight: bold;">'.$msg.'</p>';<br />?><br /><h1>Upload file:</h1><br /><p>File will begin to upload just after selection. </p><br /><p>You may write file description, while you file is being uploaded.</p><br /><form action="<?=$PHP_SELF?>" target="upload_iframe" method="post" enctype="multipart/form-data"><br /> <input type="hidden" name="fileframe" value="true"><br /> <!-- Target of the form is set to hidden iframe --><br /> <!-- From will send its post data to fileframe section of this PHP script (see above) --><br /> <label for="file">text file uploader:</label><br><br /> <!-- JavaScript is called by OnChange attribute --><br /> <input type="file" name="file" id="file" onChange="jsUpload(this)"><br /></form><br /><script type="text/javascript"><br />/* This function is called when user selects file in file dialog */<br />function jsUpload(upload_field)<br />{<br /> // this is just an example of checking file extensions<br /> // if you do not need extension checking, remove<br /> // everything down to line<br /> // upload_field.form.submit();<br /> <br /> var re_text = /.txt|.xml|.zip/i;<br /> var filename = upload_field.value;<br /> /* Checking file type */<br /> if (filename.search(re_text) == -1)<br /> {<br />alert("File does not have text(txt, xml, zip) extension");<br />upload_field.form.reset();<br />return false;<br /> }<br /> upload_field.form.submit();<br /> document.getElementById('upload_status').value = "uploading file...";<br /> upload_field.disabled = true;<br /> return true;<br />}<br /></script><br /><iframe name="upload_iframe" style="width: 400px; height: 100px; display: none;"><br /></iframe><br /><!-- For debugging purposes, it's often useful to remove<br />"display: none" from style="" attribute --><br /><br><br />Upload status:<br><br /><input type="text" name="upload_status" id="upload_status"<br />value="not uploaded" size="64" disabled><br /><br><br><br />File name:<br><br /><input type="text" name="filenamei" id="filenamei" value="none" disabled><br /><form action="<?=$PHP_SELF?>" method="POST"><br /> <!-- one field is "disabled" for displaying-only. Other, hidden one is for sending data --><br /> <input type="hidden" name="filename" id="filename"><br /> <br><br><br /> <label for="photo">File description:</label><br><br /> <textarea rows="5" cols="50" name="description"></textarea><br /> <br><br><br /> <input type="submit" id="upload_button" value="save file" disabled><br /></form><br /><br><br><br /><a href="<?=$web_upload_dir?>/upload-log.html">upload-log</a><br /><br><br><br><br />Example by <a href="http://www.anyexample.com/">AnyExample</a><br /></body><br /></html></code></p></p><p> 以上的讲解就是提供一种思路供大家参考。大家也可以根据自己的需求进行相应的优化。</p></p>