mirror of
https://github.com/phpbb/phpbb.git
synced 2025-02-25 04:23:38 +01:00
c7a986eccd
The enable or purge operation of an extension could take a long time if an expensive operation needs to be executed on a large set of data. To allow this to succeed from a web interface with max_execution_time set in the webserver's php configuration, subsequent requests must continue the operation started earlier. So individual enable and purge implementations must be able to spread their work across multiple steps. PHPBB3-10323
63 lines
1.6 KiB
PHP
63 lines
1.6 KiB
PHP
<?php
|
|
/**
|
|
*
|
|
* @package extension
|
|
* @copyright (c) 2011 phpBB Group
|
|
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
|
|
*
|
|
*/
|
|
|
|
/**
|
|
* @ignore
|
|
*/
|
|
if (!defined('IN_PHPBB'))
|
|
{
|
|
exit;
|
|
}
|
|
|
|
/**
|
|
* The interface extension meta classes have to implement to run custom code
|
|
* on enable/disable/purge.
|
|
*
|
|
* @package extension
|
|
*/
|
|
interface phpbb_extension_interface
|
|
{
|
|
/**
|
|
* enable_step is executed on enabling an extension until it returns false.
|
|
*
|
|
* Calls to this function can be made in subsequent requests, when the
|
|
* function is invoked through a webserver with a too low max_execution_time.
|
|
*
|
|
* @param mixed $old_state The return value of the previous call
|
|
* of this method, or false on the first call
|
|
* @return mixed Returns false after last step, otherwise
|
|
* temporary state which is passed as an
|
|
* argument to the next step
|
|
*/
|
|
public function enable_step($old_state);
|
|
|
|
/**
|
|
* Disables the extension.
|
|
*
|
|
* Must be a quick operation, that finishes within max_execution_time.
|
|
*
|
|
* @return null
|
|
*/
|
|
public function disable();
|
|
|
|
/**
|
|
* purge_step is executed on purging an extension until it returns false.
|
|
*
|
|
* Calls to this function can be made in subsequent requests, when the
|
|
* function is invoked through a webserver with a too low max_execution_time.
|
|
*
|
|
* @param mixed $old_state The return value of the previous call
|
|
* of this method, or false on the first call
|
|
* @return mixed Returns false after last step, otherwise
|
|
* temporary state which is passed as an
|
|
* argument to the next step
|
|
*/
|
|
public function purge_step($old_state);
|
|
}
|