Add Flash "Get All" methods

- Segment::getFlashAll();
- Segment::getFlashNextAll();

Author: jakejohns

Diff for: README.md

@@ -114,6 +114,9 @@ Then, in subsequent requests, we can read the flash value using `getFlash()`:
 <?php
 $segment = $session->getSegment('Vendor\Package\ClassName');
 $message = $segment->getFlash('message'); // 'Hello world!'
+
+// You can also get all the flash messages
+$messages = $segment->getFlashAll();
 ?>
 ```
 

Diff for: src/Segment.php

@@ -165,6 +165,23 @@ public function getFlash($key, $alt = null)
              : $alt;
     }
 
+    /**
+     *
+     * Gets all the flash values in the *current* request.
+     *
+     * @param mixed $alt An alternative value to return if no flash values are set.
+     *
+     * @return mixed The flash values themselves.
+     *
+     */
+    public function getFlashAll($alt = array())
+    {
+        $this->resumeSession();
+        return isset($_SESSION[Session::FLASH_NOW][$this->name])
+             ? $_SESSION[Session::FLASH_NOW][$this->name]
+             : $alt;
+    }
+
     /**
      *
      * Clears flash values for *only* the next request.
@@ -198,6 +215,23 @@ public function getFlashNext($key, $alt = null)
              : $alt;
     }
 
+    /**
+     *
+     * Gets all flash values for the *next* request.
+     *
+     * @param mixed $alt An alternative value to return if no flash values set.
+     *
+     * @return mixed The flash values themselves.
+     *
+     */
+    public function getFlashNextAll($alt = array())
+    {
+        $this->resumeSession();
+        return isset($_SESSION[Session::FLASH_NEXT][$this->name])
+             ? $_SESSION[Session::FLASH_NEXT][$this->name]
+             : $alt;
+    }
+
     /**
      *
      * Sets a flash value for the *next* request *and* the current one.

Diff for: src/SegmentInterface.php

@@ -83,6 +83,17 @@ public function setFlash($key, $val);
      */
     public function getFlash($key, $alt = null);
 
+    /**
+     *
+     * Gets all the flash values in the *current* request.
+     *
+     * @param mixed $alt An alternative value to return if no flash values are set.
+     *
+     * @return mixed The flash values themselves.
+     *
+     */
+    public function getFlashAll($alt = array());
+
     /**
      *
      * Clears flash values for *only* the next request.
@@ -105,6 +116,17 @@ public function clearFlash();
      */
     public function getFlashNext($key, $alt = null);
 
+    /**
+     *
+     * Gets all flash values for the *next* request.
+     *
+     * @param mixed $alt An alternative value to return if no flash values set.
+     *
+     * @return mixed The flash values themselves.
+     *
+     */
+    public function getFlashNextAll($alt = array());
+
     /**
      *
      * Sets a flash value for the *next* request *and* the current one.

Diff for: tests/SegmentTest.php

@@ -84,13 +84,18 @@ public function testFlash()
         // set a value
         $this->segment->setFlash('foo', 'bar');
         $expect = 'bar';
+        $expectAll = ['foo' => 'bar'];
         $this->assertSame($expect, $this->segment->getFlashNext('foo'));
+        $this->assertSame($expectAll, $this->segment->getFlashNextAll());
         $this->assertNull($this->segment->getFlash('foo'));
+        $this->assertSame(array(), $this->segment->getFlashAll());
 
         // set a value and make it available now
         $this->segment->setFlashNow('baz', 'dib');
         $expect = 'dib';
+        $expectAll = ['baz' => 'dib'];
         $this->assertSame($expect, $this->segment->getFlash('baz'));
+        $this->assertSame($expectAll, $this->segment->getFlashAll());
         $this->assertSame($expect, $this->segment->getFlashNext('baz'));
 
         // clear the next values