2012-04-29 17:15:06 +00:00
|
|
|
<?php
|
|
|
|
/**
|
2016-07-11 09:58:15 +00:00
|
|
|
* PrivateBin
|
2012-04-29 17:15:06 +00:00
|
|
|
*
|
|
|
|
* a zero-knowledge paste bin
|
|
|
|
*
|
2016-07-11 09:58:15 +00:00
|
|
|
* @link https://github.com/PrivateBin/PrivateBin
|
2012-04-29 17:15:06 +00:00
|
|
|
* @copyright 2012 Sébastien SAUVAGE (sebsauvage.net)
|
2016-07-19 11:56:52 +00:00
|
|
|
* @license https://www.opensource.org/licenses/zlib-license.php The zlib/libpng License
|
2024-02-11 13:17:27 +00:00
|
|
|
* @version 1.7.0
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2016-12-12 17:43:23 +00:00
|
|
|
|
2016-12-12 17:49:08 +00:00
|
|
|
namespace PrivateBin\Data;
|
2016-07-21 15:09:48 +00:00
|
|
|
|
2012-04-29 17:15:06 +00:00
|
|
|
/**
|
2016-08-09 10:21:32 +00:00
|
|
|
* AbstractData
|
2012-04-29 17:15:06 +00:00
|
|
|
*
|
2022-10-27 23:01:02 +00:00
|
|
|
* Abstract model for data access
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2016-07-21 15:09:48 +00:00
|
|
|
abstract class AbstractData
|
2012-04-29 17:15:06 +00:00
|
|
|
{
|
2021-06-09 05:47:40 +00:00
|
|
|
/**
|
|
|
|
* cache for the traffic limiter
|
|
|
|
*
|
2012-04-29 17:15:06 +00:00
|
|
|
* @access protected
|
2022-10-27 23:01:02 +00:00
|
|
|
* @var array
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2022-10-27 23:01:02 +00:00
|
|
|
protected $_last_cache = array();
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @param array $paste
|
2015-09-03 20:55:36 +00:00
|
|
|
* @return bool
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function create($pasteid, array $paste);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Read a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
2019-05-19 07:42:55 +00:00
|
|
|
* @return array|false
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function read($pasteid);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Delete a paste and its discussion.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function delete($pasteid);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Test if a paste exists.
|
|
|
|
*
|
|
|
|
* @access public
|
2016-07-19 12:44:17 +00:00
|
|
|
* @param string $pasteid
|
2015-09-27 01:03:55 +00:00
|
|
|
* @return bool
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function exists($pasteid);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Create a comment in a paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @param string $parentid
|
|
|
|
* @param string $commentid
|
|
|
|
* @param array $comment
|
2015-09-03 20:55:36 +00:00
|
|
|
* @return bool
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function createComment($pasteid, $parentid, $commentid, array $comment);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Read all comments of paste.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $pasteid
|
|
|
|
* @return array
|
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function readComments($pasteid);
|
2012-04-29 17:15:06 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Test if a comment exists.
|
|
|
|
*
|
|
|
|
* @access public
|
2016-07-19 12:44:17 +00:00
|
|
|
* @param string $pasteid
|
2012-04-29 17:15:06 +00:00
|
|
|
* @param string $parentid
|
|
|
|
* @param string $commentid
|
2016-08-09 11:07:11 +00:00
|
|
|
* @return bool
|
2012-04-29 17:15:06 +00:00
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract public function existsComment($pasteid, $parentid, $commentid);
|
2015-10-12 19:07:41 +00:00
|
|
|
|
2021-06-08 05:49:22 +00:00
|
|
|
/**
|
|
|
|
* Purge outdated entries.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $namespace
|
|
|
|
* @param int $time
|
|
|
|
* @return void
|
|
|
|
*/
|
2021-06-09 05:47:40 +00:00
|
|
|
public function purgeValues($namespace, $time)
|
|
|
|
{
|
|
|
|
if ($namespace === 'traffic_limiter') {
|
2022-10-27 23:01:02 +00:00
|
|
|
foreach ($this->_last_cache as $key => $last_submission) {
|
2021-06-13 08:53:01 +00:00
|
|
|
if ($last_submission <= $time) {
|
2022-11-04 19:19:41 +00:00
|
|
|
unset($this->_last_cache[$key]);
|
2021-06-09 05:47:40 +00:00
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
2021-06-08 05:49:22 +00:00
|
|
|
|
2021-06-07 04:53:15 +00:00
|
|
|
/**
|
|
|
|
* Save a value.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $value
|
|
|
|
* @param string $namespace
|
|
|
|
* @param string $key
|
|
|
|
* @return bool
|
|
|
|
*/
|
|
|
|
abstract public function setValue($value, $namespace, $key = '');
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Load a value.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param string $namespace
|
|
|
|
* @param string $key
|
|
|
|
* @return string
|
|
|
|
*/
|
|
|
|
abstract public function getValue($namespace, $key = '');
|
|
|
|
|
2016-07-15 15:02:59 +00:00
|
|
|
/**
|
|
|
|
* Returns up to batch size number of paste ids that have expired
|
|
|
|
*
|
|
|
|
* @access protected
|
|
|
|
* @param int $batchsize
|
|
|
|
* @return array
|
|
|
|
*/
|
2019-05-10 19:35:36 +00:00
|
|
|
abstract protected function _getExpiredPastes($batchsize);
|
2016-07-15 15:02:59 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Perform a purge of old pastes, at most the given batchsize is deleted.
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @param int $batchsize
|
|
|
|
*/
|
2019-05-10 20:35:18 +00:00
|
|
|
public function purge($batchsize)
|
2016-07-15 15:02:59 +00:00
|
|
|
{
|
2016-07-26 06:19:35 +00:00
|
|
|
if ($batchsize < 1) {
|
|
|
|
return;
|
|
|
|
}
|
2016-07-15 15:02:59 +00:00
|
|
|
$pastes = $this->_getExpiredPastes($batchsize);
|
2016-07-26 06:19:35 +00:00
|
|
|
if (count($pastes)) {
|
|
|
|
foreach ($pastes as $pasteid) {
|
2016-07-15 15:02:59 +00:00
|
|
|
$this->delete($pasteid);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2022-10-27 23:01:02 +00:00
|
|
|
/**
|
|
|
|
* Returns all paste ids
|
|
|
|
*
|
|
|
|
* @access public
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
abstract public function getAllPastes();
|
|
|
|
|
2015-10-12 19:07:41 +00:00
|
|
|
/**
|
|
|
|
* Get next free slot for comment from postdate.
|
|
|
|
*
|
2019-05-08 20:11:21 +00:00
|
|
|
* @access protected
|
2015-10-12 19:07:41 +00:00
|
|
|
* @param array $comments
|
|
|
|
* @param int|string $postdate
|
2016-07-19 12:44:17 +00:00
|
|
|
* @return int|string
|
2015-10-12 19:07:41 +00:00
|
|
|
*/
|
2019-05-05 16:22:57 +00:00
|
|
|
protected function getOpenSlot(array &$comments, $postdate)
|
2015-10-12 19:07:41 +00:00
|
|
|
{
|
2016-07-26 06:19:35 +00:00
|
|
|
if (array_key_exists($postdate, $comments)) {
|
2015-10-12 19:07:41 +00:00
|
|
|
$parts = explode('.', $postdate, 2);
|
2016-07-26 06:19:35 +00:00
|
|
|
if (!array_key_exists(1, $parts)) {
|
|
|
|
$parts[1] = 0;
|
|
|
|
}
|
2015-10-12 19:07:41 +00:00
|
|
|
++$parts[1];
|
2015-10-16 21:13:36 +00:00
|
|
|
return $this->getOpenSlot($comments, implode('.', $parts));
|
2015-10-12 19:07:41 +00:00
|
|
|
}
|
|
|
|
return $postdate;
|
|
|
|
}
|
2019-05-08 20:11:21 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Upgrade pre-version 1 pastes with attachment to version 1 format.
|
|
|
|
*
|
|
|
|
* @access protected
|
|
|
|
* @static
|
|
|
|
* @param array $paste
|
|
|
|
* @return array
|
|
|
|
*/
|
|
|
|
protected static function upgradePreV1Format(array $paste)
|
|
|
|
{
|
|
|
|
if (array_key_exists('attachment', $paste['meta'])) {
|
|
|
|
$paste['attachment'] = $paste['meta']['attachment'];
|
|
|
|
unset($paste['meta']['attachment']);
|
|
|
|
if (array_key_exists('attachmentname', $paste['meta'])) {
|
|
|
|
$paste['attachmentname'] = $paste['meta']['attachmentname'];
|
|
|
|
unset($paste['meta']['attachmentname']);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $paste;
|
|
|
|
}
|
2012-04-29 17:15:06 +00:00
|
|
|
}
|