2013-09-17 20:31:14 +04:00
|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* Copyright (c) 2013 Thomas Tanghus (thomas@tanghus.net)
|
|
|
|
* @author Thomas Tanghus
|
|
|
|
* @author Robin Appelman
|
|
|
|
* This file is licensed under the Affero General Public License version 3 or
|
|
|
|
* later.
|
|
|
|
* See the COPYING-README file.
|
|
|
|
*/
|
|
|
|
|
2013-11-03 16:38:25 +04:00
|
|
|
/**
|
|
|
|
* Public interface of ownCloud for apps to use.
|
|
|
|
* Session interface
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
|
|
|
// use OCP namespace for all classes that are considered public.
|
|
|
|
// This means that they should be used by apps instead of the internal ownCloud classes
|
2013-09-17 20:31:14 +04:00
|
|
|
namespace OCP;
|
|
|
|
|
2013-09-18 14:01:01 +04:00
|
|
|
/**
|
|
|
|
* Interface ISession
|
|
|
|
*
|
|
|
|
* wrap PHP's internal session handling into the ISession interface
|
|
|
|
*/
|
2013-09-17 20:31:14 +04:00
|
|
|
interface ISession {
|
2013-09-18 14:01:01 +04:00
|
|
|
|
2013-09-17 20:31:14 +04:00
|
|
|
/**
|
2013-09-18 14:01:01 +04:00
|
|
|
* Set a value in the session
|
|
|
|
*
|
2013-09-17 20:31:14 +04:00
|
|
|
* @param string $key
|
|
|
|
* @param mixed $value
|
|
|
|
*/
|
|
|
|
public function set($key, $value);
|
|
|
|
|
|
|
|
/**
|
2013-09-18 14:01:01 +04:00
|
|
|
* Get a value from the session
|
|
|
|
*
|
2013-09-17 20:31:14 +04:00
|
|
|
* @param string $key
|
|
|
|
* @return mixed should return null if $key does not exist
|
|
|
|
*/
|
|
|
|
public function get($key);
|
|
|
|
|
|
|
|
/**
|
2013-09-18 14:01:01 +04:00
|
|
|
* Check if a named key exists in the session
|
|
|
|
*
|
2013-09-17 20:31:14 +04:00
|
|
|
* @param string $key
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
public function exists($key);
|
|
|
|
|
|
|
|
/**
|
2013-09-18 14:01:01 +04:00
|
|
|
* Remove a $key/$value pair from the session
|
2013-09-17 20:31:14 +04:00
|
|
|
*
|
|
|
|
* @param string $key
|
|
|
|
*/
|
|
|
|
public function remove($key);
|
|
|
|
|
|
|
|
/**
|
2013-09-18 14:01:01 +04:00
|
|
|
* Reset and recreate the session
|
2013-09-17 20:31:14 +04:00
|
|
|
*/
|
|
|
|
public function clear();
|
|
|
|
|
|
|
|
}
|