Moodle PHP Documentation 4.2
Moodle 4.2.8 (Build: 20240610) (2d41ac46f45)
file_progress Interface Reference
Inheritance diagram for file_progress:
restore_ui_stage_confirm

Public Member Functions

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

Public Attributes

int const INDETERMINATE = -1
 Constant used for indeterminate progress.
 

Member Function Documentation

◆ progress()

file_progress::progress ( $progress = self::INDETERMINATE,
$max = self::INDETERMINATE )

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.)
Parameters
int$progressCurrent progress, or INDETERMINATE if unknown
int$maxMax progress, or INDETERMINATE if unknown

Implemented in restore_ui_stage_confirm.


The documentation for this interface was generated from the following file: