$stmts * @param bool $check_continue - also looks for a continue * @param bool $check_break * * @return bool */ public static function doesLeaveBlock(array $stmts, $check_continue = true, $check_break = true) { if (empty($stmts)) { return false; } for ($i = count($stmts) - 1; $i >= 0; --$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Return_ || $stmt instanceof PhpParser\Node\Stmt\Throw_ || $stmt instanceof PhpParser\Node\Expr\Exit_ || ($check_continue && $stmt instanceof PhpParser\Node\Stmt\Continue_) || ($check_break && $stmt instanceof PhpParser\Node\Stmt\Break_) ) { return true; } if ($stmt instanceof PhpParser\Node\Stmt\If_) { if ($stmt->else && self::doesLeaveBlock($stmt->stmts, $check_continue, $check_break) && self::doesLeaveBlock($stmt->else->stmts, $check_continue, $check_break) ) { if (empty($stmt->elseifs)) { return true; } foreach ($stmt->elseifs as $elseif) { if (!self::doesLeaveBlock($elseif->stmts, $check_continue, $check_break)) { return false; } } return true; } } if ($stmt instanceof PhpParser\Node\Stmt\Switch_) { $has_left = false; $has_default_leaver = false; // iterate backwards in a case statement for ($i = count($stmt->cases) - 1; $i >= 0; --$i) { $case = $stmt->cases[$i]; $case_does_leave = self::doesEverBreakOrContinue($case->stmts, true); if ($case_does_leave) { $has_left = true; } if (!$case_does_leave && !$has_left) { return false; } if (!$case->cond && $case_does_leave) { $has_default_leaver = true; } } return $has_default_leaver; } if ($stmt instanceof PhpParser\Node\Stmt\Nop) { continue; } return false; } return false; } /** * @param array $stmts * * @return bool */ public static function doesEverBreak(array $stmts) { if (empty($stmts)) { return false; } for ($i = count($stmts) - 1; $i >= 0; --$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Break_) { return true; } if ($stmt instanceof PhpParser\Node\Stmt\If_) { if (self::doesEverBreak($stmt->stmts)) { return true; } if ($stmt->else && self::doesEverBreak($stmt->else->stmts)) { return true; } foreach ($stmt->elseifs as $elseif) { if (self::doesEverBreak($elseif->stmts)) { return true; } } } } return false; } /** * @param array $stmts * @param bool $ignore_break * * @return bool */ public static function doesEverBreakOrContinue(array $stmts, $ignore_break = false) { if (empty($stmts)) { return false; } for ($i = count($stmts) - 1; $i >= 0; --$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Continue_ || (!$ignore_break && $stmt instanceof PhpParser\Node\Stmt\Break_) ) { return true; } if ($stmt instanceof PhpParser\Node\Stmt\If_) { if (self::doesEverBreakOrContinue($stmt->stmts, $ignore_break)) { return true; } if ($stmt->else && self::doesEverBreakOrContinue($stmt->else->stmts, $ignore_break)) { return true; } foreach ($stmt->elseifs as $elseif) { if (self::doesEverBreakOrContinue($elseif->stmts, $ignore_break)) { return true; } } } if ($stmt instanceof PhpParser\Node\Stmt\Switch_) { // iterate backwards // in switch statements we only care here about continue for ($i = count($stmt->cases) - 1; $i >= 0; --$i) { $case = $stmt->cases[$i]; if (self::doesEverBreakOrContinue($case->stmts, true)) { return true; } } } if ($stmt instanceof PhpParser\Node\Stmt\Nop) { continue; } } return false; } /** * @param array $stmts * @param bool $ignore_break * * @return bool */ public static function doesAlwaysBreakOrContinue(array $stmts, $ignore_break = false) { if (empty($stmts)) { return false; } for ($i = count($stmts) - 1; $i >= 0; --$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Continue_ || (!$ignore_break && $stmt instanceof PhpParser\Node\Stmt\Break_) ) { return true; } if ($stmt instanceof PhpParser\Node\Stmt\If_) { if (!self::doesAlwaysBreakOrContinue($stmt->stmts, $ignore_break)) { return false; } if (!$stmt->else || !self::doesAlwaysBreakOrContinue($stmt->else->stmts, $ignore_break)) { return false; } foreach ($stmt->elseifs as $elseif) { if (!self::doesAlwaysBreakOrContinue($elseif->stmts, $ignore_break)) { return false; } } return true; } if ($stmt instanceof PhpParser\Node\Stmt\Switch_) { // iterate backwards // in switch statements we only care here about continue for ($i = count($stmt->cases) - 1; $i >= 0; --$i) { $case = $stmt->cases[$i]; if (!self::doesAlwaysBreakOrContinue($case->stmts, true)) { return false; } } return true; } if ($stmt instanceof PhpParser\Node\Stmt\Nop) { continue; } } return false; } /** * @param array $stmts * * @return string[] one or more of 'LEAVE', 'CONTINUE', 'BREAK' (or empty if no single action is found) */ public static function getFinalControlActions(array $stmts) { if (empty($stmts)) { return [SELF::ACTION_NONE]; } $control_actions = []; for ($i = 0, $c = count($stmts); $i < $c; ++$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Return_ || $stmt instanceof PhpParser\Node\Stmt\Throw_ || $stmt instanceof PhpParser\Node\Expr\Exit_ ) { return [self::ACTION_END]; } if ($stmt instanceof PhpParser\Node\Stmt\Continue_) { return [self::ACTION_CONTINUE]; } if ($stmt instanceof PhpParser\Node\Stmt\Break_) { return [self::ACTION_BREAK]; } if ($stmt instanceof PhpParser\Node\Stmt\If_) { $if_statement_actions = self::getFinalControlActions($stmt->stmts); $else_statement_actions = $stmt->else ? self::getFinalControlActions($stmt->else->stmts) : []; $all_same = count($if_statement_actions) === 1 && $if_statement_actions == $else_statement_actions && $if_statement_actions !== [self::ACTION_NONE]; $all_elseif_actions = []; if ($stmt->elseifs) { foreach ($stmt->elseifs as $elseif) { $elseif_control_actions = self::getFinalControlActions($elseif->stmts); $all_same = $all_same && $elseif_control_actions == $if_statement_actions; if (!$all_same) { $all_elseif_actions = array_merge($elseif_control_actions, $all_elseif_actions); } } } if ($all_same) { return $if_statement_actions; } $control_actions = array_merge( $control_actions, $if_statement_actions, $else_statement_actions, $all_elseif_actions ); } if ($stmt instanceof PhpParser\Node\Stmt\Switch_) { $has_returned = false; $has_default_terminator = false; // iterate backwards in a case statement for ($d = count($stmt->cases) - 1; $d >= 0; --$d) { $case = $stmt->cases[$d]; $case_actions = self::getFinalControlActions($case->stmts); if (array_intersect([self::ACTION_BREAK, self::ACTION_CONTINUE], $case_actions)) { continue 2; } $case_does_return = $case_actions == [self::ACTION_END]; if ($case_does_return) { $has_returned = true; } if (!$case_does_return && !$has_returned) { continue 2; } if (!$case->cond && $case_does_return) { $has_default_terminator = true; } } if ($has_default_terminator) { return [self::ACTION_END]; } } if ($stmt instanceof PhpParser\Node\Stmt\While_) { $control_actions = array_merge(self::getFinalControlActions($stmt->stmts), $control_actions); } if ($stmt instanceof PhpParser\Node\Stmt\Do_) { $do_actions = self::getFinalControlActions($stmt->stmts); if (count($do_actions) && !in_array(self::ACTION_NONE, $do_actions, true)) { return $do_actions; } $control_actions = array_merge($control_actions, $do_actions); } if ($stmt instanceof PhpParser\Node\Stmt\TryCatch) { $try_statement_actions = self::getFinalControlActions($stmt->stmts); if ($stmt->catches) { $all_same = count($try_statement_actions) === 1; $all_catch_actions = []; foreach ($stmt->catches as $catch) { $catch_actions = self::getFinalControlActions($catch->stmts); $all_same = $all_same && $try_statement_actions == $catch_actions; if (!$all_same) { $control_actions = array_merge($control_actions, $catch_actions); } } if ($all_same) { return $try_statement_actions; } } $control_actions = array_merge($control_actions, $try_statement_actions); } } $control_actions[] = SELF::ACTION_NONE; return array_unique($control_actions); } /** * @param array $stmts * * @return bool */ public static function onlyThrows(array $stmts) { if (empty($stmts)) { return false; } for ($i = count($stmts) - 1; $i >= 0; --$i) { $stmt = $stmts[$i]; if ($stmt instanceof PhpParser\Node\Stmt\Throw_) { return true; } if ($stmt instanceof PhpParser\Node\Stmt\Nop) { continue; } return false; } return false; } }