mirror of
https://github.com/phpbb/phpbb.git
synced 2025-06-28 14:18:52 +00:00
[ticket/11924] Add option to export php event list
PHPBB3-11924
This commit is contained in:
Joas Schilling
parent
a03965554e
commit
e04a06ab94
1 changed files with 242 additions and 0 deletions
|
|
@ -18,6 +18,9 @@ function usage()
|
||||||
echo "\n";
|
echo "\n";
|
||||||
echo "styles:\n";
|
echo "styles:\n";
|
||||||
echo " Export all events for files in the prosilver and subsilver2 styles.\n";
|
echo " Export all events for files in the prosilver and subsilver2 styles.\n";
|
||||||
|
echo "\n";
|
||||||
|
echo "php:\n";
|
||||||
|
echo " Export all events for php-files.\n";
|
||||||
exit(2);
|
exit(2);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
@ -70,6 +73,241 @@ function export_from_eventsmd($filter)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
function export_from_php()
|
||||||
|
{
|
||||||
|
global $phpbb_root_path;
|
||||||
|
|
||||||
|
$files = get_file_list($phpbb_root_path);
|
||||||
|
$events = array();
|
||||||
|
foreach ($files as $file)
|
||||||
|
{
|
||||||
|
$file_events = check_for_events($file);
|
||||||
|
if (!empty($file_events))
|
||||||
|
{
|
||||||
|
$events = array_merge($events, $file_events);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
ksort($events);
|
||||||
|
|
||||||
|
foreach ($events as $event)
|
||||||
|
{
|
||||||
|
echo '|- id="' . $event['event'] . '"' . "\n";
|
||||||
|
echo '| [[#' . $event['event'] . '|' . $event['event'] . ']] || ' . $event['file'] . ' || ' . implode(', ', $event['arguments']) . ' || ' . $event['since'] . ' || ' . $event['description'] . "\n";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function check_for_events($file)
|
||||||
|
{
|
||||||
|
global $phpbb_root_path;
|
||||||
|
|
||||||
|
$events = array();
|
||||||
|
$content = file_get_contents($phpbb_root_path . $file);
|
||||||
|
|
||||||
|
if (strpos($content, "phpbb_dispatcher->trigger_event('") || strpos($content, "phpbb_dispatcher->dispatch('"))
|
||||||
|
{
|
||||||
|
$lines = explode("\n", $content);
|
||||||
|
for ($i = 0, $num_lines = sizeof($lines); $i < $num_lines; $i++)
|
||||||
|
{
|
||||||
|
if ($found_trigger_event = strpos($lines[$i], "phpbb_dispatcher->trigger_event('"))
|
||||||
|
{
|
||||||
|
$event_line = $i;
|
||||||
|
$event_name = $lines[$event_line];
|
||||||
|
$event_name = substr($event_name, $found_trigger_event + strlen("phpbb_dispatcher->trigger_event('"));
|
||||||
|
$event_name = substr($event_name, 0, strpos($event_name, "'"));
|
||||||
|
|
||||||
|
// Validate @event name
|
||||||
|
$find_event_line = 1;
|
||||||
|
while (strpos($lines[$event_line - $find_event_line], '* @event ') === false)
|
||||||
|
{
|
||||||
|
$find_event_line++;
|
||||||
|
|
||||||
|
if ($find_event_line > min(50, $event_line))
|
||||||
|
{
|
||||||
|
throw new LogicException('Can not find @event tag for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$event_name_tag = substr(trim($lines[$event_line - $find_event_line]), strlen('* @event '));
|
||||||
|
if ($event_name_tag !== $event_name)
|
||||||
|
{
|
||||||
|
throw new LogicException('Event name does not match @event tag for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find $vars array lines
|
||||||
|
$find_varsarray_line = 1;
|
||||||
|
while (strpos($lines[$event_line - $find_varsarray_line], "vars = array('") === false)
|
||||||
|
{
|
||||||
|
$find_varsarray_line++;
|
||||||
|
|
||||||
|
if ($find_varsarray_line > min(50, $event_line))
|
||||||
|
{
|
||||||
|
throw new LogicException('Can not find "$vars = array()"-line for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$varsarray = substr(trim($lines[$event_line - $find_varsarray_line]), strlen("\$vars = array('"), -3);
|
||||||
|
$arguments = explode("', '", $varsarray);
|
||||||
|
|
||||||
|
// Validate $vars array with @var
|
||||||
|
$find_vars_line = 3;
|
||||||
|
$doc_vars = array();
|
||||||
|
while (strpos(trim($lines[$event_line - $find_vars_line]), '*') === 0)
|
||||||
|
{
|
||||||
|
$var_line = trim($lines[$event_line - $find_vars_line]);
|
||||||
|
$var_line = preg_replace('!\s+!', ' ', $var_line);
|
||||||
|
if (strpos($var_line, '* @var ') === 0)
|
||||||
|
{
|
||||||
|
$doc_line = explode(' ', $var_line);
|
||||||
|
if (isset($doc_line[3]))
|
||||||
|
{
|
||||||
|
$doc_vars[] = $doc_line[3];
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$find_vars_line++;
|
||||||
|
}
|
||||||
|
if (sizeof($arguments) !== sizeof($doc_vars) && array_intersect($arguments, $doc_vars))
|
||||||
|
{
|
||||||
|
throw new LogicException('$vars array does not match the list of @var tags for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find @since
|
||||||
|
$find_since_line = 1;
|
||||||
|
while (strpos($lines[$event_line - $find_since_line], '* @since ') === false)
|
||||||
|
{
|
||||||
|
$find_since_line++;
|
||||||
|
|
||||||
|
if ($find_since_line > min(50, $event_line))
|
||||||
|
{
|
||||||
|
throw new LogicException('Can not find @since tag for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$since = substr(trim($lines[$event_line - $find_since_line]), strlen('* @since '));
|
||||||
|
$since = ($since == '3.1-A1') ? '3.1.0-a1' : $since;
|
||||||
|
|
||||||
|
// Find event description line
|
||||||
|
$find_description_line = 3;
|
||||||
|
while (strpos(trim($lines[$event_line - $find_description_line]), '*') === 0)
|
||||||
|
{
|
||||||
|
$find_description_line++;
|
||||||
|
|
||||||
|
if ($find_description_line > min(50, $event_line))
|
||||||
|
{
|
||||||
|
throw new LogicException('Can not find description-line for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
$description = substr(trim($lines[$event_line - $find_description_line + 1]), strlen('* '));
|
||||||
|
|
||||||
|
$events[$event_name] = array(
|
||||||
|
'event' => $event_name,
|
||||||
|
'file' => $file,
|
||||||
|
'arguments' => $arguments,
|
||||||
|
'since' => $since,
|
||||||
|
'description' => $description,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
if ($found_trigger_event = strpos($lines[$i], "phpbb_dispatcher->dispatch('"))
|
||||||
|
{
|
||||||
|
$event_line = $i;
|
||||||
|
$event_name = $lines[$event_line];
|
||||||
|
$event_name = substr($event_name, $found_trigger_event + strlen("phpbb_dispatcher->dispatch('"));
|
||||||
|
$event_name = substr($event_name, 0, strpos($event_name, "'"));
|
||||||
|
|
||||||
|
// Validate @event name
|
||||||
|
$find_event_line = 1;
|
||||||
|
while (strpos($lines[$event_line - $find_event_line], '* @event ') === false)
|
||||||
|
{
|
||||||
|
$find_event_line++;
|
||||||
|
}
|
||||||
|
$event_name_tag = substr(trim($lines[$event_line - $find_event_line]), strlen('* @event '));
|
||||||
|
if ($event_name_tag !== $event_name)
|
||||||
|
{
|
||||||
|
throw new LogicException('Event name does not match @event tag for event "' . $event_name . '" in file "' . $file . '"');
|
||||||
|
}
|
||||||
|
|
||||||
|
// Find @since
|
||||||
|
$find_since_line = 1;
|
||||||
|
while (strpos($lines[$event_line - $find_since_line], '* @since ') === false)
|
||||||
|
{
|
||||||
|
$find_since_line++;
|
||||||
|
}
|
||||||
|
$since = substr(trim($lines[$event_line - $find_since_line]), strlen('* @since '));
|
||||||
|
$since = ($since == '3.1-A1') ? '3.1.0-a1' : $since;
|
||||||
|
|
||||||
|
// Find event description line
|
||||||
|
$find_description_line = 3;
|
||||||
|
while (strpos(trim($lines[$event_line - $find_description_line]), '*') === 0)
|
||||||
|
{
|
||||||
|
$find_description_line++;
|
||||||
|
}
|
||||||
|
$description = substr(trim($lines[$event_line - $find_description_line + 1]), strlen('* '));
|
||||||
|
|
||||||
|
$events[$event_name] = array(
|
||||||
|
'event' => $event_name,
|
||||||
|
'file' => $file,
|
||||||
|
'arguments' => array(),
|
||||||
|
'since' => $since,
|
||||||
|
'description' => $description,
|
||||||
|
);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $events;
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Returns a list of files in that directory
|
||||||
|
*
|
||||||
|
* 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 = '')
|
||||||
|
{
|
||||||
|
try
|
||||||
|
{
|
||||||
|
$iterator = new \DirectoryIterator($dir);
|
||||||
|
}
|
||||||
|
catch (Exception $e)
|
||||||
|
{
|
||||||
|
return array();
|
||||||
|
}
|
||||||
|
|
||||||
|
$files = array();
|
||||||
|
foreach ($iterator as $file_info)
|
||||||
|
{
|
||||||
|
if ($file_info->isDot())
|
||||||
|
{
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
|
||||||
|
// Do not scan some directories
|
||||||
|
if ($file_info->isDir() && (
|
||||||
|
($path == '' && in_array($file_info->getFilename(), array('cache', 'develop', 'ext', 'files', 'language', 'store', 'vendor')))
|
||||||
|
|| ($path == '/includes' && in_array($file_info->getFilename(), array('utf')))
|
||||||
|
|| ($path == '/phpbb/db/migration' && in_array($file_info->getFilename(), array('data')))
|
||||||
|
|| ($path == '/phpbb' && in_array($file_info->getFilename(), array('event')))
|
||||||
|
))
|
||||||
|
{
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
else if ($file_info->isDir())
|
||||||
|
{
|
||||||
|
$sub_dir = get_file_list($file_info->getPath() . '/' . $file_info->getFilename(), $path . '/' . $file_info->getFilename());
|
||||||
|
foreach ($sub_dir as $file)
|
||||||
|
{
|
||||||
|
$files[] = $file_info->getFilename() . '/' . $file;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
else if ($file_info->getExtension() == 'php')
|
||||||
|
{
|
||||||
|
$files[] = $file_info->getFilename();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return $files;
|
||||||
|
}
|
||||||
|
|
||||||
function validate_argument_count($count)
|
function validate_argument_count($count)
|
||||||
{
|
{
|
||||||
global $argv;
|
global $argv;
|
||||||
|
|
@ -94,6 +332,10 @@ switch ($action)
|
||||||
export_from_eventsmd('styles');
|
export_from_eventsmd('styles');
|
||||||
break;
|
break;
|
||||||
|
|
||||||
|
case 'php':
|
||||||
|
export_from_php();
|
||||||
|
break;
|
||||||
|
|
||||||
default:
|
default:
|
||||||
usage();
|
usage();
|
||||||
}
|
}
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue