/** @var string */

protected $root_path;

/**

* @param string $phpbb_root_path

*/

public function __construct($phpbb_root_path)

{

$this->root_path = $phpbb_root_path;

}

function export_from_eventsmd($filter)

function export_from_php()

{

$files = $this->get_file_list($this->root_path);

foreach ($files as $file)

{

}

{

echo '|- id="' . $event['event'] . '"' . "\n";

echo '| [[#' . $event['event'] . '|' . $event['event'] . ']] || ' . $event['file'] . ' || ' . implode(', ', $event['arguments']) . ' || ' . $event['since'] . ' || ' . $event['description'] . "\n";

}

}

public function check_for_events($file)

{

if (strpos($content, "dispatcher->trigger_event('") || strpos($content, "dispatcher->dispatch('"))

{

{

$event_line = false;

if ($found_trigger_event !== false)

{

$event_line = $i;

// Find variables of the event

}

else

{

if ($found_dispatch !== false)

{

$event_line = $i;

$arguments = array();

}

}

if ($event_line)

{

// Validate @event

// Validate @since

// Find event description line

'arguments' => $arguments,

'since' => $since,

'description' => $description,

}

}

}

}

/**

* Find the name of the event inside the dispatch() line

*

* @param string $event_line

* @return int Absolute line number

*/

{

$event_line = ltrim($event_line, "\t");

preg_match($regex, $event_line, $match);

if (!isset($match[2]))

{

}

return $match[2];

/**

* Find the name of the event inside the trigger_event() line

*

* @param string $event_line

* @return int Absolute line number

*/

{

$event_line = ltrim($event_line, "\t");

preg_match($regex, $event_line, $match);

if (!isset($match[2]))

{

}

return $match[2];

/**

* Find the $vars array

*

* @return array List of variables

*/

{

if (strpos($vars_line, "\$vars = array('") !== 0 || substr($vars_line, -3) !== '\');')

{

}

$vars_array = substr($vars_line, strlen("\$vars = array('"), 0 - strlen('\');'));

if ($vars_array === '')

{

}

$vars_array = explode("', '", $vars_array);

{

if (!preg_match('#^([a-zA-Z_][a-zA-Z0-9_]*)$#', $var))

{

}

}

/**

* Find the $vars array

*

* @return array List of variables

*/

{

$doc_vars = array();

$current_doc_line = 1;

$found_comment_end = false;

{

{

$found_comment_end = true;

}

if ($found_comment_end)

{

$var_line = preg_replace('!\s+!', ' ', $var_line);

if (strpos($var_line, '* @var ') === 0)

{

$doc_line = explode(' ', $var_line, 5);

if (sizeof($doc_line) !== 5)

{

}

$doc_vars[] = $doc_line[3];

}

}

$current_doc_line++;

{

// Reached the start of the file

}

}

if (empty($doc_vars))

{

// Reached the start of the file

}

foreach ($doc_vars as $var)

{

if (!preg_match('#^([a-zA-Z_][a-zA-Z0-9_]*)$#', $var))

{

}

}

/**

* Find the "@since" Information line

*

* @return int Absolute line number

*/

{

}

/**

* Find the "@event" Information line

*

* @return int Absolute line number

*/

{

}

/**

* Find a "@*" Information line

*

* @param string $find_tag Name of the tag we are trying to find

* @param array $disallowed_tags List of tags that must not appear between

* the tag and the actual event

* @return int Absolute line number

*/

{

$find_tag_line = 0;

$found_comment_end = false;

{

{

// Reached the start of this doc block

}

foreach ($disallowed_tags as $disallowed_tag)

{

{

// Found @var after the @since

}

}

{

$found_comment_end = true;

}

$find_tag_line++;

{

// Reached the start of the file

}

}

}

/**

* Find a "@*" Information line

*

* @return int Absolute line number

*/

{

$find_desc_line = 0;

{

$find_desc_line++;

{

// Reached the start of the file

}

}

if (strpos($desc, '* @') === 0 || $desc[0] !== '*' || substr($desc, 1) == '')

{

// First line of the doc block is a @-line, empty or only contains "*"

}

return $find_desc_line;

/**

* Validate "@since" Information

*

* @param string $line

* @return string

*/

{

$since = substr(ltrim($line, "\t"), strlen('* @since '));

if ($since !== trim($since))

{

}

$since = ($since === '3.1-A1') ? '3.1.0-a1' : $since;

if (!preg_match('#^\d+\.\d+\.\d+(?:-(?:a|b|rc|pl)\d+)?$#', $since))

{

}

return $since;

/**

* Validate "@event" Information

*

* @param string $event_name

* @param string $line

* @return string

*/

{

$event = substr(ltrim($line, "\t"), strlen('* @event '));

if ($event !== trim($event))

{

}

if ($event !== $event_name)

{

}

return $event;

/**

* Validates that two arrays contain the same strings

*

* @param array $vars_array Variables found in the array line

* @param array $vars_docblock Variables found in the doc block

* @return null

*/

{

$vars_array = array_unique($vars_array);

$vars_docblock = array_unique($vars_docblock);

if ($sizeof_vars_array !== sizeof($vars_docblock) || $sizeof_vars_array !== sizeof(array_intersect($vars_array, $vars_docblock)))

{

}

}

* Works recursive with any depth

*

* @param string $dir Directory to go through

* @return array List of files (including directories from within $dir

*/

function get_file_list($dir, $path = '')