Examples TOCexamples

Web-HTTP ProgressBar uploader

$Date: 2005/07/25 11:43:56 $

 Table of contents

Introduction

This example requires :

This example allows you to upload files from a web browser to your web server.

It requires no client side software and operates on the server via standard multipart HTML forms as defined in RFC 1867.

PEAR::HTML_QuickForm package is used to make and manage the form that will send file to your web server, while HTML_Progress is only used to display a progress meter running in indeterminate mode.

Be aware that your web server could returns a timeout on long upload operation, by running the HTML_Progress script (See technical notes below).

[Top]

 Technical notes

The script time-out refers to the number of seconds a PHP page is given before the script is assumed to have failed and the page terminated. If you are uploading a large file the script that is receiving the transfer may time out before the file has been completely uploaded. To alter this setting you should insert the following code into your uploading page prior to creating any HTML_Progress and HTML_QuickForm objects.

1 <?php set_time_limit(300); // five minutes ?>

See also: set_time_limit manual.

[Top]

 Render options 

increment = 10 (to make progress bar animation smoothest in indeterminate mode)
HTML_Progress::setIncrement()
speed = 100 (to make progress bar animation smoothest)
HTML_Progress::setAnimSpeed()
background-color = #e0e0e0
HTML_Progress_UI::setProgressAttributes()
color            = #996
background-color = #CCCC99
HTML_Progress_UI::setStringAttributes()
active-color = #996
HTML_Progress_UI::setCellAttributes()

[Top]

 Output

Screenshot

[Top]

 PHP source syntax highlight

The form file selection:

  1. <?php
  2. /**
  3.  * Frameset Page Upload
  4.  * A form is used to select and submit any kind of file to webserver (frame 1) while
  5.  * a progress meter is running in indeterminate mode in the bottom of page (frame 2)
  6.  *
  7.  * @version    $Id: formselfref.php,v 1.3 2005/07/25 11:43:56 farell Exp $
  8.  * @author     Laurent Laville <pear@laurent-laville.org>
  9.  * @package    HTML_Progress
  10.  * @subpackage Examples
  11.  */
  12.  
  13. require_once 'HTML/QuickForm.php';
  14.  
  15. function myProcess($values)
  16. {
  17.     global $form;
  18.     $destination = './uploads/';
  19.  
  20.     $file =& $form->getElement('tstUpload');
  21.     if ($file->isUploadedFile()) {
  22.         $ok = $file->moveUploadedFile($destination);
  23.  
  24.         if ($ok) {
  25.             // write the semaphore to tell progress meter to stop
  26.             // in script 'progressbar.php'
  27.  
  28.             $fp = fopen($destination . $_GET['ID'],'w',false);
  29.             fwrite($fp, 'done');
  30.             fclose($fp);
  31.         }
  32.     }
  33. }
  34. ?>
  35. <html>
  36. <head>
  37. <script language="javascript">
  38. <!--
  39. function DoUpload() {
  40.   theUniqueID = (new Date()).getTime() % 1000000000;
  41.   parent.meter.window.location = "progressbar.php?ID=" + theUniqueID;
  42.   parent.files.selfref.action = "formselfref.php?ID=" + theUniqueID;
  43.   parent.files.selfref.submit();
  44. }
  45. //-->
  46. </script>
  47. </head>
  48. <body>
  49. <?php
  50.  
  51. $form =& new HTML_QuickForm('selfref');
  52.  
  53. // We need an additional label below the element
  54. $renderer =& $form->defaultRenderer();
  55. $renderer->setElementTemplate(<<<EOT
  56. <tr>
  57.     <td align="right" valign="top" nowrap="nowrap"><!-- BEGIN required --><span style="color: #ff0000">*</span><!-- END required --><b>{label}</b></td>
  58.     <td valign="top" align="left">
  59.         <!-- BEGIN error --><span style="color: #ff0000">{error}</span><br /><!-- END error -->{element}
  60.         <!-- BEGIN label_2 --><br/><span style="font-size: 80%">{label_2}</span><!-- END label_2 -->
  61.     </td>
  62. </tr>
  63.  
  64. EOT
  65. );
  66.  
  67. $form->addElement('header', null, 'Uploaded file rules');
  68. $form->addElement('file', 'tstUpload', array('Upload file:', 'Rule types: \'uploadedfile\''));
  69. $form->addRule('tstUpload', 'Upload is required', 'uploadedfile');
  70.  
  71. $form->addElement('header', null, 'Submit the form');
  72. $submit[] =& $form->createElement('button', null, 'Upload', array('onClick'=>'DoUpload();'));
  73. $form->addGroup($submit, null, null, '&nbsp;', false);
  74.  
  75. $form->applyFilter('__ALL__', 'trim');
  76.  
  77. if ($form->validate()) {
  78.     // Form is validated, then processes the data
  79.     $form->freeze();
  80.     $form->process('myProcess', true);
  81.     echo '<p>&lt;&lt; <a target="_top" href="../index.html">Back examples TOC</a></p>';
  82.  
  83. } elseif (isset($_GET['ID'])) {
  84.     $destination = './uploads/';
  85.     $fp = fopen($destination . $_GET['ID'],'w',false);
  86.     fwrite($fp, 'error');
  87.     fclose($fp);
  88. }
  89. $form->display();
  90. ?>
  91. </body>
  92. </html>

The progress meter in indeterminate mode:

  1. <?php
  2. /**
  3.  * Progress meter is running in indeterminate mode while a file upload operation.
  4.  * This example may work with HTML_Progress 1.1
  5.  * but version 1.2.0 or better allows more easy facilities.
  6.  *
  7.  * @version    $Id: progressbar.php,v 1.3 2005/07/25 11:43:56 farell Exp $
  8.  * @author     Laurent Laville <pear@laurent-laville.org>
  9.  * @package    HTML_Progress
  10.  * @subpackage Examples
  11.  */
  12.  
  13. require_once 'HTML/Progress.php';
  14.  
  15. function _methodExists($name)
  16. {
  17.     if (substr(PHP_VERSION,0,1) < '5') {
  18.         $n = strtolower($name);
  19.     } else {
  20.         $n = $name;
  21.     }
  22.     if (in_array($n, get_class_methods('HTML_Progress'))) {
  23.         return true;
  24.     }
  25.     return false;
  26. }
  27.  
  28. /*
  29.     User callback called pending progress meter is running, comes with version 1.2.0RC3
  30.  */
  31. function myFunctionHandler($progressValue, &$obj)
  32. {
  33.     global $version;
  34.     global $stop;
  35.     $semaphore = './uploads/'.$_GET['ID'];
  36.  
  37.     if (file_exists($semaphore)) {
  38.         $stop = file_get_contents($semaphore);
  39.         $obj->setValue(100);
  40.         $obj->setIndeterminate(false);
  41.         $obj->display();
  42.         unlink($semaphore);
  43.     }
  44.  
  45.     // sleep a bit ...
  46.     if ($version > 1.1) {
  47.         $obj->sleep();
  48.     } else {
  49.         for ($i=0; $i<($obj->_anim_speed*1000); $i++) { }
  50.     }
  51. }
  52.  
  53. /*
  54.     Which version of html_progress: (stable)1.1 or (beta)1.2.0 RC1, RC2 or RC3
  55.  */
  56. $version = _methodExists('run') ? 1.2 : 1.1;
  57.  
  58. $progress = new HTML_Progress();
  59. $progress->setIncrement(10);
  60. $progress->setAnimSpeed(100);
  61. $progress->setIndeterminate(true);     // progress bar run in indeterminate mode
  62. $progress->setStringPainted(true);     // get space for the string
  63. $progress->setString("");              // but don't paint it
  64. if ($version > 1.1) {
  65.     // set a progress handler required at least version 1.2.0RC3
  66.     $progress->setProgressHandler('myFunctionHandler');
  67. }
  68. $ui = & $progress->getUI();
  69. $ui->setProgressAttributes(array(
  70.     'background-color' => '#e0e0e0'
  71. ));
  72. $ui->setStringAttributes(array(
  73.     'color'  => '#996',
  74.     'background-color' => '#CCCC99'
  75. ));
  76. $ui->setCellAttributes(array(
  77.     'active-color' => '#996'
  78. ));
  79. ?>
  80. <html>
  81. <head>
  82. <style type="text/css">
  83. <!--
  84. body {
  85.     background-color: #CCCC99;
  86.     color: #996;
  87.     font-family: Verdana, Arial;
  88. }
  89. <?php echo $progress->getStyle(); ?>
  90. // -->
  91. </style>
  92. <script type="text/javascript">
  93. <!--
  94. <?php echo $progress->getScript(); ?>
  95. //-->
  96. </script>
  97. </head>
  98. <body>
  99.  
  100. <?php
  101. echo $progress->toHtml();
  102.  
  103. if (isset($_GET['ID'])) {
  104.  
  105.     if ($version > 1.1) {
  106.         $progress->run();    // run method is born on version 1.2.0RC3
  107.     } else {
  108.         // do the same as run() method
  109.         do {
  110.             $progress->display();
  111.             myFunctionHandler($progress->getValue(), $progress);
  112.             if ($progress->getPercentComplete() == 1) {
  113.                 if ($progress->isIndeterminate()) {
  114.                     $progress->setValue(0);
  115.                 } else {
  116.                     break;
  117.                 }
  118.             }
  119.             $progress->incValue();
  120.         } while(1);
  121.     }
  122.     if ($stop == 'done') {
  123.         echo '<b>Upload Complete...</b>';
  124.     } else {
  125.         echo '<b>File was not uploaded !</b>';
  126.         echo '<br/><font size="1">'.$stop.'</font>';
  127.     }
  128. }
  129. ?>
  130.  
  131. </body>
  132. </html>

[Top]