2012-04-29 13:15:06 -04:00
|
|
|
<?php
|
|
|
|
/**
|
2016-07-11 05:58:15 -04:00
|
|
|
* PrivateBin
|
2012-04-29 13:15:06 -04:00
|
|
|
*
|
|
|
|
* a zero-knowledge paste bin
|
|
|
|
*
|
2016-07-11 05:58:15 -04:00
|
|
|
* @link https://github.com/PrivateBin/PrivateBin
|
2012-04-29 13:15:06 -04:00
|
|
|
* @copyright 2012 Sébastien SAUVAGE (sebsauvage.net)
|
2016-07-19 07:56:52 -04:00
|
|
|
* @license https://www.opensource.org/licenses/zlib-license.php The zlib/libpng License
|
2015-11-09 15:39:42 -05:00
|
|
|
* @version 0.22
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
|
|
|
|
2016-07-21 11:09:48 -04:00
|
|
|
namespace PrivateBin\data;
|
|
|
|
|
2012-04-29 13:15:06 -04:00
|
|
|
/**
|
2016-07-11 05:58:15 -04:00
|
|
|
* privatebin_abstract
|
2012-04-29 13:15:06 -04:00
|
|
|
*
|
2016-07-11 05:58:15 -04:00
|
|
|
* Abstract model for PrivateBin data access, implemented as a singleton.
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2016-07-21 11:09:48 -04:00
|
|
|
abstract class AbstractData
|
2012-04-29 13:15:06 -04:00
|
|
|
{
|
2015-09-26 21:03:55 -04:00
|
|
|
/**
|
2012-04-29 13:15:06 -04:00
|
|
|
* singleton instance
|
|
|
|
*
|
2015-08-16 09:55:31 -04:00
|
|
|
* @access protected
|
2012-04-29 13:15:06 -04:00
|
|
|
* @static
|
2016-07-11 05:58:15 -04:00
|
|
|
* @var privatebin_abstract
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
protected static $_instance = null;
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* enforce singleton, disable constructor
|
|
|
|
*
|
2016-07-11 05:58:15 -04:00
|
|
|
* Instantiate using {@link getInstance()}, privatebin is a singleton object.
|
2012-04-29 13:15:06 -04:00
|
|
|
*
|
|
|
|
* @access protected
|
|
|
|
*/
|
|
|
|
protected function __construct() {}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* enforce singleton, disable cloning
|
|
|
|
*
|
2016-07-11 05:58:15 -04:00
|
|
|
* Instantiate using {@link getInstance()}, privatebin is a singleton object.
|
2012-04-29 13:15:06 -04:00
|
|
|
*
|
|
|
|
* @access private
|
|
|
|
*/
|
|
|
|
private function __clone() {}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* get instance of singleton
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @static
|
2015-08-16 09:55:31 -04:00
|
|
|
* @param array $options
|
2016-07-11 05:58:15 -04:00
|
|
|
* @return privatebin_abstract
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-08-25 18:49:11 -04:00
|
|
|
public static function getInstance($options) {}
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @param array $paste
|
2015-09-03 16:55:36 -04:00
|
|
|
* @return bool
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function create($pasteid, $paste);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Read a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
2016-07-06 08:12:14 -04:00
|
|
|
* @return stdClass|false
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function read($pasteid);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete a paste and its discussion.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @return void
|
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function delete($pasteid);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Test if a paste exists.
|
|
|
|
*
|
|
|
|
* @access public
|
2016-07-19 08:44:17 -04:00
|
|
|
* @param string $pasteid
|
2015-09-26 21:03:55 -04:00
|
|
|
* @return bool
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function exists($pasteid);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a comment in a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @param string $parentid
|
|
|
|
* @param string $commentid
|
|
|
|
* @param array $comment
|
2015-09-03 16:55:36 -04:00
|
|
|
* @return bool
|
2012-04-29 13:15:06 -04:00
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function createComment($pasteid, $parentid, $commentid, $comment);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Read all comments of paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @return array
|
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function readComments($pasteid);
|
2012-04-29 13:15:06 -04:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Test if a comment exists.
|
|
|
|
*
|
|
|
|
* @access public
|
2016-07-19 08:44:17 -04:00
|
|
|
* @param string $pasteid
|
2012-04-29 13:15:06 -04:00
|
|
|
* @param string $parentid
|
|
|
|
* @param string $commentid
|
|
|
|
* @return void
|
|
|
|
*/
|
2012-04-30 16:58:08 -04:00
|
|
|
abstract public function existsComment($pasteid, $parentid, $commentid);
|
2015-10-12 15:07:41 -04:00
|
|
|
|
2016-07-15 11:02:59 -04:00
|
|
|
/**
|
|
|
|
* 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
|
|
|
|
* @return void
|
|
|
|
*/
|
|
|
|
public function purge($batchsize)
|
|
|
|
{
|
|
|
|
if ($batchsize < 1) return;
|
|
|
|
$pastes = $this->_getExpiredPastes($batchsize);
|
|
|
|
if (count($pastes))
|
|
|
|
{
|
|
|
|
foreach ($pastes as $pasteid)
|
|
|
|
{
|
|
|
|
$this->delete($pasteid);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2015-10-12 15:07:41 -04:00
|
|
|
/**
|
|
|
|
* Get next free slot for comment from postdate.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param array $comments
|
|
|
|
* @param int|string $postdate
|
2016-07-19 08:44:17 -04:00
|
|
|
* @return int|string
|
2015-10-12 15:07:41 -04:00
|
|
|
*/
|
|
|
|
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];
|
2015-10-16 17:13:36 -04:00
|
|
|
return $this->getOpenSlot($comments, implode('.', $parts));
|
2015-10-12 15:07:41 -04:00
|
|
|
}
|
|
|
|
return $postdate;
|
|
|
|
}
|
2012-04-29 13:15:06 -04:00
|
|
|
}
|