[Stopwatch] Add getLastPeriod method to StopwatchEvent

Author: hacfi

src/Symfony/Component/Stopwatch/CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.2
+---
+
+ * Add method `getLastPeriod()` to `StopwatchEvent`
+
 5.2
 ---
 

src/Symfony/Component/Stopwatch/StopwatchEvent.php

@@ -136,6 +136,18 @@ public function getPeriods(): array
         return $this->periods;
     }
 
+    /**
+     * Gets the last event period.
+     */
+    public function getLastPeriod(): ?StopwatchPeriod
+    {
+        if ([] === $this->periods) {
+            return null;
+        }
+
+        return $this->periods[array_key_last($this->periods)];
+    }
+
     /**
      * Gets the relative time of the start of the first period in milliseconds.
      */

src/Symfony/Component/Stopwatch/StopwatchPeriod.php

@@ -12,7 +12,7 @@
 namespace Symfony\Component\Stopwatch;
 
 /**
- * Represents an Period for an Event.
+ * Represents a Period for an Event.
  *
  * @author Fabien Potencier <[email protected]>
  */