HTML_Progress2 : The Definitive Guide

You can download and use it for free. But don't delete the copyright notice. You can read terms of the license

YES if there is no answer in this Guide and if you are ready to share some informations such as : your configuration (platform Win *nix mac, PHP version, PEAR packages installed) and perharps your script.

You can report it with the bug tracker at PEAR.

HTML_Progress2_Lite is less customizable than its father HTML_Progress2, but allows to do almost the same things. This class has no dependency and can be used completely outside the PEAR infrastructure.

PHP_Compat provides missing functionality for older versions of PHP. This class has no dependency and can be used completely outside the PEAR infrastructure.

HTML_QuickForm is a PEAR package that provides methods for creating, validating and processing HTML forms.

The purpose of Keith Edmunds tutorial is to give the new users of QuickForm an overview of its features and usage patterns. It describes a small subset of available functionality.

Don't forget to read also the PEAR Manual, HTML_QuickForm related part.

HTML_QuickForm_Controller is a PEAR package that implements a PageController design pattern, which essentially means that there is a single page processing requests and actions this page performs.

This package is used only with the HTML_Progress2_Generator (an interactive tools to create your own progress meter).

Don't forget to read also the PEAR Manual, HTML_QuickForm_Controller related part.

PEAR (an acronym for PHP Extension and Application Repository) is a framework and distribution system for reusable PHP components.

Don't forget to read also the PEAR Manual and PEAR FAQ.

PEAR_ErrorStack implements error raising and handling using a stack pattern. This has tremendous advantages over the PEAR_Error Implementation.

Don't forget to read also the PEAR Manual, PEAR_ErrorStack related part.

Event_Dispatcher is a PEAR package that acts as a notification dispatch table. It is used to notify other objects of interesting things.

Event_Dispatcher is used to allow observers to hook into the progress meter process. Whenever a progress bar value changes, a notification onChange is sent. Others notification events are available: onSubmit, onLoad, and onCancel (for monitor only).

Don't forget to read also the PEAR Manual, Event_Dispatcher related part.

You've forgot to put the necessary styles (CSS) on your HTML document. Add the getStyle() method.

Either with the style tags :

Or without the style tags :

The waiting bar of your favorite browser is running, but you don't see anything on the screen. You've forgot to put the necessary javascript code that manage the progress meter. Add the getStcript() method.

Either with the script tags :

Or without the script tags :

Using run() method rather than coding a loop as in above example, you've forgot to give a delay to progress animation. Because it's not necessary in real world, almost all cases, the delay is fixed at zero (default behavior). Use the setAnimSpeed() method to set the delay from 1 to 1000 milliseconds. In example below delay is only 0.5 second.

Another possible reason is due to your firewall or anti-virus software. Check-out if the web content protection is active or not. If is set to true, try to de-activate it and see if you have still the problem.

	Note
	Thanks to Mathieu GRELIER for his feedback on anti-virus software problem : Progress2 (and PHP flush function) is not compatible with real-time web parsing softwares.

	Tip
	With Kaspersky Anti-Virus 6, look in configuration panel, network port control, and de-activate the http-standard port 80.

Before AJAX it was impossible to do with a pure PHP solution. By the way, there are some mixed solutions that exists on the Web. Here is a short list :

Now with AJAX, and some PHP extension (like APC with PHP 5.2+, or PECL uploadprogress) that used the RFC1867 hook to track progress of file upload, dream begin a reality !

See chapter How to to implement an AJAX Upload with Progress Bar solution to learn more.

Since release 2.3.0, there was an existing text file included into distribution named HOWTO_AJAX.txt. Content of this file is now integrated into this guide. Read chapter How to to implement an AJAX Progress Bar to learn more.