PrivateBin/lib/Data/AbstractData.php

184 lines
4.0 KiB
PHP
Raw Normal View History

<?php
/**
2016-07-11 17:58:15 +08:00
* PrivateBin
*
* a zero-knowledge paste bin
*
2016-07-11 17:58:15 +08:00
* @link https://github.com/PrivateBin/PrivateBin
* @copyright 2012 Sébastien SAUVAGE (sebsauvage.net)
* @license https://www.opensource.org/licenses/zlib-license.php The zlib/libpng License
* @version 1.1.1
*/
2016-12-13 01:43:23 +08:00
2016-12-13 01:49:08 +08:00
namespace PrivateBin\Data;
2016-07-21 23:09:48 +08:00
2016-08-09 18:45:26 +08:00
use stdClass;
/**
2016-08-09 18:21:32 +08:00
* AbstractData
*
2016-07-11 17:58:15 +08:00
* Abstract model for PrivateBin data access, implemented as a singleton.
*/
2016-07-21 23:09:48 +08:00
abstract class AbstractData
{
/**
* singleton instance
*
* @access protected
* @static
2016-08-09 18:21:32 +08:00
* @var AbstractData
*/
protected static $_instance = null;
/**
* enforce singleton, disable constructor
*
2016-07-11 17:58:15 +08:00
* Instantiate using {@link getInstance()}, privatebin is a singleton object.
*
* @access protected
*/
protected function __construct()
{
}
/**
* enforce singleton, disable cloning
*
2016-07-11 17:58:15 +08:00
* Instantiate using {@link getInstance()}, privatebin is a singleton object.
*
* @access private
*/
private function __clone()
{
}
/**
* get instance of singleton
*
* @access public
* @static
* @param array $options
* @return AbstractData
*/
public static function getInstance($options)
{
}
/**
* Create a paste.
*
* @access public
* @param string $pasteid
* @param array $paste
* @return bool
*/
abstract public function create($pasteid, $paste);
/**
* Read a paste.
*
* @access public
* @param string $pasteid
* @return stdClass|false
*/
abstract public function read($pasteid);
/**
* Delete a paste and its discussion.
*
* @access public
* @param string $pasteid
*/
abstract public function delete($pasteid);
/**
* Test if a paste exists.
*
* @access public
2016-07-19 20:44:17 +08:00
* @param string $pasteid
* @return bool
*/
abstract public function exists($pasteid);
/**
* Create a comment in a paste.
*
* @access public
* @param string $pasteid
* @param string $parentid
* @param string $commentid
* @param array $comment
* @return bool
*/
abstract public function createComment($pasteid, $parentid, $commentid, $comment);
/**
* Read all comments of paste.
*
* @access public
* @param string $pasteid
* @return array
*/
abstract public function readComments($pasteid);
/**
* Test if a comment exists.
*
* @access public
2016-07-19 20:44:17 +08:00
* @param string $pasteid
* @param string $parentid
* @param string $commentid
2016-08-09 19:07:11 +08:00
* @return bool
*/
abstract public function existsComment($pasteid, $parentid, $commentid);
/**
* Returns up to batch size number of paste ids that have expired
*
* @access protected
* @param int $batchsize
* @return array
*/
abstract protected function _getExpiredPastes($batchsize);
/**
* Perform a purge of old pastes, at most the given batchsize is deleted.
*
* @access public
* @param int $batchsize
*/
public function purge($batchsize)
{
if ($batchsize < 1) {
return;
}
$pastes = $this->_getExpiredPastes($batchsize);
if (count($pastes)) {
foreach ($pastes as $pasteid) {
$this->delete($pasteid);
}
}
}
/**
* Get next free slot for comment from postdate.
*
* @access public
* @param array $comments
* @param int|string $postdate
2016-07-19 20:44:17 +08:00
* @return int|string
*/
protected function getOpenSlot(&$comments, $postdate)
{
if (array_key_exists($postdate, $comments)) {
$parts = explode('.', $postdate, 2);
if (!array_key_exists(1, $parts)) {
$parts[1] = 0;
}
++$parts[1];
return $this->getOpenSlot($comments, implode('.', $parts));
}
return $postdate;
}
}