Search moodle.org's
Developer Documentation

See Release Notes
Long Term Support Release

  • Bug fixes for general core bugs in 4.1.x will end 13 November 2023 (12 months).
  • Bug fixes for security issues in 4.1.x will end 10 November 2025 (36 months).
  • PHP version: minimum PHP 7.4.0 Note: minimum PHP version has increased since Moodle 4.0. PHP 8.0.x is supported too.

(no description)

File Size: 71 lines (3 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 1 class

file_progress:: (1 method):
  progress()


Interface: file_progress  - X-Ref

Simple interface for receiving progress during long-running file
operations.

In some cases progress can be reported precisely. In other cases,
progress is indeterminate which means that the progress function is called
periodically but without information on completion.

progress($progress = self::INDETERMINATE, $max = self::INDETERMINATE)   X-Ref
Called during a file processing operation that reports progress.

This function will be called periodically during the operation, assuming
it is successful.

The $max value will be the same for each call to progress() within an
operation.

If numbers (rather than INDETERMINATE) are provided, then:
- The $progress value will either be the same as last call, or increased
by some value (not necessarily 1)
- The $progress value will be less than or equal to the $max value.

There is no guarantee that this function will be called for every value
in the range, or that it will be called with $progress == $max.

The function may be called very frequently (e.g. after each file) or
quite rarely (e.g. after each large file).

When creating an implementation of this function, you probably want to
do the following:

1. Check the current time and do not do anything if it's less than a
second since the last time you reported something.
2. Update the PHP timeout (i.e. set it back to 2 minutes or whatever)
so that the system will not time out.
3. If the progress is unchanged since last second, still display some
output to the user. (Setting PHP timeout is not sufficient; some
front-end servers require that data is output to the browser every
minute or so, or they will time out on their own.)

param: int $progress Current progress, or INDETERMINATE if unknown
param: int $max Max progress, or INDETERMINATE if unknown