BagOStuff.php

Go to the documentation of this file.

<?php
abstract class BagOStuff {
        private $debugMode = false;

        public function setDebug( $bool ) {
                $this->debugMode = $bool;
        }

        /* *** THE GUTS OF THE OPERATION *** */
        /* Override these with functional things in subclasses */

        abstract public function get( $key );

        abstract public function set( $key, $value, $exptime = 0 );

        abstract public function delete( $key, $time = 0 );

        public function lock( $key, $timeout = 0 ) {
                /* stub */
                return true;
        }

        public function unlock( $key ) {
                /* stub */
                return true;
        }

        public function keys() {
                /* stub */
                return array();
        }

        public function deleteObjectsExpiringBefore( $date, $progressCallback = false ) {
                // stub
                return false;
        }

        /* *** Emulated functions *** */

        public function getMulti( array $keys ) {
                $res = array();
                foreach ( $keys as $key ) {
                        $val = $this->get( $key );
                        if ( $val !== false ) {
                                $res[$key] = $val;
                        }
                }
                return $res;
        }

        public function add( $key, $value, $exptime = 0 ) {
                if ( $this->get( $key ) === false ) {
                        return $this->set( $key, $value, $exptime );
                }
                return false; // key already set
        }

        public function replace( $key, $value, $exptime = 0 ) {
                if ( $this->get( $key ) !== false ) {
                        return $this->set( $key, $value, $exptime );
                }
                return false; // key not already set
        }

        public function incr( $key, $value = 1 ) {
                if ( !$this->lock( $key ) ) {
                        return false;
                }
                $n = $this->get( $key );
                if ( $this->isInteger( $n ) ) { // key exists?
                        $n += intval( $value );
                        $this->set( $key, max( 0, $n ) ); // exptime?
                } else {
                        $n = false;
                }
                $this->unlock( $key );

                return $n;
        }

        public function decr( $key, $value = 1 ) {
                return $this->incr( $key, - $value );
        }

        public function debug( $text ) {
                if ( $this->debugMode ) {
                        $class = get_class( $this );
                        wfDebug( "$class debug: $text\n" );
                }
        }

        protected function convertExpiry( $exptime ) {
                if ( ( $exptime != 0 ) && ( $exptime < 86400 * 3650 /* 10 years */ ) ) {
                        return time() + $exptime;
                } else {
                        return $exptime;
                }
        }

        protected function convertToRelative( $exptime ) {
                if ( $exptime >= 86400 * 3650 /* 10 years */ ) {
                        $exptime -= time();
                        if ( $exptime <= 0 ) {
                                $exptime = 1;
                        }
                        return $exptime;
                } else {
                        return $exptime;
                }
        }

        protected function isInteger( $value ) {
                return ( is_int( $value ) || ctype_digit( $value ) );
        }
}