[feature/oauth] Define method to perform login actions for a provider

PHPB3-11673

phpBB/phpbb/auth/provider/oauth/service/base.php

@@ -22,6 +22,21 @@ if (!defined('IN_PHPBB'))
 */
 abstract class phpbb_auth_provider_oauth_service_base implements phpbb_auth_provider_oauth_service_interface
 {
+	/**
+	* External OAuth service provider
+	*
+	* @var \OAuth\Common\Service\ServiceInterface
+	*/
+	protected $service_provider;
+
+	/**
+	* {@inheritdoc}
+	*/
+	public function get_external_service_provider()
+	{
+		return $this->service_provider;
+	}
+
 	/**
 	* {@inheritdoc}
 	*/
@@ -29,4 +44,12 @@ abstract class phpbb_auth_provider_oauth_service_base implements phpbb_auth_prov
 	{
 		return array();
 	}
+
+	/**
+	* {@inheritdoc}
+	*/
+	public function set_external_service_provider(\OAuth\Common\Service\ServiceInterface $service_provider)
+	{
+		$this->service_provider = $service;
+	}
 }

phpBB/phpbb/auth/provider/oauth/service/interface.php

@@ -29,6 +29,13 @@ interface phpbb_auth_provider_oauth_service_interface
 	*/
 	public function get_auth_scope();
 
+	/**
+	* Returns the external library service provider once it has been set
+	*
+	* @param	\OAuth\Common\Service\ServiceInterface|null
+	*/
+	public function get_external_service_provider();
+
 	/**
 	* Returns an array containing the service credentials belonging to requested
 	* service.
@@ -41,4 +48,11 @@ interface phpbb_auth_provider_oauth_service_interface
 	*						)
 	*/
 	public function get_service_credentials();
+
+	/**
+	* Sets the external library service provider
+	*
+	* @param	\OAuth\Common\Service\ServiceInterface	$service
+	*/
+	public function set_external_service_provider(\OAuth\Common\Service\ServiceInterface $service_provider);
 }