123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985 |
- <?php
- class PredisException extends Exception { }
- // Client-side errors
- class Predis_ClientException extends PredisException { }
- // Aborted multi/exec
- class Predis_AbortedMultiExec extends PredisException { }
- // Server-side errors
- class Predis_ServerException extends PredisException {
- public function toResponseError() {
- return new Predis_ResponseError($this->getMessage());
- }
- }
- // Communication errors
- class Predis_CommunicationException extends PredisException {
- private $_connection;
- public function __construct(Predis_Connection $connection, $message = null, $code = null) {
- $this->_connection = $connection;
- parent::__construct($message, $code);
- }
- public function getConnection() { return $this->_connection; }
- public function shouldResetConnection() { return true; }
- }
- // Unexpected responses
- class Predis_MalformedServerResponse extends Predis_CommunicationException { }
- /* ------------------------------------------------------------------------- */
- class Predis_Client {
- private $_options, $_connection, $_serverProfile, $_responseReader;
- public function __construct($parameters = null, $clientOptions = null) {
- $this->setupClient($clientOptions !== null ? $clientOptions : new Predis_ClientOptions());
- $this->setupConnection($parameters);
- }
- public static function create(/* arguments */) {
- $argv = func_get_args();
- $argc = func_num_args();
- $options = null;
- $lastArg = $argv[$argc-1];
- if ($argc > 0 && !is_string($lastArg) && ($lastArg instanceof Predis_ClientOptions ||
- is_subclass_of($lastArg, 'Predis_RedisServerProfile'))) {
- $options = array_pop($argv);
- $argc--;
- }
- if ($argc === 0) {
- throw new Predis_ClientException('Missing connection parameters');
- }
- return new Predis_Client($argc === 1 ? $argv[0] : $argv, $options);
- }
- private static function filterClientOptions($options) {
- if ($options instanceof Predis_ClientOptions) {
- return $options;
- }
- if (is_array($options)) {
- return new Predis_ClientOptions($options);
- }
- if ($options instanceof Predis_RedisServerProfile) {
- return new Predis_ClientOptions(array(
- 'profile' => $options
- ));
- }
- if (is_string($options)) {
- return new Predis_ClientOptions(array(
- 'profile' => Predis_RedisServerProfile::get($options)
- ));
- }
- throw new InvalidArgumentException("Invalid type for client options");
- }
- private function setupClient($options) {
- $this->_responseReader = new Predis_ResponseReader();
- $this->_options = self::filterClientOptions($options);
- $this->setProfile($this->_options->profile);
- if ($this->_options->iterable_multibulk === true) {
- $this->_responseReader->setHandler(
- Predis_Protocol::PREFIX_MULTI_BULK,
- new Predis_ResponseMultiBulkStreamHandler()
- );
- }
- if ($this->_options->throw_on_error === false) {
- $this->_responseReader->setHandler(
- Predis_Protocol::PREFIX_ERROR,
- new Predis_ResponseErrorSilentHandler()
- );
- }
- }
- private function setupConnection($parameters) {
- if ($parameters !== null && !(is_array($parameters) || is_string($parameters))) {
- throw new Predis_ClientException('Invalid parameters type (array or string expected)');
- }
- if (is_array($parameters) && isset($parameters[0])) {
- $cluster = new Predis_ConnectionCluster($this->_options->key_distribution);
- foreach ($parameters as $shardParams) {
- $cluster->add($this->createConnection($shardParams));
- }
- $this->setConnection($cluster);
- }
- else {
- $this->setConnection($this->createConnection($parameters));
- }
- }
- private function createConnection($parameters) {
- $params = $parameters instanceof Predis_ConnectionParameters
- ? $parameters
- : new Predis_ConnectionParameters($parameters);
- $connection = new Predis_Connection($params, $this->_responseReader);
- if ($params->password !== null) {
- $connection->pushInitCommand($this->createCommand(
- 'auth', array($params->password)
- ));
- }
- if ($params->database !== null) {
- $connection->pushInitCommand($this->createCommand(
- 'select', array($params->database)
- ));
- }
- return $connection;
- }
- private function setConnection(Predis_IConnection $connection) {
- $this->_connection = $connection;
- }
- public function setProfile($serverProfile) {
- if (!($serverProfile instanceof Predis_RedisServerProfile || is_string($serverProfile))) {
- throw new InvalidArgumentException(
- "Invalid type for server profile, Predis_RedisServerProfile or string expected"
- );
- }
- $this->_serverProfile = (is_string($serverProfile)
- ? Predis_RedisServerProfile::get($serverProfile)
- : $serverProfile
- );
- }
- public function getProfile() {
- return $this->_serverProfile;
- }
- public function getResponseReader() {
- return $this->_responseReader;
- }
- public function getClientFor($connectionAlias) {
- if (!Predis_Shared_Utils::isCluster($this->_connection)) {
- throw new Predis_ClientException(
- 'This method is supported only when the client is connected to a cluster of connections'
- );
- }
- $connection = $this->_connection->getConnectionById($connectionAlias);
- if ($connection === null) {
- throw new InvalidArgumentException(
- "Invalid connection alias: '$connectionAlias'"
- );
- }
- $newClient = new Predis_Client();
- $newClient->setupClient($this->_options);
- $newClient->setConnection($connection);
- return $newClient;
- }
- public function connect() {
- $this->_connection->connect();
- }
- public function disconnect() {
- $this->_connection->disconnect();
- }
- public function isConnected() {
- return $this->_connection->isConnected();
- }
- public function getConnection($id = null) {
- if (!isset($id)) {
- return $this->_connection;
- }
- else {
- return Predis_Shared_Utils::isCluster($this->_connection)
- ? $this->_connection->getConnectionById($id)
- : $this->_connection;
- }
- }
- public function __call($method, $arguments) {
- $command = $this->_serverProfile->createCommand($method, $arguments);
- return $this->_connection->executeCommand($command);
- }
- public function createCommand($method, $arguments = array()) {
- return $this->_serverProfile->createCommand($method, $arguments);
- }
- public function executeCommand(Predis_Command $command) {
- return $this->_connection->executeCommand($command);
- }
- public function executeCommandOnShards(Predis_Command $command) {
- $replies = array();
- if (Predis_Shared_Utils::isCluster($this->_connection)) {
- foreach($this->_connection as $connection) {
- $replies[] = $connection->executeCommand($command);
- }
- }
- else {
- $replies[] = $this->_connection->executeCommand($command);
- }
- return $replies;
- }
- public function rawCommand($rawCommandData, $closesConnection = false) {
- if (Predis_Shared_Utils::isCluster($this->_connection)) {
- throw new Predis_ClientException('Cannot send raw commands when connected to a cluster of Redis servers');
- }
- return $this->_connection->rawCommand($rawCommandData, $closesConnection);
- }
- private function sharedInitializer($argv, $initializer) {
- $argc = count($argv);
- if ($argc === 0) {
- return $this->$initializer();
- }
- else if ($argc === 1) {
- list($arg0) = $argv;
- return is_array($arg0) ? $this->$initializer($arg0) : $this->$initializer(null, $arg0);
- }
- else if ($argc === 2) {
- list($arg0, $arg1) = $argv;
- return $this->$initializer($arg0, $arg1);
- }
- return $this->$initializer($this, $arguments);
- }
- public function pipeline(/* arguments */) {
- $args = func_get_args();
- return $this->sharedInitializer($args, 'initPipeline');
- }
- public function pipelineSafe($pipelineBlock = null) {
- return $this->initPipeline(array('safe' => true), $pipelineBlock);
- }
- private function initPipeline(Array $options = null, $pipelineBlock = null) {
- $pipeline = null;
- if (isset($options)) {
- if (isset($options['safe']) && $options['safe'] == true) {
- $connection = $this->getConnection();
- $pipeline = new Predis_CommandPipeline($this, $connection instanceof Predis_Connection
- ? new Predis_Pipeline_SafeExecutor($connection)
- : new Predis_Pipeline_SafeClusterExecutor($connection)
- );
- }
- else {
- $pipeline = new Predis_CommandPipeline($this);
- }
- }
- else {
- $pipeline = new Predis_CommandPipeline($this);
- }
- return $this->pipelineExecute($pipeline, $pipelineBlock);
- }
- private function pipelineExecute(Predis_CommandPipeline $pipeline, $block) {
- return $block !== null ? $pipeline->execute($block) : $pipeline;
- }
- public function multiExec(/* arguments */) {
- $args = func_get_args();
- return $this->sharedInitializer($args, 'initMultiExec');
- }
- private function initMultiExec(Array $options = null, $transBlock = null) {
- $multi = isset($options) ? new Predis_MultiExecBlock($this, $options) : new Predis_MultiExecBlock($this);
- return $transBlock !== null ? $multi->execute($transBlock) : $multi;
- }
- public function pubSubContext() {
- return new Predis_PubSubContext($this);
- }
- }
- /* ------------------------------------------------------------------------- */
- interface Predis_IClientOptionsHandler {
- public function validate($option, $value);
- public function getDefault();
- }
- class Predis_ClientOptionsProfile implements Predis_IClientOptionsHandler {
- public function validate($option, $value) {
- if ($value instanceof Predis_RedisServerProfile) {
- return $value;
- }
- if (is_string($value)) {
- return Predis_RedisServerProfile::get($value);
- }
- throw new InvalidArgumentException("Invalid value for option $option");
- }
- public function getDefault() {
- return Predis_RedisServerProfile::getDefault();
- }
- }
- class Predis_ClientOptionsKeyDistribution implements Predis_IClientOptionsHandler {
- public function validate($option, $value) {
- if ($value instanceof Predis_Distribution_IDistributionStrategy) {
- return $value;
- }
- if (is_string($value)) {
- $valueReflection = new ReflectionClass($value);
- if ($valueReflection->isSubclassOf('Predis_Distribution_IDistributionStrategy')) {
- return new $value;
- }
- }
- throw new InvalidArgumentException("Invalid value for option $option");
- }
- public function getDefault() {
- return new Predis_Distribution_HashRing();
- }
- }
- class Predis_ClientOptionsIterableMultiBulk implements Predis_IClientOptionsHandler {
- public function validate($option, $value) {
- return (bool) $value;
- }
- public function getDefault() {
- return false;
- }
- }
- class Predis_ClientOptionsThrowOnError implements Predis_IClientOptionsHandler {
- public function validate($option, $value) {
- return (bool) $value;
- }
- public function getDefault() {
- return true;
- }
- }
- class Predis_ClientOptions {
- private static $_optionsHandlers;
- private $_options;
- public function __construct($options = null) {
- self::initializeOptionsHandlers();
- $this->initializeOptions($options !== null ? $options : array());
- }
- private static function initializeOptionsHandlers() {
- if (!isset(self::$_optionsHandlers)) {
- self::$_optionsHandlers = self::getOptionsHandlers();
- }
- }
- private static function getOptionsHandlers() {
- return array(
- 'profile' => new Predis_ClientOptionsProfile(),
- 'key_distribution' => new Predis_ClientOptionsKeyDistribution(),
- 'iterable_multibulk' => new Predis_ClientOptionsIterableMultiBulk(),
- 'throw_on_error' => new Predis_ClientOptionsThrowOnError(),
- );
- }
- private function initializeOptions($options) {
- foreach ($options as $option => $value) {
- if (isset(self::$_optionsHandlers[$option])) {
- $handler = self::$_optionsHandlers[$option];
- $this->_options[$option] = $handler->validate($option, $value);
- }
- }
- }
- public function __get($option) {
- if (!isset($this->_options[$option])) {
- $defaultValue = self::$_optionsHandlers[$option]->getDefault();
- $this->_options[$option] = $defaultValue;
- }
- return $this->_options[$option];
- }
- public function __isset($option) {
- return isset(self::$_optionsHandlers[$option]);
- }
- }
- /* ------------------------------------------------------------------------- */
- class Predis_Protocol {
- const NEWLINE = "\r\n";
- const OK = 'OK';
- const ERROR = 'ERR';
- const QUEUED = 'QUEUED';
- const NULL = 'nil';
- const PREFIX_STATUS = '+';
- const PREFIX_ERROR = '-';
- const PREFIX_INTEGER = ':';
- const PREFIX_BULK = '$';
- const PREFIX_MULTI_BULK = '*';
- }
- abstract class Predis_Command {
- private $_arguments, $_hash;
- public abstract function getCommandId();
- public abstract function serializeRequest($command, $arguments);
- public function canBeHashed() {
- return true;
- }
- public function getHash(Predis_Distribution_IDistributionStrategy $distributor) {
- if (isset($this->_hash)) {
- return $this->_hash;
- }
- else {
- if (isset($this->_arguments[0])) {
- // TODO: should we throw an exception if the command does
- // not support sharding?
- $key = $this->_arguments[0];
- $start = strpos($key, '{');
- $end = strpos($key, '}');
- if ($start !== false && $end !== false) {
- $key = substr($key, ++$start, $end - $start);
- }
- $this->_hash = $distributor->generateKey($key);
- return $this->_hash;
- }
- }
- return null;
- }
- public function closesConnection() {
- return false;
- }
- protected function filterArguments(Array $arguments) {
- return $arguments;
- }
- public function setArguments(/* arguments */) {
- $this->_arguments = $this->filterArguments(func_get_args());
- unset($this->_hash);
- }
- public function setArgumentsArray(Array $arguments) {
- $this->_arguments = $this->filterArguments($arguments);
- unset($this->_hash);
- }
- public function getArguments() {
- return isset($this->_arguments) ? $this->_arguments : array();
- }
- public function getArgument($index = 0) {
- return isset($this->_arguments[$index]) ? $this->_arguments[$index] : null;
- }
- public function parseResponse($data) {
- return $data;
- }
- public final function invoke() {
- return $this->serializeRequest($this->getCommandId(), $this->getArguments());
- }
- }
- abstract class Predis_InlineCommand extends Predis_Command {
- public function serializeRequest($command, $arguments) {
- if (isset($arguments[0]) && is_array($arguments[0])) {
- $arguments[0] = implode($arguments[0], ' ');
- }
- return $command . (count($arguments) > 0
- ? ' ' . implode($arguments, ' ') . Predis_Protocol::NEWLINE
- : Predis_Protocol::NEWLINE
- );
- }
- }
- abstract class Predis_BulkCommand extends Predis_Command {
- public function serializeRequest($command, $arguments) {
- $data = array_pop($arguments);
- if (is_array($data)) {
- $data = implode($data, ' ');
- }
- return $command . ' ' . implode($arguments, ' ') . ' ' . strlen($data) .
- Predis_Protocol::NEWLINE . $data . Predis_Protocol::NEWLINE;
- }
- }
- abstract class Predis_MultiBulkCommand extends Predis_Command {
- public function serializeRequest($command, $arguments) {
- $cmd_args = null;
- $argsc = count($arguments);
- if ($argsc === 1 && is_array($arguments[0])) {
- $cmd_args = $arguments[0];
- $argsc = count($cmd_args);
- }
- else {
- $cmd_args = $arguments;
- }
- $newline = Predis_Protocol::NEWLINE;
- $cmdlen = strlen($command);
- $reqlen = $argsc + 1;
- $buffer = "*{$reqlen}{$newline}\${$cmdlen}{$newline}{$command}{$newline}";
- foreach ($cmd_args as $argument) {
- $arglen = strlen($argument);
- $buffer .= "\${$arglen}{$newline}{$argument}{$newline}";
- }
- return $buffer;
- }
- }
- /* ------------------------------------------------------------------------- */
- interface Predis_IResponseHandler {
- function handle(Predis_Connection $connection, $payload);
- }
- class Predis_ResponseStatusHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $status) {
- if ($status === Predis_Protocol::OK) {
- return true;
- }
- else if ($status === Predis_Protocol::QUEUED) {
- return new Predis_ResponseQueued();
- }
- return $status;
- }
- }
- class Predis_ResponseErrorHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $errorMessage) {
- throw new Predis_ServerException(substr($errorMessage, 4));
- }
- }
- class Predis_ResponseErrorSilentHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $errorMessage) {
- return new Predis_ResponseError(substr($errorMessage, 4));
- }
- }
- class Predis_ResponseBulkHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $dataLength) {
- if (!is_numeric($dataLength)) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, "Cannot parse '$dataLength' as data length"
- ));
- }
- if ($dataLength > 0) {
- $value = $connection->readBytes($dataLength);
- self::discardNewLine($connection);
- return $value;
- }
- else if ($dataLength == 0) {
- self::discardNewLine($connection);
- return '';
- }
- return null;
- }
- private static function discardNewLine(Predis_Connection $connection) {
- if ($connection->readBytes(2) !== Predis_Protocol::NEWLINE) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, 'Did not receive a new-line at the end of a bulk response'
- ));
- }
- }
- }
- class Predis_ResponseMultiBulkHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $rawLength) {
- if (!is_numeric($rawLength)) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, "Cannot parse '$rawLength' as data length"
- ));
- }
- $listLength = (int) $rawLength;
- if ($listLength === -1) {
- return null;
- }
- $list = array();
- if ($listLength > 0) {
- $reader = $connection->getResponseReader();
- for ($i = 0; $i < $listLength; $i++) {
- $list[] = $reader->read($connection);
- }
- }
- return $list;
- }
- }
- class Predis_ResponseMultiBulkStreamHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $rawLength) {
- if (!is_numeric($rawLength)) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, "Cannot parse '$rawLength' as data length"
- ));
- }
- return new Predis_Shared_MultiBulkResponseIterator($connection, (int)$rawLength);
- }
- }
- class Predis_ResponseIntegerHandler implements Predis_IResponseHandler {
- public function handle(Predis_Connection $connection, $number) {
- if (is_numeric($number)) {
- return (int) $number;
- }
- else {
- if ($number !== Predis_Protocol::NULL) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, "Cannot parse '$number' as numeric response"
- ));
- }
- return null;
- }
- }
- }
- class Predis_ResponseReader {
- private $_prefixHandlers;
- public function __construct() {
- $this->initializePrefixHandlers();
- }
- private function initializePrefixHandlers() {
- $this->_prefixHandlers = array(
- Predis_Protocol::PREFIX_STATUS => new Predis_ResponseStatusHandler(),
- Predis_Protocol::PREFIX_ERROR => new Predis_ResponseErrorHandler(),
- Predis_Protocol::PREFIX_INTEGER => new Predis_ResponseIntegerHandler(),
- Predis_Protocol::PREFIX_BULK => new Predis_ResponseBulkHandler(),
- Predis_Protocol::PREFIX_MULTI_BULK => new Predis_ResponseMultiBulkHandler(),
- );
- }
- public function setHandler($prefix, Predis_IResponseHandler $handler) {
- $this->_prefixHandlers[$prefix] = $handler;
- }
- public function getHandler($prefix) {
- if (isset($this->_prefixHandlers[$prefix])) {
- return $this->_prefixHandlers[$prefix];
- }
- }
- public function read(Predis_Connection $connection) {
- $header = $connection->readLine();
- if ($header === '') {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, 'Unexpected empty header'
- ));
- }
- $prefix = $header[0];
- $payload = strlen($header) > 1 ? substr($header, 1) : '';
- if (!isset($this->_prefixHandlers[$prefix])) {
- Predis_Shared_Utils::onCommunicationException(new Predis_MalformedServerResponse(
- $connection, "Unknown prefix '$prefix'"
- ));
- }
- $handler = $this->_prefixHandlers[$prefix];
- return $handler->handle($connection, $payload);
- }
- }
- class Predis_ResponseError {
- private $_message;
- public function __construct($message) {
- $this->_message = $message;
- }
- public function __get($property) {
- if ($property == 'error') {
- return true;
- }
- if ($property == 'message') {
- return $this->_message;
- }
- }
- public function __isset($property) {
- return $property === 'error';
- }
- public function __toString() {
- return $this->_message;
- }
- }
- class Predis_ResponseQueued {
- public $queued = true;
- public function __toString() {
- return Predis_Protocol::QUEUED;
- }
- }
- /* ------------------------------------------------------------------------- */
- class Predis_CommandPipeline {
- private $_redisClient, $_pipelineBuffer, $_returnValues, $_running, $_executor;
- public function __construct(Predis_Client $redisClient, Predis_Pipeline_IPipelineExecutor $executor = null) {
- $this->_redisClient = $redisClient;
- $this->_executor = $executor !== null ? $executor : new Predis_Pipeline_StandardExecutor();
- $this->_pipelineBuffer = array();
- $this->_returnValues = array();
- }
- public function __call($method, $arguments) {
- $command = $this->_redisClient->createCommand($method, $arguments);
- $this->recordCommand($command);
- return $this;
- }
- private function recordCommand(Predis_Command $command) {
- $this->_pipelineBuffer[] = $command;
- }
- private function getRecordedCommands() {
- return $this->_pipelineBuffer;
- }
- public function flushPipeline() {
- if (count($this->_pipelineBuffer) > 0) {
- $connection = $this->_redisClient->getConnection();
- $this->_returnValues = array_merge(
- $this->_returnValues,
- $this->_executor->execute($connection, $this->_pipelineBuffer)
- );
- $this->_pipelineBuffer = array();
- }
- return $this;
- }
- private function setRunning($bool) {
- if ($bool == true && $this->_running == true) {
- throw new Predis_ClientException("This pipeline is already opened");
- }
- $this->_running = $bool;
- }
- public function execute($block = null) {
- if ($block && !is_callable($block)) {
- throw new InvalidArgumentException('Argument passed must be a callable object');
- }
- // TODO: do not reuse previously executed pipelines
- $this->setRunning(true);
- $pipelineBlockException = null;
- try {
- if ($block !== null) {
- $block($this);
- }
- $this->flushPipeline();
- }
- catch (Exception $exception) {
- $pipelineBlockException = $exception;
- }
- $this->setRunning(false);
- if ($pipelineBlockException !== null) {
- throw $pipelineBlockException;
- }
- return $this->_returnValues;
- }
- }
- class Predis_MultiExecBlock {
- private $_initialized, $_discarded, $_insideBlock;
- private $_redisClient, $_options, $_commands;
- private $_supportsWatch;
- public function __construct(Predis_Client $redisClient, Array $options = null) {
- $this->checkCapabilities($redisClient);
- $this->_initialized = false;
- $this->_discarded = false;
- $this->_insideBlock = false;
- $this->_redisClient = $redisClient;
- $this->_options = isset($options) ? $options : array();
- $this->_commands = array();
- }
- private function checkCapabilities(Predis_Client $redisClient) {
- if (Predis_Shared_Utils::isCluster($redisClient->getConnection())) {
- throw new Predis_ClientException(
- 'Cannot initialize a MULTI/EXEC context over a cluster of connections'
- );
- }
- $profile = $redisClient->getProfile();
- if ($profile->supportsCommands(array('multi', 'exec', 'discard')) === false) {
- throw new Predis_ClientException(
- 'The current profile does not support MULTI, EXEC and DISCARD commands'
- );
- }
- $this->_supportsWatch = $profile->supportsCommands(array('watch', 'unwatch'));
- }
- private function isWatchSupported() {
- if ($this->_supportsWatch === false) {
- throw new Predis_ClientException(
- 'The current profile does not support WATCH and UNWATCH commands'
- );
- }
- }
- private function initialize() {
- if ($this->_initialized === false) {
- if (isset($this->_options['watch'])) {
- $this->watch($this->_options['watch']);
- }
- $this->_redisClient->multi();
- $this->_initialized = true;
- $this->_discarded = false;
- }
- }
- private function setInsideBlock($value) {
- $this->_insideBlock = $value;
- }
- public function __call($method, $arguments) {
- $this->initialize();
- $command = $this->_redisClient->createCommand($method, $arguments);
- $response = $this->_redisClient->executeCommand($command);
- if (isset($response->queued)) {
- $this->_commands[] = $command;
- return $this;
- }
- else {
- $this->malformedServerResponse('The server did not respond with a QUEUED status reply');
- }
- }
- public function watch($keys) {
- $this->isWatchSupported();
- if ($this->_initialized === true) {
- throw new Predis_ClientException('WATCH inside MULTI is not allowed');
- }
- $reply = null;
- if (is_array($keys)) {
- $reply = array();
- foreach ($keys as $key) {
- $reply = $this->_redisClient->watch($keys);
- }
- }
- else {
- $reply = $this->_redisClient->watch($keys);
- }
- return $reply;
- }
- public function multi() {
- $this->initialize();
- }
- public function unwatch() {
- $this->isWatchSupported();
- $this->_redisClient->unwatch();
- }
- public function discard() {
- $this->_redisClient->discard();
- $this->_commands = array();
- $this->_initialized = false;
- $this->_discarded = true;
- }
- public function exec() {
- return $this->execute();
- }
- public function execute($block = null) {
- if ($this->_insideBlock === true) {
- throw new Predis_ClientException(
- "Cannot invoke 'execute' or 'exec' inside an active client transaction block"
- );
- }
- if ($block && !is_callable($block)) {
- throw new InvalidArgumentException('Argument passed must be a callable object');
- }
- $blockException = null;
- $returnValues = array();
- if ($block !== null) {
- $this->setInsideBlock(true);
- try {
- $block($this);
- }
- catch (Predis_CommunicationException $exception) {
- $blockException = $exception;
- }
- catch (Predis_ServerException $exception) {
- $blockException = $exception;
- }
- catch (Exception $exception) {
- $blockException = $exception;
- if ($this->_initialized === true) {
- $this->discard();
- }
- }
- $this->setInsideBlock(false);
- if ($blockException !== null) {
- throw $blockException;
- }
- }
- if ($this->_initialized === false) {
- return;
- }
- $reply = $this->_redisClient->exec();
- if ($reply === null) {
- throw new Predis_AbortedMultiExec('The current transaction has been aborted by the server');
- }
- $execReply = $reply instanceof Iterator ? iterator_to_array($reply) : $reply;
- $commands = &$this->_commands;
- $sizeofReplies = count($execReply);
- if ($sizeofReplies !== count($commands)) {
- $this->malformedServerResponse('Unexpected number of responses for a Predis_MultiExecBlock');
- }
- for ($i = 0; $i < $sizeofReplies; $i++) {
- $returnValues[] = $commands[$i]->parseResponse($execReply[$i] instanceof Iterator
- ? iterator_to_array($execReply[$i])
- : $execReply[$i]
- );
- unset($commands[$i]);
- }
- return $returnValues;
- }
- }
- class Predis_PubSubContext implements Iterator {
- const SUBSCRIBE = 'subscribe';
- const UNSUBSCRIBE = 'unsubscribe';
- const PSUBSCRIBE = 'psubscribe';
- const PUNSUBSCRIBE = 'punsubscribe';
- const MESSAGE = 'message';
- const PMESSAGE = 'pmessage';
- const STATUS_VALID = 0x0001;
- const STATUS_SUBSCRIBED = 0x0010;
- const STATUS_PSUBSCRIBED = 0x0100;
- private $_redisClient, $_position;
- public function __construct(Predis_Client $redisClient) {
- $this->checkCapabilities($redisClient);
- $this->_redisClient = $redisClient;
- $this->_statusFlags = self::STATUS_VALID;
- }
- public function __destruct() {
- if ($this->valid()) {
- $this->closeContext();
- }
- }
- private function checkCapabilities(Predis_Client $redisClient) {
- if (Predis_Shared_Utils::isCluster($redisClient->getConnection())) {
- throw new Predis_ClientException(
- 'Cannot initialize a PUB/SUB context over a cluster of connections'
- );
- }
- $profile = $redisClient->getProfile();
- $commands = array('publish', 'subscribe', 'unsubscribe', 'psubscribe', 'punsubscribe');
- if ($profile->supportsCommands($commands) === false) {
- throw new Predis_ClientException(
- 'The current profile does not support PUB/SUB related commands'
- );
- }
- }
- private function isFlagSet($value) {
- return ($this->_statusFlags & $value) === $value;
- }
- public function subscribe(/* arguments */) {
- $args = func_get_args();
- $this->writeCommand(self::SUBSCRIBE, $args);
- $this->_statusFlags |= self::STATUS_SUBSCRIBED;
- }
- public function unsubscribe(/* arguments */) {
- $args = func_get_args();
- $this->writeCommand(self::UNSUBSCRIBE, $args);
- }
- public function psubscribe(/* arguments */) {
- $args = func_get_args();
- $this->writeCommand(self::PSUBSCRIBE, $args);
- $this->_statusFlags |= self::STATUS_PSUBSCRIBED;
- }
- public function punsubscribe(/* arguments */) {
- $args = func_get_args();
- $this->writeCommand(self::PUNSUBSCRIBE, $args);
- }
- public function closeContext() {
- if ($this->valid()) {
- if ($this->isFlagSet(self::STATUS_SUBSCRIBED)) {
- $this->unsubscribe();
- }
- if ($this->isFlagSet(self::STATUS_PSUBSCRIBED)) {
- $this->punsubscribe();
- }
- }
- }
- private function writeCommand($method, $arguments) {
- if (count($arguments) === 1 && is_array($arguments[0])) {
- $arguments = $arguments[0];
- }
- $command = $this->_redisClient->createCommand($method, $arguments);
- $this->_redisClient->getConnection()->writeCommand($command);
- }
- public function rewind() {
- // NOOP
- }
- public function current() {
- return $this->getValue();
- }
- public function key() {
- return $this->_position;
- }
- public function next() {
- if ($this->isFlagSet(self::STATUS_VALID)) {
- $this->_position++;
- }
- return $this->_position;
- }
- public function valid() {
- $subscriptions = self::STATUS_SUBSCRIBED + self::STATUS_PSUBSCRIBED;
- return $this->isFlagSet(self::STATUS_VALID)
- && ($this->_statusFlags & $subscriptions) > 0;
- }
- private function invalidate() {
- $this->_statusFlags = 0x0000;
- }
- private function getValue() {
- $reader = $this->_redisClient->getResponseReader();
- $connection = $this->_redisClient->getConnection();
- $response = $reader->read($connection);
- switch ($response[0]) {
- case self::SUBSCRIBE:
- case self::UNSUBSCRIBE:
- case self::PSUBSCRIBE:
- case self::PUNSUBSCRIBE:
- if ($response[2] === 0) {
- $this->invalidate();
- }
- case self::MESSAGE:
- return (object) array(
- 'kind' => $response[0],
- 'channel' => $response[1],
- 'payload' => $response[2],
- );
- case self::PMESSAGE:
- return (object) array(
- 'kind' => $response[0],
- 'pattern' => $response[1],
- 'channel' => $response[2],
- 'payload' => $response[3],
- );
- default:
- throw new Predis_ClientException(
- "Received an unknown message type {$response[0]} inside of a pubsub context"
- );
- }
- }
- }
- /* ------------------------------------------------------------------------- */
- class Predis_ConnectionParameters {
- const DEFAULT_HOST = '127.0.0.1';
- const DEFAULT_PORT = 6379;
- const DEFAULT_TIMEOUT = 5;
- private $_parameters;
- public function __construct($parameters = null) {
- $parameters = $parameters !== null ? $parameters : array();
- $this->_parameters = is_array($parameters)
- ? self::filterConnectionParams($parameters)
- : self::parseURI($parameters);
- }
- private static function parseURI($uri) {
- $parsed = @parse_url($uri);
- if ($parsed == false || $parsed['scheme'] != 'redis' || $parsed['host'] == null) {
- throw new Predis_ClientException("Invalid URI: $uri");
- }
- if (array_key_exists('query', $parsed)) {
- $details = array();
- foreach (explode('&', $parsed['query']) as $kv) {
- list($k, $v) = explode('=', $kv);
- switch ($k) {
- case 'database':
- $details['database'] = $v;
- break;
- case 'password':
- $details['password'] = $v;
- break;
- case 'connection_async':
- $details['connection_async'] = $v;
- break;
- case 'connection_persistent':
- $details['connection_persistent'] = $v;
- break;
- case 'connection_timeout':
- $details['connection_timeout'] = $v;
- break;
- case 'read_write_timeout':
- $details['read_write_timeout'] = $v;
- break;
- case 'alias':
- $details['alias'] = $v;
- break;
- case 'weight':
- $details['weight'] = $v;
- break;
- }
- }
- $parsed = array_merge($parsed, $details);
- }
- return self::filterConnectionParams($parsed);
- }
- private static function getParamOrDefault(Array $parameters, $param, $default = null) {
- return array_key_exists($param, $parameters) ? $parameters[$param] : $default;
- }
- private static function filterConnectionParams($parameters) {
- return array(
- 'host' => self::getParamOrDefault($parameters, 'host', self::DEFAULT_HOST),
- 'port' => (int) self::getParamOrDefault($parameters, 'port', self::DEFAULT_PORT),
- 'database' => self::getParamOrDefault($parameters, 'database'),
- 'password' => self::getParamOrDefault($parameters, 'password'),
- 'connection_async' => self::getParamOrDefault($parameters, 'connection_async', false),
- 'connection_persistent' => self::getParamOrDefault($parameters, 'connection_persistent', false),
- 'connection_timeout' => self::getParamOrDefault($parameters, 'connection_timeout', self::DEFAULT_TIMEOUT),
- 'read_write_timeout' => self::getParamOrDefault($parameters, 'read_write_timeout'),
- 'alias' => self::getParamOrDefault($parameters, 'alias'),
- 'weight' => self::getParamOrDefault($parameters, 'weight'),
- );
- }
- public function __get($parameter) {
- return $this->_parameters[$parameter];
- }
- public function __isset($parameter) {
- return isset($this->_parameters[$parameter]);
- }
- }
- interface Predis_IConnection {
- public function connect();
- public function disconnect();
- public function isConnected();
- public function writeCommand(Predis_Command $command);
- public function readResponse(Predis_Command $command);
- public function executeCommand(Predis_Command $command);
- }
- class Predis_Connection implements Predis_IConnection {
- private $_params, $_socket, $_initCmds, $_reader;
- public function __construct(Predis_ConnectionParameters $parameters, Predis_ResponseReader $reader = null) {
- $this->_params = $parameters;
- $this->_initCmds = array();
- $this->_reader = $reader !== null ? $reader : new Predis_ResponseReader();
- }
- public function __destruct() {
- if (!$this->_params->connection_persistent) {
- $this->disconnect();
- }
- }
- public function isConnected() {
- return is_resource($this->_socket);
- }
- public function connect() {
- if ($this->isConnected()) {
- throw new Predis_ClientException('Connection already estabilished');
- }
- $uri = sprintf('tcp://%s:%d/', $this->_params->host, $this->_params->port);
- $connectFlags = STREAM_CLIENT_CONNECT;
- if ($this->_params->connection_async) {
- $connectFlags |= STREAM_CLIENT_ASYNC_CONNECT;
- }
- if ($this->_params->connection_persistent) {
- $connectFlags |= STREAM_CLIENT_PERSISTENT;
- }
- $this->_socket = @stream_socket_client(
- $uri, $errno, $errstr, $this->_params->connection_timeout, $connectFlags
- );
- if (!$this->_socket) {
- $this->onCommunicationException(trim($errstr), $errno);
- }
- if (isset($this->_params->read_write_timeout)) {
- $timeoutSeconds = floor($this->_params->read_write_timeout);
- $timeoutUSeconds = ($this->_params->read_write_timeout - $timeoutSeconds) * 1000000;
- stream_set_timeout($this->_socket, $timeoutSeconds, $timeoutUSeconds);
- }
- if (count($this->_initCmds) > 0){
- $this->sendInitializationCommands();
- }
- }
- public function disconnect() {
- if ($this->isConnected()) {
- fclose($this->_socket);
- }
- }
- public function pushInitCommand(Predis_Command $command){
- $this->_initCmds[] = $command;
- }
- private function sendInitializationCommands() {
- foreach ($this->_initCmds as $command) {
- $this->writeCommand($command);
- }
- foreach ($this->_initCmds as $command) {
- $this->readResponse($command);
- }
- }
- private function onCommunicationException($message, $code = null) {
- Predis_Shared_Utils::onCommunicationException(
- new Predis_CommunicationException($this, $message, $code)
- );
- }
- public function writeCommand(Predis_Command $command) {
- $this->writeBytes($command->invoke());
- }
- public function readResponse(Predis_Command $command) {
- $response = $this->_reader->read($this);
- $skipparse = isset($response->queued) || isset($response->error);
- return $skipparse ? $response : $command->parseResponse($response);
- }
- public function executeCommand(Predis_Command $command) {
- $this->writeCommand($command);
- if ($command->closesConnection()) {
- return $this->disconnect();
- }
- return $this->readResponse($command);
- }
- public function rawCommand($rawCommandData, $closesConnection = false) {
- $this->writeBytes($rawCommandData);
- if ($closesConnection) {
- $this->disconnect();
- return;
- }
- return $this->_reader->read($this);
- }
- public function writeBytes($value) {
- $socket = $this->getSocket();
- while (($length = strlen($value)) > 0) {
- $written = fwrite($socket, $value);
- if ($length === $written) {
- return true;
- }
- if ($written === false || $written === 0) {
- $this->onCommunicationException('Error while writing bytes to the server');
- }
- $value = substr($value, $written);
- }
- return true;
- }
- public function readBytes($length) {
- if ($length == 0) {
- throw new InvalidArgumentException('Length parameter must be greater than 0');
- }
- $socket = $this->getSocket();
- $value = '';
- do {
- $chunk = fread($socket, $length);
- if ($chunk === false || $chunk === '') {
- $this->onCommunicationException('Error while reading bytes from the server');
- }
- $value .= $chunk;
- }
- while (($length -= strlen($chunk)) > 0);
- return $value;
- }
- public function readLine() {
- $socket = $this->getSocket();
- $value = '';
- do {
- $chunk = fgets($socket);
- if ($chunk === false || strlen($chunk) == 0) {
- $this->onCommunicationException('Error while reading line from the server');
- }
- $value .= $chunk;
- }
- while (substr($value, -2) !== Predis_Protocol::NEWLINE);
- return substr($value, 0, -2);
- }
- public function getSocket() {
- if (!$this->isConnected()) {
- $this->connect();
- }
- return $this->_socket;
- }
- public function getResponseReader() {
- return $this->_reader;
- }
- public function getParameters() {
- return $this->_params;
- }
- public function __toString() {
- return sprintf('%s:%d', $this->_params->host, $this->_params->port);
- }
- }
- class Predis_ConnectionCluster implements Predis_IConnection, IteratorAggregate {
- private $_pool, $_distributor;
- public function __construct(Predis_Distribution_IDistributionStrategy $distributor = null) {
- $this->_pool = array();
- $this->_distributor = $distributor !== null ? $distributor : new Predis_Distribution_HashRing();
- }
- public function isConnected() {
- foreach ($this->_pool as $connection) {
- if ($connection->isConnected()) {
- return true;
- }
- }
- return false;
- }
- public function connect() {
- foreach ($this->_pool as $connection) {
- $connection->connect();
- }
- }
- public function disconnect() {
- foreach ($this->_pool as $connection) {
- $connection->disconnect();
- }
- }
- public function add(Predis_Connection $connection) {
- $parameters = $connection->getParameters();
- if (isset($parameters->alias)) {
- $this->_pool[$parameters->alias] = $connection;
- }
- else {
- $this->_pool[] = $connection;
- }
- $this->_distributor->add($connection, $parameters->weight);
- }
- public function getConnection(Predis_Command $command) {
- if ($command->canBeHashed() === false) {
- throw new Predis_ClientException(
- sprintf("Cannot send '%s' commands to a cluster of connections", $command->getCommandId())
- );
- }
- return $this->_distributor->get($command->getHash($this->_distributor));
- }
- public function getConnectionById($id = null) {
- $alias = $id !== null ? $id : 0;
- return isset($this->_pool[$alias]) ? $this->_pool[$alias] : null;
- }
- public function getIterator() {
- return new ArrayIterator($this->_pool);
- }
- public function writeCommand(Predis_Command $command) {
- $this->getConnection($command)->writeCommand($command);
- }
- public function readResponse(Predis_Command $command) {
- return $this->getConnection($command)->readResponse($command);
- }
- public function executeCommand(Predis_Command $command) {
- $connection = $this->getConnection($command);
- $connection->writeCommand($command);
- return $connection->readResponse($command);
- }
- }
- /* ------------------------------------------------------------------------- */
- abstract class Predis_RedisServerProfile {
- private static $_serverProfiles;
- private $_registeredCommands;
- public function __construct() {
- $this->_registeredCommands = $this->getSupportedCommands();
- }
- public abstract function getVersion();
- protected abstract function getSupportedCommands();
- public static function getDefault() {
- return self::get('default');
- }
- public static function getDevelopment() {
- return self::get('dev');
- }
- private static function predisServerProfiles() {
- return array(
- '1.2' => 'Predis_RedisServer_v1_2',
- '2.0' => 'Predis_RedisServer_v2_0',
- 'default' => 'Predis_RedisServer_v2_0',
- 'dev' => 'Predis_RedisServer_vNext',
- );
- }
- public static function registerProfile($profileClass, $aliases) {
- if (!isset(self::$_serverProfiles)) {
- self::$_serverProfiles = self::predisServerProfiles();
- }
- $profileReflection = new ReflectionClass($profileClass);
- if (!$profileReflection->isSubclassOf('Predis_RedisServerProfile')) {
- throw new Predis_ClientException("Cannot register '$profileClass' as it is not a valid profile class");
- }
- if (is_array($aliases)) {
- foreach ($aliases as $alias) {
- self::$_serverProfiles[$alias] = $profileClass;
- }
- }
- else {
- self::$_serverProfiles[$aliases] = $profileClass;
- }
- }
- public static function get($version) {
- if (!isset(self::$_serverProfiles)) {
- self::$_serverProfiles = self::predisServerProfiles();
- }
- if (!isset(self::$_serverProfiles[$version])) {
- throw new Predis_ClientException("Unknown server profile: $version");
- }
- $profile = self::$_serverProfiles[$version];
- return new $profile();
- }
- public function supportsCommands(Array $commands) {
- foreach ($commands as $command) {
- if ($this->supportsCommand($command) === false) {
- return false;
- }
- }
- return true;
- }
- public function supportsCommand($command) {
- return isset($this->_registeredCommands[$command]);
- }
- public function createCommand($method, $arguments = array()) {
- if (!isset($this->_registeredCommands[$method])) {
- throw new Predis_ClientException("'$method' is not a registered Redis command");
- }
- $commandClass = $this->_registeredCommands[$method];
- $command = new $commandClass();
- $command->setArgumentsArray($arguments);
- return $command;
- }
- public function registerCommands(Array $commands) {
- foreach ($commands as $command => $aliases) {
- $this->registerCommand($command, $aliases);
- }
- }
- public function registerCommand($command, $aliases) {
- $commandReflection = new ReflectionClass($command);
- if (!$commandReflection->isSubclassOf('Predis_Command')) {
- throw new ClientException("Cannot register '$command' as it is not a valid Redis command");
- }
- if (is_array($aliases)) {
- foreach ($aliases as $alias) {
- $this->_registeredCommands[$alias] = $command;
- }
- }
- else {
- $this->_registeredCommands[$aliases] = $command;
- }
- }
- public function __toString() {
- return $this->getVersion();
- }
- }
- class Predis_RedisServer_v1_2 extends Predis_RedisServerProfile {
- public function getVersion() { return '1.2'; }
- public function getSupportedCommands() {
- return array(
- /* miscellaneous commands */
- 'ping' => 'Predis_Commands_Ping',
- 'echo' => 'Predis_Commands_DoEcho',
- 'auth' => 'Predis_Commands_Auth',
- /* connection handling */
- 'quit' => 'Predis_Commands_Quit',
- /* commands operating on string values */
- 'set' => 'Predis_Commands_Set',
- 'setnx' => 'Predis_Commands_SetPreserve',
- 'setPreserve' => 'Predis_Commands_SetPreserve',
- 'mset' => 'Predis_Commands_SetMultiple',
- 'setMultiple' => 'Predis_Commands_SetMultiple',
- 'msetnx' => 'Predis_Commands_SetMultiplePreserve',
- 'setMultiplePreserve' => 'Predis_Commands_SetMultiplePreserve',
- 'get' => 'Predis_Commands_Get',
- 'mget' => 'Predis_Commands_GetMultiple',
- 'getMultiple' => 'Predis_Commands_GetMultiple',
- 'getset' => 'Predis_Commands_GetSet',
- 'getSet' => 'Predis_Commands_GetSet',
- 'incr' => 'Predis_Commands_Increment',
- 'increment' => 'Predis_Commands_Increment',
- 'incrby' => 'Predis_Commands_IncrementBy',
- 'incrementBy' => 'Predis_Commands_IncrementBy',
- 'decr' => 'Predis_Commands_Decrement',
- 'decrement' => 'Predis_Commands_Decrement',
- 'decrby' => 'Predis_Commands_DecrementBy',
- 'decrementBy' => 'Predis_Commands_DecrementBy',
- 'exists' => 'Predis_Commands_Exists',
- 'del' => 'Predis_Commands_Delete',
- 'delete' => 'Predis_Commands_Delete',
- 'type' => 'Predis_Commands_Type',
- /* commands operating on the key space */
- 'keys' => 'Predis_Commands_Keys',
- 'randomkey' => 'Predis_Commands_RandomKey',
- 'randomKey' => 'Predis_Commands_RandomKey',
- 'rename' => 'Predis_Commands_Rename',
- 'renamenx' => 'Predis_Commands_RenamePreserve',
- 'renamePreserve' => 'Predis_Commands_RenamePreserve',
- 'expire' => 'Predis_Commands_Expire',
- 'expireat' => 'Predis_Commands_ExpireAt',
- 'expireAt' => 'Predis_Commands_ExpireAt',
- 'dbsize' => 'Predis_Commands_DatabaseSize',
- 'databaseSize' => 'Predis_Commands_DatabaseSize',
- 'ttl' => 'Predis_Commands_TimeToLive',
- 'timeToLive' => 'Predis_Commands_TimeToLive',
- /* commands operating on lists */
- 'rpush' => 'Predis_Commands_ListPushTail',
- 'pushTail' => 'Predis_Commands_ListPushTail',
- 'lpush' => 'Predis_Commands_ListPushHead',
- 'pushHead' => 'Predis_Commands_ListPushHead',
- 'llen' => 'Predis_Commands_ListLength',
- 'listLength' => 'Predis_Commands_ListLength',
- 'lrange' => 'Predis_Commands_ListRange',
- 'listRange' => 'Predis_Commands_ListRange',
- 'ltrim' => 'Predis_Commands_ListTrim',
- 'listTrim' => 'Predis_Commands_ListTrim',
- 'lindex' => 'Predis_Commands_ListIndex',
- 'listIndex' => 'Predis_Commands_ListIndex',
- 'lset' => 'Predis_Commands_ListSet',
- 'listSet' => 'Predis_Commands_ListSet',
- 'lrem' => 'Predis_Commands_ListRemove',
- 'listRemove' => 'Predis_Commands_ListRemove',
- 'lpop' => 'Predis_Commands_ListPopFirst',
- 'popFirst' => 'Predis_Commands_ListPopFirst',
- 'rpop' => 'Predis_Commands_ListPopLast',
- 'popLast' => 'Predis_Commands_ListPopLast',
- 'rpoplpush' => 'Predis_Commands_ListPopLastPushHead',
- 'listPopLastPushHead' => 'Predis_Commands_ListPopLastPushHead',
- /* commands operating on sets */
- 'sadd' => 'Predis_Commands_SetAdd',
- 'setAdd' => 'Predis_Commands_SetAdd',
- 'srem' => 'Predis_Commands_SetRemove',
- 'setRemove' => 'Predis_Commands_SetRemove',
- 'spop' => 'Predis_Commands_SetPop',
- 'setPop' => 'Predis_Commands_SetPop',
- 'smove' => 'Predis_Commands_SetMove',
- 'setMove' => 'Predis_Commands_SetMove',
- 'scard' => 'Predis_Commands_SetCardinality',
- 'setCardinality' => 'Predis_Commands_SetCardinality',
- 'sismember' => 'Predis_Commands_SetIsMember',
- 'setIsMember' => 'Predis_Commands_SetIsMember',
- 'sinter' => 'Predis_Commands_SetIntersection',
- 'setIntersection' => 'Predis_Commands_SetIntersection',
- 'sinterstore' => 'Predis_Commands_SetIntersectionStore',
- 'setIntersectionStore' => 'Predis_Commands_SetIntersectionStore',
- 'sunion' => 'Predis_Commands_SetUnion',
- 'setUnion' => 'Predis_Commands_SetUnion',
- 'sunionstore' => 'Predis_Commands_SetUnionStore',
- 'setUnionStore' => 'Predis_Commands_SetUnionStore',
- 'sdiff' => 'Predis_Commands_SetDifference',
- 'setDifference' => 'Predis_Commands_SetDifference',
- 'sdiffstore' => 'Predis_Commands_SetDifferenceStore',
- 'setDifferenceStore' => 'Predis_Commands_SetDifferenceStore',
- 'smembers' => 'Predis_Commands_SetMembers',
- 'setMembers' => 'Predis_Commands_SetMembers',
- 'srandmember' => 'Predis_Commands_SetRandomMember',
- 'setRandomMember' => 'Predis_Commands_SetRandomMember',
- /* commands operating on sorted sets */
- 'zadd' => 'Predis_Commands_ZSetAdd',
- 'zsetAdd' => 'Predis_Commands_ZSetAdd',
- 'zincrby' => 'Predis_Commands_ZSetIncrementBy',
- 'zsetIncrementBy' => 'Predis_Commands_ZSetIncrementBy',
- 'zrem' => 'Predis_Commands_ZSetRemove',
- 'zsetRemove' => 'Predis_Commands_ZSetRemove',
- 'zrange' => 'Predis_Commands_ZSetRange',
- 'zsetRange' => 'Predis_Commands_ZSetRange',
- 'zrevrange' => 'Predis_Commands_ZSetReverseRange',
- 'zsetReverseRange' => 'Predis_Commands_ZSetReverseRange',
- 'zrangebyscore' => 'Predis_Commands_ZSetRangeByScore',
- 'zsetRangeByScore' => 'Predis_Commands_ZSetRangeByScore',
- 'zcard' => 'Predis_Commands_ZSetCardinality',
- 'zsetCardinality' => 'Predis_Commands_ZSetCardinality',
- 'zscore' => 'Predis_Commands_ZSetScore',
- 'zsetScore' => 'Predis_Commands_ZSetScore',
- 'zremrangebyscore' => 'Predis_Commands_ZSetRemoveRangeByScore',
- 'zsetRemoveRangeByScore' => 'Predis_Commands_ZSetRemoveRangeByScore',
- /* multiple databases handling commands */
- 'select' => 'Predis_Commands_SelectDatabase',
- 'selectDatabase' => 'Predis_Commands_SelectDatabase',
- 'move' => 'Predis_Commands_MoveKey',
- 'moveKey' => 'Predis_Commands_MoveKey',
- 'flushdb' => 'Predis_Commands_FlushDatabase',
- 'flushDatabase' => 'Predis_Commands_FlushDatabase',
- 'flushall' => 'Predis_Commands_FlushAll',
- 'flushDatabases' => 'Predis_Commands_FlushAll',
- /* sorting */
- 'sort' => 'Predis_Commands_Sort',
- /* remote server control commands */
- 'info' => 'Predis_Commands_Info',
- 'slaveof' => 'Predis_Commands_SlaveOf',
- 'slaveOf' => 'Predis_Commands_SlaveOf',
- /* persistence control commands */
- 'save' => 'Predis_Commands_Save',
- 'bgsave' => 'Predis_Commands_BackgroundSave',
- 'backgroundSave' => 'Predis_Commands_BackgroundSave',
- 'lastsave' => 'Predis_Commands_LastSave',
- 'lastSave' => 'Predis_Commands_LastSave',
- 'shutdown' => 'Predis_Commands_Shutdown',
- 'bgrewriteaof' => 'Predis_Commands_BackgroundRewriteAppendOnlyFile',
- 'backgroundRewriteAppendOnlyFile' => 'Predis_Commands_BackgroundRewriteAppendOnlyFile',
- );
- }
- }
- class Predis_RedisServer_v2_0 extends Predis_RedisServer_v1_2 {
- public function getVersion() { return '2.0'; }
- public function getSupportedCommands() {
- return array_merge(parent::getSupportedCommands(), array(
- /* transactions */
- 'multi' => 'Predis_Commands_Multi',
- 'exec' => 'Predis_Commands_Exec',
- 'discard' => 'Predis_Commands_Discard',
- /* commands operating on string values */
- 'setex' => 'Predis_Commands_SetExpire',
- 'setExpire' => 'Predis_Commands_SetExpire',
- 'append' => 'Predis_Commands_Append',
- 'substr' => 'Predis_Commands_Substr',
- /* commands operating on lists */
- 'blpop' => 'Predis_Commands_ListPopFirstBlocking',
- 'popFirstBlocking' => 'Predis_Commands_ListPopFirstBlocking',
- 'brpop' => 'Predis_Commands_ListPopLastBlocking',
- 'popLastBlocking' => 'Predis_Commands_ListPopLastBlocking',
- /* commands operating on sorted sets */
- 'zunionstore' => 'Predis_Commands_ZSetUnionStore',
- 'zsetUnionStore' => 'Predis_Commands_ZSetUnionStore',
- 'zinterstore' => 'Predis_Commands_ZSetIntersectionStore',
- 'zsetIntersectionStore' => 'Predis_Commands_ZSetIntersectionStore',
- 'zcount' => 'Predis_Commands_ZSetCount',
- 'zsetCount' => 'Predis_Commands_ZSetCount',
- 'zrank' => 'Predis_Commands_ZSetRank',
- 'zsetRank' => 'Predis_Commands_ZSetRank',
- 'zrevrank' => 'Predis_Commands_ZSetReverseRank',
- 'zsetReverseRank' => 'Predis_Commands_ZSetReverseRank',
- 'zremrangebyrank' => 'Predis_Commands_ZSetRemoveRangeByRank',
- 'zsetRemoveRangeByRank' => 'Predis_Commands_ZSetRemoveRangeByRank',
- /* commands operating on hashes */
- 'hset' => 'Predis_Commands_HashSet',
- 'hashSet' => 'Predis_Commands_HashSet',
- 'hsetnx' => 'Predis_Commands_HashSetPreserve',
- 'hashSetPreserve' => 'Predis_Commands_HashSetPreserve',
- 'hmset' => 'Predis_Commands_HashSetMultiple',
- 'hashSetMultiple' => 'Predis_Commands_HashSetMultiple',
- 'hincrby' => 'Predis_Commands_HashIncrementBy',
- 'hashIncrementBy' => 'Predis_Commands_HashIncrementBy',
- 'hget' => 'Predis_Commands_HashGet',
- 'hashGet' => 'Predis_Commands_HashGet',
- 'hmget' => 'Predis_Commands_HashGetMultiple',
- 'hashGetMultiple' => 'Predis_Commands_HashGetMultiple',
- 'hdel' => 'Predis_Commands_HashDelete',
- 'hashDelete' => 'Predis_Commands_HashDelete',
- 'hexists' => 'Predis_Commands_HashExists',
- 'hashExists' => 'Predis_Commands_HashExists',
- 'hlen' => 'Predis_Commands_HashLength',
- 'hashLength' => 'Predis_Commands_HashLength',
- 'hkeys' => 'Predis_Commands_HashKeys',
- 'hashKeys' => 'Predis_Commands_HashKeys',
- 'hvals' => 'Predis_Commands_HashValues',
- 'hashValues' => 'Predis_Commands_HashValues',
- 'hgetall' => 'Predis_Commands_HashGetAll',
- 'hashGetAll' => 'Predis_Commands_HashGetAll',
- /* publish - subscribe */
- 'subscribe' => 'Predis_Commands_Subscribe',
- 'unsubscribe' => 'Predis_Commands_Unsubscribe',
- 'psubscribe' => 'Predis_Commands_SubscribeByPattern',
- 'punsubscribe' => 'Predis_Commands_UnsubscribeByPattern',
- 'publish' => 'Predis_Commands_Publish',
- /* remote server control commands */
- 'config' => 'Predis_Commands_Config',
- 'configuration' => 'Predis_Commands_Config',
- ));
- }
- }
- class Predis_RedisServer_vNext extends Predis_RedisServer_v2_0 {
- public function getVersion() { return '2.1'; }
- public function getSupportedCommands() {
- return array_merge(parent::getSupportedCommands(), array(
- /* transactions */
- 'watch' => 'Predis_Commands_Watch',
- 'unwatch' => 'Predis_Commands_Unwatch',
- /* commands operating on string values */
- 'strlen' => 'Predis_Commands_Strlen',
- /* commands operating on the key space */
- 'persist' => 'Predis_Commands_Persist',
- /* commands operating on lists */
- 'rpushx' => 'Predis_Commands_ListPushTailX',
- 'lpushx' => 'Predis_Commands_ListPushHeadX',
- 'linsert' => 'Predis_Commands_ListInsert',
- /* commands operating on sorted sets */
- 'zrevrangebyscore' => 'Predis_Commands_ZSetReverseRangeByScore',
- ));
- }
- }
- /* ------------------------------------------------------------------------- */
- interface Predis_Pipeline_IPipelineExecutor {
- public function execute(Predis_IConnection $connection, &$commands);
- }
- class Predis_Pipeline_StandardExecutor implements Predis_Pipeline_IPipelineExecutor {
- public function execute(Predis_IConnection $connection, &$commands) {
- $sizeofPipe = count($commands);
- $values = array();
- foreach ($commands as $command) {
- $connection->writeCommand($command);
- }
- try {
- for ($i = 0; $i < $sizeofPipe; $i++) {
- $response = $connection->readResponse($commands[$i]);
- $values[] = $response instanceof Iterator
- ? iterator_to_array($response)
- : $response;
- unset($commands[$i]);
- }
- }
- catch (Predis_ServerException $exception) {
- // force disconnection to prevent protocol desynchronization
- $connection->disconnect();
- throw $exception;
- }
- return $values;
- }
- }
- class Predis_Pipeline_SafeExecutor implements Predis_Pipeline_IPipelineExecutor {
- public function execute(Predis_IConnection $connection, &$commands) {
- $sizeofPipe = count($commands);
- $values = array();
- foreach ($commands as $command) {
- try {
- $connection->writeCommand($command);
- }
- catch (Predis_CommunicationException $exception) {
- return array_fill(0, $sizeofPipe, $exception);
- }
- }
- for ($i = 0; $i < $sizeofPipe; $i++) {
- $command = $commands[$i];
- unset($commands[$i]);
- try {
- $response = $connection->readResponse($command);
- $values[] = ($response instanceof Iterator
- ? iterator_to_array($response)
- : $response
- );
- }
- catch (Predis_ServerException $exception) {
- $values[] = $exception->toResponseError();
- }
- catch (Predis_CommunicationException $exception) {
- $toAdd = count($commands) - count($values);
- $values = array_merge($values, array_fill(0, $toAdd, $exception));
- break;
- }
- }
- return $values;
- }
- }
- class Predis_Pipeline_SafeClusterExecutor implements Predis_Pipeline_IPipelineExecutor {
- public function execute(Predis_IConnection $connection, &$commands) {
- $connectionExceptions = array();
- $sizeofPipe = count($commands);
- $values = array();
- foreach ($commands as $command) {
- $cmdConnection = $connection->getConnection($command);
- if (isset($connectionExceptions[spl_object_hash($cmdConnection)])) {
- continue;
- }
- try {
- $cmdConnection->writeCommand($command);
- }
- catch (Predis_CommunicationException $exception) {
- $connectionExceptions[spl_object_hash($cmdConnection)] = $exception;
- }
- }
- for ($i = 0; $i < $sizeofPipe; $i++) {
- $command = $commands[$i];
- unset($commands[$i]);
- $cmdConnection = $connection->getConnection($command);
- $connectionObjectHash = spl_object_hash($cmdConnection);
- if (isset($connectionExceptions[$connectionObjectHash])) {
- $values[] = $connectionExceptions[$connectionObjectHash];
- continue;
- }
- try {
- $response = $cmdConnection->readResponse($command);
- $values[] = ($response instanceof Iterator
- ? iterator_to_array($response)
- : $response
- );
- }
- catch (Predis_ServerException $exception) {
- $values[] = $exception->toResponseError();
- }
- catch (Predis_CommunicationException $exception) {
- $values[] = $exception;
- $connectionExceptions[$connectionObjectHash] = $exception;
- }
- }
- return $values;
- }
- }
- /* ------------------------------------------------------------------------- */
- interface Predis_Distribution_IDistributionStrategy {
- public function add($node, $weight = null);
- public function remove($node);
- public function get($key);
- public function generateKey($value);
- }
- class Predis_Distribution_EmptyRingException extends Exception { }
- class Predis_Distribution_HashRing implements Predis_Distribution_IDistributionStrategy {
- const DEFAULT_REPLICAS = 128;
- const DEFAULT_WEIGHT = 100;
- private $_nodes, $_ring, $_ringKeys, $_ringKeysCount, $_replicas;
- public function __construct($replicas = self::DEFAULT_REPLICAS) {
- $this->_replicas = $replicas;
- $this->_nodes = array();
- }
- public function add($node, $weight = null) {
- // NOTE: in case of collisions in the hashes of the nodes, the node added
- // last wins, thus the order in which nodes are added is significant.
- // TODO: self::DEFAULT_WEIGHT does not work for inherited classes that
- // override the DEFAULT_WEIGHT constant.
- $this->_nodes[] = array(
- 'object' => $node,
- 'weight' => (int) ($weight !== null ? $weight : self::DEFAULT_WEIGHT),
- );
- $this->reset();
- }
- public function remove($node) {
- // NOTE: a node is removed by resetting the ring so that it's recreated from
- // scratch, in order to reassign possible hashes with collisions to the
- // right node according to the order in which they were added in the
- // first place.
- for ($i = 0; $i < count($this->_nodes); ++$i) {
- if ($this->_nodes[$i]['object'] === $node) {
- array_splice($this->_nodes, $i, 1);
- $this->reset();
- break;
- }
- }
- }
- private function reset() {
- unset($this->_ring);
- unset($this->_ringKeys);
- unset($this->_ringKeysCount);
- }
- private function isInitialized() {
- return isset($this->_ringKeys);
- }
- private function computeTotalWeight() {
- $totalWeight = 0;
- foreach ($this->_nodes as $node) {
- $totalWeight += $node['weight'];
- }
- return $totalWeight;
- }
- private function initialize() {
- if ($this->isInitialized()) {
- return;
- }
- if (count($this->_nodes) === 0) {
- throw new Predis_Distribution_EmptyRingException('Cannot initialize empty hashring');
- }
- $this->_ring = array();
- $totalWeight = $this->computeTotalWeight();
- $nodesCount = count($this->_nodes);
- foreach ($this->_nodes as $node) {
- $weightRatio = $node['weight'] / $totalWeight;
- $this->addNodeToRing($this->_ring, $node, $nodesCount, $this->_replicas, $weightRatio);
- }
- ksort($this->_ring, SORT_NUMERIC);
- $this->_ringKeys = array_keys($this->_ring);
- $this->_ringKeysCount = count($this->_ringKeys);
- }
- protected function addNodeToRing(&$ring, $node, $totalNodes, $replicas, $weightRatio) {
- $nodeObject = $node['object'];
- $nodeHash = (string) $nodeObject;
- $replicas = (int) round($weightRatio * $totalNodes * $replicas);
- for ($i = 0; $i < $replicas; $i++) {
- $key = crc32("$nodeHash:$i");
- $ring[$key] = $nodeObject;
- }
- }
- public function generateKey($value) {
- return crc32($value);
- }
- public function get($key) {
- return $this->_ring[$this->getNodeKey($key)];
- }
- private function getNodeKey($key) {
- $this->initialize();
- $ringKeys = $this->_ringKeys;
- $upper = $this->_ringKeysCount - 1;
- $lower = 0;
- while ($lower <= $upper) {
- $index = ($lower + $upper) >> 1;
- $item = $ringKeys[$index];
- if ($item > $key) {
- $upper = $index - 1;
- }
- else if ($item < $key) {
- $lower = $index + 1;
- }
- else {
- return $item;
- }
- }
- return $ringKeys[$this->wrapAroundStrategy($upper, $lower, $this->_ringKeysCount)];
- }
- protected function wrapAroundStrategy($upper, $lower, $ringKeysCount) {
- // NOTE: binary search for the last item in _ringkeys with a value
- // less or equal to the key. If no such item exists, return the
- // last item.
- return $upper >= 0 ? $upper : $ringKeysCount - 1;
- }
- }
- class Predis_Distribution_KetamaPureRing extends Predis_Distribution_HashRing {
- const DEFAULT_REPLICAS = 160;
- public function __construct() {
- parent::__construct(self::DEFAULT_REPLICAS);
- }
- protected function addNodeToRing(&$ring, $node, $totalNodes, $replicas, $weightRatio) {
- $nodeObject = $node['object'];
- $nodeHash = (string) $nodeObject;
- $replicas = (int) floor($weightRatio * $totalNodes * ($replicas / 4));
- for ($i = 0; $i < $replicas; $i++) {
- $unpackedDigest = unpack('V4', md5("$nodeHash-$i", true));
- foreach ($unpackedDigest as $key) {
- $ring[$key] = $nodeObject;
- }
- }
- }
- public function generateKey($value) {
- $hash = unpack('V', md5($value, true));
- return $hash[1];
- }
- protected function wrapAroundStrategy($upper, $lower, $ringKeysCount) {
- // NOTE: binary search for the first item in _ringkeys with a value
- // greater or equal to the key. If no such item exists, return the
- // first item.
- return $lower < $ringKeysCount ? $lower : 0;
- }
- }
- /* ------------------------------------------------------------------------- */
- class Predis_Shared_Utils {
- public static function isCluster(Predis_IConnection $connection) {
- return $connection instanceof Predis_ConnectionCluster;
- }
- public static function onCommunicationException(Predis_CommunicationException $exception) {
- if ($exception->shouldResetConnection()) {
- $connection = $exception->getConnection();
- if ($connection->isConnected()) {
- $connection->disconnect();
- }
- }
- throw $exception;
- }
- }
- abstract class Predis_Shared_MultiBulkResponseIteratorBase implements Iterator, Countable {
- protected $_position, $_current, $_replySize;
- public function rewind() {
- // NOOP
- }
- public function current() {
- return $this->_current;
- }
- public function key() {
- return $this->_position;
- }
- public function next() {
- if (++$this->_position < $this->_replySize) {
- $this->_current = $this->getValue();
- }
- return $this->_position;
- }
- public function valid() {
- return $this->_position < $this->_replySize;
- }
- public function count() {
- // NOTE: use count if you want to get the size of the current multi-bulk
- // response without using iterator_count (which actually consumes
- // our iterator to calculate the size, and we cannot perform a rewind)
- return $this->_replySize;
- }
- protected abstract function getValue();
- }
- class Predis_Shared_MultiBulkResponseIterator extends Predis_Shared_MultiBulkResponseIteratorBase {
- private $_connection;
- public function __construct(Predis_Connection $connection, $size) {
- $this->_connection = $connection;
- $this->_reader = $connection->getResponseReader();
- $this->_position = 0;
- $this->_current = $size > 0 ? $this->getValue() : null;
- $this->_replySize = $size;
- }
- public function __destruct() {
- // when the iterator is garbage-collected (e.g. it goes out of the
- // scope of a foreach) but it has not reached its end, we must sync
- // the client with the queued elements that have not been read from
- // the connection with the server.
- $this->sync();
- }
- public function sync($drop = false) {
- if ($drop == true) {
- if ($this->valid()) {
- $this->_position = $this->_replySize;
- $this->_connection->disconnect();
- }
- }
- else {
- while ($this->valid()) {
- $this->next();
- }
- }
- }
- protected function getValue() {
- return $this->_reader->read($this->_connection);
- }
- }
- class Predis_Shared_MultiBulkResponseKVIterator extends Predis_Shared_MultiBulkResponseIteratorBase {
- private $_iterator;
- public function __construct(Predis_Shared_MultiBulkResponseIterator $iterator) {
- $virtualSize = count($iterator) / 2;
- $this->_iterator = $iterator;
- $this->_position = 0;
- $this->_current = $virtualSize > 0 ? $this->getValue() : null;
- $this->_replySize = $virtualSize;
- }
- public function __destruct() {
- $this->_iterator->sync();
- }
- protected function getValue() {
- $k = $this->_iterator->current();
- $this->_iterator->next();
- $v = $this->_iterator->current();
- $this->_iterator->next();
- return array($k, $v);
- }
- }
- /* ------------------------------------------------------------------------- */
- /* miscellaneous commands */
- class Predis_Commands_Ping extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'PING'; }
- public function parseResponse($data) {
- return $data === 'PONG' ? true : false;
- }
- }
- class Predis_Commands_DoEcho extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'ECHO'; }
- }
- class Predis_Commands_Auth extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'AUTH'; }
- }
- /* connection handling */
- class Predis_Commands_Quit extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'QUIT'; }
- public function closesConnection() { return true; }
- }
- /* commands operating on string values */
- class Predis_Commands_Set extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SET'; }
- }
- class Predis_Commands_SetExpire extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SETEX'; }
- }
- class Predis_Commands_SetPreserve extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SETNX'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_SetMultiple extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'MSET'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 1 && is_array($arguments[0])) {
- $flattenedKVs = array();
- $args = &$arguments[0];
- foreach ($args as $k => $v) {
- $flattenedKVs[] = $k;
- $flattenedKVs[] = $v;
- }
- return $flattenedKVs;
- }
- return $arguments;
- }
- }
- class Predis_Commands_SetMultiplePreserve extends Predis_Commands_SetMultiple {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'MSETNX'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_Get extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'GET'; }
- }
- class Predis_Commands_GetMultiple extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'MGET'; }
- }
- class Predis_Commands_GetSet extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'GETSET'; }
- }
- class Predis_Commands_Increment extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'INCR'; }
- }
- class Predis_Commands_IncrementBy extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'INCRBY'; }
- }
- class Predis_Commands_Decrement extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'DECR'; }
- }
- class Predis_Commands_DecrementBy extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'DECRBY'; }
- }
- class Predis_Commands_Exists extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'EXISTS'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_Delete extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'DEL'; }
- }
- class Predis_Commands_Type extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'TYPE'; }
- }
- class Predis_Commands_Append extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'APPEND'; }
- }
- class Predis_Commands_Substr extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SUBSTR'; }
- }
- class Predis_Commands_Strlen extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'STRLEN'; }
- }
- /* commands operating on the key space */
- class Predis_Commands_Keys extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'KEYS'; }
- public function parseResponse($data) {
- // TODO: is this behaviour correct?
- if (is_array($data) || $data instanceof Iterator) {
- return $data;
- }
- return strlen($data) > 0 ? explode(' ', $data) : array();
- }
- }
- class Predis_Commands_RandomKey extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'RANDOMKEY'; }
- public function parseResponse($data) { return $data !== '' ? $data : null; }
- }
- class Predis_Commands_Rename extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'RENAME'; }
- }
- class Predis_Commands_RenamePreserve extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'RENAMENX'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_Expire extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'EXPIRE'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_ExpireAt extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'EXPIREAT'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_Persist extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'PERSIST'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_DatabaseSize extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'DBSIZE'; }
- }
- class Predis_Commands_TimeToLive extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'TTL'; }
- }
- /* commands operating on lists */
- class Predis_Commands_ListPushTail extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'RPUSH'; }
- }
- class Predis_Commands_ListPushTailX extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'RPUSHX'; }
- }
- class Predis_Commands_ListPushHead extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LPUSH'; }
- }
- class Predis_Commands_ListPushHeadX extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LPUSHX'; }
- }
- class Predis_Commands_ListLength extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LLEN'; }
- }
- class Predis_Commands_ListRange extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LRANGE'; }
- }
- class Predis_Commands_ListTrim extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LTRIM'; }
- }
- class Predis_Commands_ListIndex extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LINDEX'; }
- }
- class Predis_Commands_ListSet extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LSET'; }
- }
- class Predis_Commands_ListRemove extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LREM'; }
- }
- class Predis_Commands_ListPopLastPushHead extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'RPOPLPUSH'; }
- }
- class Predis_Commands_ListPopLastPushHeadBulk extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'RPOPLPUSH'; }
- }
- class Predis_Commands_ListPopFirst extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LPOP'; }
- }
- class Predis_Commands_ListPopLast extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'RPOP'; }
- }
- class Predis_Commands_ListPopFirstBlocking extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'BLPOP'; }
- }
- class Predis_Commands_ListPopLastBlocking extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'BRPOP'; }
- }
- class Predis_Commands_ListInsert extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'LINSERT'; }
- }
- /* commands operating on sets */
- class Predis_Commands_SetAdd extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SADD'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_SetRemove extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SREM'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_SetPop extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SPOP'; }
- }
- class Predis_Commands_SetMove extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SMOVE'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_SetCardinality extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SCARD'; }
- }
- class Predis_Commands_SetIsMember extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SISMEMBER'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_SetIntersection extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SINTER'; }
- }
- class Predis_Commands_SetIntersectionStore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SINTERSTORE'; }
- }
- class Predis_Commands_SetUnion extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SUNION'; }
- }
- class Predis_Commands_SetUnionStore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SUNIONSTORE'; }
- }
- class Predis_Commands_SetDifference extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SDIFF'; }
- }
- class Predis_Commands_SetDifferenceStore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SDIFFSTORE'; }
- }
- class Predis_Commands_SetMembers extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SMEMBERS'; }
- }
- class Predis_Commands_SetRandomMember extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SRANDMEMBER'; }
- }
- /* commands operating on sorted sets */
- class Predis_Commands_ZSetAdd extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZADD'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_ZSetIncrementBy extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZINCRBY'; }
- }
- class Predis_Commands_ZSetRemove extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZREM'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_ZSetUnionStore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZUNIONSTORE'; }
- public function filterArguments(Array $arguments) {
- $options = array();
- $argc = count($arguments);
- if ($argc > 1 && is_array($arguments[$argc - 1])) {
- $options = $this->prepareOptions(array_pop($arguments));
- }
- $args = is_array($arguments[0]) ? $arguments[0] : $arguments;
- return array_merge($args, $options);
- }
- private function prepareOptions($options) {
- $opts = array_change_key_case($options, CASE_UPPER);
- $finalizedOpts = array();
- if (isset($opts['WEIGHTS']) && is_array($opts['WEIGHTS'])) {
- $finalizedOpts[] = 'WEIGHTS';
- foreach ($opts['WEIGHTS'] as $weight) {
- $finalizedOpts[] = $weight;
- }
- }
- if (isset($opts['AGGREGATE'])) {
- $finalizedOpts[] = 'AGGREGATE';
- $finalizedOpts[] = $opts['AGGREGATE'];
- }
- return $finalizedOpts;
- }
- }
- class Predis_Commands_ZSetIntersectionStore extends Predis_Commands_ZSetUnionStore {
- public function getCommandId() { return 'ZINTERSTORE'; }
- }
- class Predis_Commands_ZSetRange extends Predis_MultiBulkCommand {
- private $_withScores = false;
- public function getCommandId() { return 'ZRANGE'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 4) {
- $lastType = gettype($arguments[3]);
- if ($lastType === 'string' && strtolower($arguments[3]) === 'withscores') {
- // used for compatibility with older versions
- $arguments[3] = array('WITHSCORES' => true);
- $lastType = 'array';
- }
- if ($lastType === 'array') {
- $options = $this->prepareOptions(array_pop($arguments));
- return array_merge($arguments, $options);
- }
- }
- return $arguments;
- }
- protected function prepareOptions($options) {
- $opts = array_change_key_case($options, CASE_UPPER);
- $finalizedOpts = array();
- if (isset($opts['WITHSCORES'])) {
- $finalizedOpts[] = 'WITHSCORES';
- $this->_withScores = true;
- }
- return $finalizedOpts;
- }
- public function parseResponse($data) {
- if ($this->_withScores) {
- if ($data instanceof Iterator) {
- return new Predis_Shared_MultiBulkResponseKVIterator($data);
- }
- $result = array();
- for ($i = 0; $i < count($data); $i++) {
- $result[] = array($data[$i], $data[++$i]);
- }
- return $result;
- }
- return $data;
- }
- }
- class Predis_Commands_ZSetReverseRange extends Predis_Commands_ZSetRange {
- public function getCommandId() { return 'ZREVRANGE'; }
- }
- class Predis_Commands_ZSetRangeByScore extends Predis_Commands_ZSetRange {
- public function getCommandId() { return 'ZRANGEBYSCORE'; }
- protected function prepareOptions($options) {
- $opts = array_change_key_case($options, CASE_UPPER);
- $finalizedOpts = array();
- if (isset($opts['LIMIT']) && is_array($opts['LIMIT'])) {
- $limit = array_change_key_case($opts['LIMIT'], CASE_UPPER);
- $finalizedOpts[] = 'LIMIT';
- $finalizedOpts[] = isset($limit['OFFSET']) ? $limit['OFFSET'] : $limit[0];
- $finalizedOpts[] = isset($limit['COUNT']) ? $limit['COUNT'] : $limit[1];
- }
- return array_merge($finalizedOpts, parent::prepareOptions($options));
- }
- }
- class Predis_Commands_ZSetReverseRangeByScore extends Predis_Commands_ZSetRangeByScore {
- public function getCommandId() { return 'ZREVRANGEBYSCORE'; }
- }
- class Predis_Commands_ZSetCount extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZCOUNT'; }
- }
- class Predis_Commands_ZSetCardinality extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZCARD'; }
- }
- class Predis_Commands_ZSetScore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZSCORE'; }
- }
- class Predis_Commands_ZSetRemoveRangeByScore extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZREMRANGEBYSCORE'; }
- }
- class Predis_Commands_ZSetRank extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZRANK'; }
- }
- class Predis_Commands_ZSetReverseRank extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZREVRANK'; }
- }
- class Predis_Commands_ZSetRemoveRangeByRank extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'ZREMRANGEBYRANK'; }
- }
- /* commands operating on hashes */
- class Predis_Commands_HashSet extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HSET'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_HashSetPreserve extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HSETNX'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_HashSetMultiple extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HMSET'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 2 && is_array($arguments[1])) {
- $flattenedKVs = array($arguments[0]);
- $args = &$arguments[1];
- foreach ($args as $k => $v) {
- $flattenedKVs[] = $k;
- $flattenedKVs[] = $v;
- }
- return $flattenedKVs;
- }
- return $arguments;
- }
- }
- class Predis_Commands_HashIncrementBy extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HINCRBY'; }
- }
- class Predis_Commands_HashGet extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HGET'; }
- }
- class Predis_Commands_HashGetMultiple extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HMGET'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 2 && is_array($arguments[1])) {
- $flattenedKVs = array($arguments[0]);
- $args = &$arguments[1];
- foreach ($args as $v) {
- $flattenedKVs[] = $v;
- }
- return $flattenedKVs;
- }
- return $arguments;
- }
- }
- class Predis_Commands_HashDelete extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HDEL'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_HashExists extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HEXISTS'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_HashLength extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HLEN'; }
- }
- class Predis_Commands_HashKeys extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HKEYS'; }
- }
- class Predis_Commands_HashValues extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HVALS'; }
- }
- class Predis_Commands_HashGetAll extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'HGETALL'; }
- public function parseResponse($data) {
- if ($data instanceof Iterator) {
- return new Predis_Shared_MultiBulkResponseKVIterator($data);
- }
- $result = array();
- for ($i = 0; $i < count($data); $i++) {
- $result[$data[$i]] = $data[++$i];
- }
- return $result;
- }
- }
- /* multiple databases handling commands */
- class Predis_Commands_SelectDatabase extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SELECT'; }
- }
- class Predis_Commands_MoveKey extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'MOVE'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_FlushDatabase extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'FLUSHDB'; }
- }
- class Predis_Commands_FlushAll extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'FLUSHALL'; }
- }
- /* sorting */
- class Predis_Commands_Sort extends Predis_MultiBulkCommand {
- public function getCommandId() { return 'SORT'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 1) {
- return $arguments;
- }
- $query = array($arguments[0]);
- $sortParams = array_change_key_case($arguments[1], CASE_UPPER);
- if (isset($sortParams['BY'])) {
- $query[] = 'BY';
- $query[] = $sortParams['BY'];
- }
- if (isset($sortParams['GET'])) {
- $getargs = $sortParams['GET'];
- if (is_array($getargs)) {
- foreach ($getargs as $getarg) {
- $query[] = 'GET';
- $query[] = $getarg;
- }
- }
- else {
- $query[] = 'GET';
- $query[] = $getargs;
- }
- }
- if (isset($sortParams['LIMIT']) && is_array($sortParams['LIMIT'])
- && count($sortParams['LIMIT']) == 2) {
- $query[] = 'LIMIT';
- $query[] = $sortParams['LIMIT'][0];
- $query[] = $sortParams['LIMIT'][1];
- }
- if (isset($sortParams['SORT'])) {
- $query[] = strtoupper($sortParams['SORT']);
- }
- if (isset($sortParams['ALPHA']) && $sortParams['ALPHA'] == true) {
- $query[] = 'ALPHA';
- }
- if (isset($sortParams['STORE'])) {
- $query[] = 'STORE';
- $query[] = $sortParams['STORE'];
- }
- return $query;
- }
- }
- /* transactions */
- class Predis_Commands_Multi extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'MULTI'; }
- }
- class Predis_Commands_Exec extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'EXEC'; }
- }
- class Predis_Commands_Discard extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'DISCARD'; }
- }
- /* publish/subscribe */
- class Predis_Commands_Subscribe extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SUBSCRIBE'; }
- }
- class Predis_Commands_Unsubscribe extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'UNSUBSCRIBE'; }
- }
- class Predis_Commands_SubscribeByPattern extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'PSUBSCRIBE'; }
- }
- class Predis_Commands_UnsubscribeByPattern extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'PUNSUBSCRIBE'; }
- }
- class Predis_Commands_Publish extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'PUBLISH'; }
- }
- class Predis_Commands_Watch extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'WATCH'; }
- public function filterArguments(Array $arguments) {
- if (isset($arguments[0]) && is_array($arguments[0])) {
- return $arguments[0];
- }
- return $arguments;
- }
- public function parseResponse($data) { return (bool) $data; }
- }
- class Predis_Commands_Unwatch extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'UNWATCH'; }
- public function parseResponse($data) { return (bool) $data; }
- }
- /* persistence control commands */
- class Predis_Commands_Save extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SAVE'; }
- }
- class Predis_Commands_BackgroundSave extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'BGSAVE'; }
- public function parseResponse($data) {
- if ($data == 'Background saving started') {
- return true;
- }
- return $data;
- }
- }
- class Predis_Commands_BackgroundRewriteAppendOnlyFile extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'BGREWRITEAOF'; }
- public function parseResponse($data) {
- return $data == 'Background append only file rewriting started';
- }
- }
- class Predis_Commands_LastSave extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'LASTSAVE'; }
- }
- class Predis_Commands_Shutdown extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SHUTDOWN'; }
- public function closesConnection() { return true; }
- }
- /* remote server control commands */
- class Predis_Commands_Info extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'INFO'; }
- public function parseResponse($data) {
- $info = array();
- $infoLines = explode("\r\n", $data, -1);
- foreach ($infoLines as $row) {
- list($k, $v) = explode(':', $row);
- if (!preg_match('/^db\d+$/', $k)) {
- $info[$k] = $v;
- }
- else {
- $db = array();
- foreach (explode(',', $v) as $dbvar) {
- list($dbvk, $dbvv) = explode('=', $dbvar);
- $db[trim($dbvk)] = $dbvv;
- }
- $info[$k] = $db;
- }
- }
- return $info;
- }
- }
- class Predis_Commands_SlaveOf extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'SLAVEOF'; }
- public function filterArguments(Array $arguments) {
- if (count($arguments) === 0 || $arguments[0] === 'NO ONE') {
- return array('NO', 'ONE');
- }
- return $arguments;
- }
- }
- class Predis_Commands_Config extends Predis_MultiBulkCommand {
- public function canBeHashed() { return false; }
- public function getCommandId() { return 'CONFIG'; }
- }
- ?>
|