nestict/mitrobill
1
0
Fork 0
forked from kevinowino869/mitrobill
Code Pull Requests Activity

update PEAR

Browse Source
This commit is contained in:
Ibnu Maksum
2023-10-05 16:55:44 +07:00
parent 1861358415
commit 071df91de0
64 changed files with 3872 additions and 2100 deletions
Download Patch File Download Diff File Expand all files Collapse all files

118
system/autoload/PEAR2/Net/RouterOS/Registry.php
View File

@ -2,17 +2,18 @@
/**
* RouterOS API client implementation.
*
*
* RouterOS is the flag product of the company MikroTik and is a powerful router software. One of its many abilities is to allow control over it via an API. This package provides a client for that API, in turn allowing you to use PHP to control RouterOS hosts.
*
*
* PHP version 5
*
*
* @category Net
* @package PEAR2_Net_RouterOS
* @author Vasil Rangelov <boen.robot@gmail.com>
* @copyright 2011 Vasil Rangelov
* @license http://www.gnu.org/copyleft/lesser.html LGPL License 2.1
* @version 1.0.0b5
* @version 1.0.0b6
* @link http://pear2.php.net/PEAR2_Net_RouterOS
*/
/**
@ -27,12 +28,12 @@ use PEAR2\Cache\SHM;
/**
* A RouterOS registry.
*
*
* Provides functionality for managing the request/response flow. Particularly
* useful in persistent connections.
*
*
* Note that this class is not meant to be called directly.
*
*
* @category Net
* @package PEAR2_Net_RouterOS
* @author Vasil Rangelov <boen.robot@gmail.com>
@ -42,28 +43,36 @@ use PEAR2\Cache\SHM;
class Registry
{
/**
* @var SHM The storage.
* The storage.
*
* @var SHM
*/
protected $shm;
/**
* @var int ID of request. Populated at first instance in request.
* ID of request. Populated at first instance in request.
*
* @var int
*/
protected static $requestId = -1;
/**
* @var int ID to be given to next instance, after incrementing it.
* ID to be given to next instance, after incrementing it.
*
* @var int
*/
protected static $instanceIdSeed = -1;
/**
* @var int ID of instance within the request.
* ID of instance within the request.
*
* @var int
*/
protected $instanceId;
/**
* Creates a registry.
*
*
* @param string $uri An URI to bind the registry to.
*/
public function __construct($uri)
@ -76,16 +85,17 @@ class Registry
$this->instanceId = ++self::$instanceIdSeed;
$this->shm->add('responseBuffer_' . $this->getOwnershipTag(), array());
}
/**
* Parses a tag.
*
*
* Parses a tag to reveal the ownership part of it, and the original tag.
*
*
* @param string $tag The tag (as received) to parse.
*
* @return array An array with the first member being the ownership tag, and
* the second one being the original tag.
*
* @return array<int,string|null> An array with
* the first member being the ownership tag, and
* the second one being the original tag.
*/
public static function parseTag($tag)
{
@ -99,10 +109,10 @@ class Registry
}
return $result;
}
/**
* Checks if this instance is the tagless mode owner.
*
*
* @return bool TRUE if this instance is the tagless mode owner, FALSE
* otherwise.
*/
@ -114,21 +124,21 @@ class Registry
$this->shm->unlock('taglessModeOwner');
return $result;
}
/**
* Sets the "tagless mode" setting.
*
* While in tagless mode, this instance will claim owhership of any
*
* While in tagless mode, this instance will claim ownership of any
* responses without a tag. While not in this mode, any requests without a
* tag will be given to all instances.
*
*
* Regardless of mode, if the type of the response is
* {@link Response::TYPE_FATAL}, it will be given to all instances.
*
*
* @param bool $taglessMode TRUE to claim tagless ownership, FALSE to
* release such ownership, if taken.
*
* @return bool TRUE on success, FALSE on failure.
*
* @return bool TRUE on success, FALSE on failure.
*/
public function setTaglessMode($taglessMode)
{
@ -143,26 +153,26 @@ class Registry
&& $this->shm->unlock('taglessModeOwner')
&& $this->shm->unlock('taglessMode'));
}
/**
* Get the ownership tag for this instance.
*
* @return string The ownership tag for this registry instance.
*
* @return string The ownership tag for this registry instance.
*/
public function getOwnershipTag()
{
return self::$requestId . '_' . $this->instanceId . '__';
}
/**
* Add a response to the registry.
*
*
* @param Response $response The response to add. The caller of this
* function is responsible for ensuring that the ownership tag and the
* original tag are separated, so that only the original one remains in
* the response.
* @param string $ownershipTag The ownership tag that the response had.
*
*
* @return bool TRUE if the request was added to its buffer, FALSE if
* this instance owns the response, and therefore doesn't need to add
* the response to its buffer.
@ -175,7 +185,7 @@ class Registry
) {
return false;
}
if (null === $ownershipTag) {
$this->shm->lock('taglessModeOwner');
if ($this->shm->exists('taglessModeOwner')
@ -194,18 +204,18 @@ class Registry
return true;
}
}
$this->_add($response, 'responseBuffer_' . $ownershipTag);
return true;
}
/**
* Adds a response to a buffer.
*
*
* @param Response $response The response to add.
* @param string $targetBufferName The name of the buffer to add the
* response to.
*
*
* @return void
*/
private function _add(Response $response, $targetBufferName)
@ -217,11 +227,11 @@ class Registry
$this->shm->unlock($targetBufferName);
}
}
/**
* Gets the next response from this instance's buffer.
*
* @return Response|null The next response, or NULL if there isn't one.
*
* @return Response|null The next response, or NULL if there isn't one.
*/
public function getNextResponse()
{
@ -239,13 +249,13 @@ class Registry
}
return $response;
}
/**
* Closes the registry.
*
*
* Closes the registry, meaning that all buffers are cleared.
*
* @return void
*
* @return void
*/
public function close()
{
@ -253,12 +263,12 @@ class Registry
self::$instanceIdSeed = -1;
$this->shm->clear();
}
/**
* Removes a buffer.
*
*
* @param string $targetBufferName The buffer to remove.
*
*
* @return void
*/
private function _close($targetBufferName)
@ -268,9 +278,9 @@ class Registry
$this->shm->unlock($targetBufferName);
}
}
/**
* Removes this instance's buffer.
* Removes this instance's buffer.
*/
public function __destruct()
{