* (bug 12506) Allow URL parameter 'section' in Special:Mypage/Mytalk. Patch by Eneas.
[lhc/web/wiklou.git] / includes / BagOStuff.php
index 7b7aaab..226abb3 100644 (file)
  * the PHP memcached client.
  *
  * backends for local hash array and SQL table included:
- * $bag = new HashBagOStuff();
- * $bag = new MysqlBagOStuff($tablename); # connect to db first
+ * <code>
+ *   $bag = new HashBagOStuff();
+ *   $bag = new MysqlBagOStuff($tablename); # connect to db first
+ * </code>
  *
  */
 class BagOStuff {
@@ -71,6 +73,11 @@ class BagOStuff {
                return true;
        }
 
+       function keys() {
+               /* stub */
+               return array();
+       }
+
        /* *** Emulated functions *** */
        /* Better performance can likely be got with custom written versions */
        function get_multi($keys) {
@@ -170,7 +177,7 @@ class HashBagOStuff extends BagOStuff {
        */
        var $bag;
 
-       function HashBagOStuff() {
+       function __construct() {
                $this->bag = array();
        }
 
@@ -200,6 +207,10 @@ class HashBagOStuff extends BagOStuff {
                unset($this->bag[$key]);
                return true;
        }
+
+       function keys() {
+               return array_keys( $this->bag );
+       }
 }
 
 /*
@@ -220,7 +231,7 @@ abstract class SqlBagOStuff extends BagOStuff {
        var $table;
        var $lastexpireall = 0;
 
-       function SqlBagOStuff($tablename = 'objectcache') {
+       function __construct($tablename = 'objectcache') {
                $this->table = $tablename;
        }
 
@@ -251,6 +262,9 @@ abstract class SqlBagOStuff extends BagOStuff {
        }
 
        function set($key,$value,$exptime=0) {
+               if ( wfReadOnly() ) {
+                       return false;
+               }
                $exptime = intval($exptime);
                if($exptime < 0) $exptime = 0;
                if($exptime == 0) {
@@ -270,11 +284,27 @@ abstract class SqlBagOStuff extends BagOStuff {
        }
 
        function delete($key,$time=0) {
+               if ( wfReadOnly() ) {
+                       return false;
+               }
                $this->_query(
                        "DELETE FROM $0 WHERE keyname='$1'", $key );
                return true; /* ? */
        }
 
+       function keys() {
+               $res = $this->_query( "SELECT keyname FROM $0" );
+               if(!$res) {
+                       $this->_debug("keys: ** error: " . $this->_dberror($res) . " **");
+                       return array();
+               }
+               $result = array();
+               while( $row = $this->_fetchobject($res) ) {
+                       $result[] = $row->keyname;
+               }
+               return $result;
+       }
+
        function getTableName() {
                return $this->table;
        }
@@ -337,12 +367,18 @@ abstract class SqlBagOStuff extends BagOStuff {
 
        function expireall() {
                /* Remove any items that have expired */
+               if ( wfReadOnly() ) {
+                       return false;
+               }
                $now = $this->_fromunixtime( time() );
                $this->_query( "DELETE FROM $0 WHERE exptime < '$now'" );
        }
 
        function deleteall() {
                /* Clear *all* items from cache table */
+               if ( wfReadOnly() ) {
+                       return false;
+               }
                $this->_query( "DELETE FROM $0" );
        }
 
@@ -492,7 +528,6 @@ class TurckBagOStuff extends BagOStuff {
  * This is a wrapper for APC's shared memory functions
  *
  */
-
 class APCBagOStuff extends BagOStuff {
        function get($key) {
                $val = apc_fetch($key);
@@ -551,6 +586,55 @@ class eAccelBagOStuff extends BagOStuff {
        }
 }
 
+/**
+ * Wrapper for XCache object caching functions; identical interface
+ * to the APC wrapper
+ */
+class XCacheBagOStuff extends BagOStuff {
+
+       /**
+        * Get a value from the XCache object cache
+        *
+        * @param string $key Cache key
+        * @return mixed
+        */
+       public function get( $key ) {
+               $val = xcache_get( $key );
+               if( is_string( $val ) )
+                       $val = unserialize( $val );
+               return $val;
+       }
+       
+       /**
+        * Store a value in the XCache object cache
+        *
+        * @param string $key Cache key
+        * @param mixed $value Object to store
+        * @param int $expire Expiration time
+        * @return bool
+        */
+       public function set( $key, $value, $expire = 0 ) {
+               xcache_set( $key, serialize( $value ), $expire );
+               return true;
+       }
+       
+       /**
+        * Remove a value from the XCache object cache
+        *
+        * @param string $key Cache key
+        * @param int $time Not used in this implementation
+        * @return bool
+        */
+       public function delete( $key, $time = 0 ) {
+               xcache_unset( $key );
+               return true;
+       }
+       
+}
+
+/**
+ * @todo document
+ */
 class DBABagOStuff extends BagOStuff {
        var $mHandler, $mFile, $mReader, $mWriter, $mDisabled;
        
@@ -647,6 +731,7 @@ class DBABagOStuff extends BagOStuff {
 
        function delete( $key, $time = 0 ) {
                wfProfileIn( __METHOD__ );
+               wfDebug( __METHOD__."($key)\n" );
                $handle = $this->getWriter();
                if ( !$handle ) {
                        return false;
@@ -680,6 +765,19 @@ class DBABagOStuff extends BagOStuff {
                wfProfileOut( __METHOD__ );
                return $ret;
        }
+
+       function keys() {
+               $reader = $this->getReader();
+               $k1 = dba_firstkey( $reader );
+               if( !$k1 ) {
+                       return array();
+               }
+               $result[] = $k1;
+               while( $key = dba_nextkey( $reader ) ) {
+                       $result[] = $key;
+               }
+               return $result;
+       }
 }
        
-?>
+