1
0
mirror of https://github.com/phpbb/phpbb.git synced 2025-05-12 02:25:18 +02:00
php-phpbb/phpBB/includes/cron/provider.php

93 lines
2.1 KiB
PHP

<?php
/**
*
* @package phpBB3
* @copyright (c) 2011 phpBB Group
* @license http://opensource.org/licenses/gpl-license.php GNU Public License
*
*/
/**
* @ignore
*/
if (!defined('IN_PHPBB'))
{
exit;
}
/**
* Provides cron manager with tasks
*
* Finds installed cron tasks and makes them available to the cron manager.
*
* @package phpBB3
*/
class phpbb_cron_provider implements IteratorAggregate
{
/**
* Array holding all found task class names.
*
* @var array
*/
protected $task_names = array();
/**
* An extension manager to search for cron tasks in extensions.
* @var phpbb_extension_manager
*/
protected $extension_manager;
/**
* Constructor. Loads all available tasks.
*
* Tasks will be looked up in the core task directory located in
* includes/cron/task/core/ and in extensions. Task classes will be
* autoloaded and must be named according to autoloading naming conventions.
*
* Tasks in extensions must be located in a directory called cron or a subdir
* of a directory called cron. The class and filename must end in a _task
* suffix.
*
* @param phpbb_extension_manager $extension_manager phpBB extension manager
*/
public function __construct(phpbb_extension_manager $extension_manager)
{
$this->extension_manager = $extension_manager;
$this->task_names = $this->find_cron_task_names();
}
/**
* Finds cron task names using the extension manager.
*
* All PHP files in includes/cron/task/core/ are considered tasks. Tasks
* in extensions have to be located in a directory called cron or a subdir
* of a directory called cron. The class and filename must end in a _task
* suffix.
*
* @return array List of task names
*/
public function find_cron_task_names()
{
$finder = $this->extension_manager->get_finder();
return $finder
->suffix('_task')
->directory('/cron')
->default_path('includes/cron/task/core/')
->default_suffix('')
->default_directory('')
->get_classes();
}
/**
* Retrieve an iterator over all task names
*
* @return ArrayIterator An iterator for the array of task names
*/
public function getIterator()
{
return new ArrayIterator($this->task_names);
}
}