From 01c6bc9c08d388ecbf4c0e19de5f88d39851033d Mon Sep 17 00:00:00 2001
From: Daniel Gimenes <daniel@danielgimenes.com.br>
Date: Mon, 3 Mar 2014 17:54:50 -0300
Subject: [PATCH 1/4] Add AuthenticationServiceInterface

---
 .../Authentication/AuthenticationService.php  |  2 +-
 .../AuthenticationServiceInterface.php        | 39 +++++++++++++++++++
 2 files changed, 40 insertions(+), 1 deletion(-)
 create mode 100644 library/Zend/Authentication/AuthenticationServiceInterface.php

diff --git a/library/Zend/Authentication/AuthenticationService.php b/library/Zend/Authentication/AuthenticationService.php
index 212747db80f..76a26d3ad37 100644
--- a/library/Zend/Authentication/AuthenticationService.php
+++ b/library/Zend/Authentication/AuthenticationService.php
@@ -9,7 +9,7 @@
 
 namespace Zend\Authentication;
 
-class AuthenticationService
+class AuthenticationService implements AuthenticationServiceInterface
 {
     /**
      * Persistent storage handler
diff --git a/library/Zend/Authentication/AuthenticationServiceInterface.php b/library/Zend/Authentication/AuthenticationServiceInterface.php
new file mode 100644
index 00000000000..d705cc62611
--- /dev/null
+++ b/library/Zend/Authentication/AuthenticationServiceInterface.php
@@ -0,0 +1,39 @@
+<?php
+/**
+ * Zend Framework (http://framework.zend.com/)
+ *
+ * @link      http://github.com/zendframework/zf2 for the canonical source repository
+ * @copyright Copyright (c) 2005-2014 Zend Technologies USA Inc. (http://www.zend.com)
+ * @license   http://framework.zend.com/license/new-bsd New BSD License
+ */
+
+namespace Zend\Authentication;
+
+interface AuthenticationServiceInterface
+{
+    /**
+     * @return Result
+     */
+    public function authenticate();
+
+    /**
+     * Returns true if and only if an identity is available
+     *
+     * @return bool
+     */
+    public function hasIdentity();
+
+    /**
+     * Returns the authenticated identity or null if no identity is available
+     *
+     * @return mixed|null
+     */
+    public function getIdentity();
+
+    /**
+     * Clears the identity
+     *
+     * @return void
+     */
+    public function clearIdentity();
+}

From 0ecc84c7e002854b9aeca59b5f6bb58db6e47ac3 Mon Sep 17 00:00:00 2001
From: Daniel Gimenes <daniel@danielgimenes.com.br>
Date: Wed, 5 Mar 2014 11:10:59 -0300
Subject: [PATCH 2/4] Add docblock description to authenticate()

---
 library/Zend/Authentication/AuthenticationServiceInterface.php | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/library/Zend/Authentication/AuthenticationServiceInterface.php b/library/Zend/Authentication/AuthenticationServiceInterface.php
index d705cc62611..f90967076bb 100644
--- a/library/Zend/Authentication/AuthenticationServiceInterface.php
+++ b/library/Zend/Authentication/AuthenticationServiceInterface.php
@@ -12,6 +12,8 @@
 interface AuthenticationServiceInterface
 {
     /**
+     * Authenticates and provides an authentication result
+     *
      * @return Result
      */
     public function authenticate();

From c7fe40e0daa4042af27dfb8e67d9acf0df21b69b Mon Sep 17 00:00:00 2001
From: Daniel Gimenes <daniel@danielgimenes.com.br>
Date: Wed, 5 Mar 2014 11:18:44 -0300
Subject: [PATCH 3/4] Add interface docblock

---
 library/Zend/Authentication/AuthenticationServiceInterface.php | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/library/Zend/Authentication/AuthenticationServiceInterface.php b/library/Zend/Authentication/AuthenticationServiceInterface.php
index f90967076bb..fcf74ea17e8 100644
--- a/library/Zend/Authentication/AuthenticationServiceInterface.php
+++ b/library/Zend/Authentication/AuthenticationServiceInterface.php
@@ -9,6 +9,9 @@
 
 namespace Zend\Authentication;
 
+/**
+ * Provides an API for authentication and identity management
+ */
 interface AuthenticationServiceInterface
 {
     /**

From e524c0529962eb0594e4e5ef9b066d276e130ac6 Mon Sep 17 00:00:00 2001
From: Matthew Weier O'Phinney <matthew@zend.com>
Date: Mon, 10 Mar 2014 11:31:10 -0500
Subject: [PATCH 4/4] [#5901] Added note to README

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 89e27185844..ede95065e9f 100644
--- a/README.md
+++ b/README.md
@@ -34,6 +34,10 @@ version of PHP available to ensure you have the latest security fixes.
 
 Additional updates that may affect existing applications include:
 
+- [#5901](https://github.com/zendframework/zf2/pull/5901) adds a new interface,
+  `Zend\Authentication\AuthenticationServiceInterface`. You can not type-hint
+  against this instead of `Zend\Authentication\AuthenticationService`.
+
 - [#5885](https://github.com/zendframework/zf2/pull/5885) adds the ability to
   specify the Locale via a route match parameter, and have it apply to the
   composed translator in the router, if any.