WinCacheBagOStuff.php

Go to the documentation of this file.

<?php
class WinCacheBagOStuff extends MediumSpecificBagOStuff {
    public function __construct( array $params = [] ) {
        $params['segmentationSize'] = $params['segmentationSize'] ?? INF;
        parent::__construct( $params );
 
        if ( PHP_SAPI === 'cli' ) {
            $this->attrMap[self::ATTR_DURABILITY] = ini_get( 'wincache.enablecli' )
                ? self::QOS_DURABILITY_SCRIPT
                : self::QOS_DURABILITY_NONE;
        } else {
            $this->attrMap[self::ATTR_DURABILITY] = self::QOS_DURABILITY_SERVICE;
        }
    }
 
    protected function doGet( $key, $flags = 0, &$casToken = null ) {
        $getToken = ( $casToken === self::PASS_BY_REF );
        $casToken = null;
 
        $blob = wincache_ucache_get( $key );
        if ( !is_string( $blob ) && !is_int( $blob ) ) {
            return false;
        }
 
        $value = $this->unserialize( $blob );
        if ( $getToken && $value !== false ) {
            $casToken = (string)$blob; // don't bother hashing this
        }
 
        return $value;
    }
 
    protected function doCas( $casToken, $key, $value, $exptime = 0, $flags = 0 ) {
        if ( !wincache_lock( $key ) ) { // optimize with FIFO lock
            return false;
        }
 
        $curCasToken = self::PASS_BY_REF; // passed by reference
        $this->doGet( $key, self::READ_LATEST, $curCasToken );
        if ( $casToken === $curCasToken ) {
            $success = $this->set( $key, $value, $exptime, $flags );
        } else {
            $this->logger->info(
                __METHOD__ . ' failed due to race condition for {key}.',
                [ 'key' => $key ]
            );
 
            $success = false; // mismatched or failed
        }
 
        wincache_unlock( $key );
 
        return $success;
    }
 
    protected function doSet( $key, $value, $exptime = 0, $flags = 0 ) {
        $ttl = $this->getExpirationAsTTL( $exptime );
        $result = wincache_ucache_set( $key, $this->getSerialized( $value, $key ), $ttl );
 
        // false positive, wincache_ucache_set returns an empty array
        // in some circumstances.
        // @phan-suppress-next-line PhanTypeComparisonToArray
        return ( $result === [] || $result === true );
    }
 
    protected function doAdd( $key, $value, $exptime = 0, $flags = 0 ) {
        if ( wincache_ucache_exists( $key ) ) {
            return false; // avoid warnings
        }
 
        $ttl = $this->getExpirationAsTTL( $exptime );
        $result = wincache_ucache_add( $key, $this->getSerialized( $value, $key ), $ttl );
 
        // false positive, wincache_ucache_add returns an empty array
        // in some circumstances.
        // @phan-suppress-next-line PhanTypeComparisonToArray
        return ( $result === [] || $result === true );
    }
 
    protected function doDelete( $key, $flags = 0 ) {
        wincache_ucache_delete( $key );
 
        return true;
    }
 
    public function makeKeyInternal( $keyspace, $components ) {
        // WinCache keys have a maximum length of 150 characters. From that,
        // subtract the number of characters we need for the keyspace and for
        // the separator character needed for each argument. To handle some
        // custom prefixes used by thing like WANObjectCache, limit to 125.
        // NOTE: Same as in memcached, except the max key length there is 255.
        $charsLeft = 125 - strlen( $keyspace ) - count( $components );
 
        $components = array_map(
            static function ( $component ) use ( &$charsLeft ) {
                // 33 = 32 characters for the MD5 + 1 for the '#' prefix.
                if ( $charsLeft > 33 && strlen( $component ) > $charsLeft ) {
                    $component = '#' . md5( $component );
                }
 
                $charsLeft -= strlen( $component );
                return $component;
            },
            $components
        );
 
        if ( $charsLeft < 0 ) {
            return $keyspace . ':BagOStuff-long-key:##' . md5( implode( ':', $components ) );
        }
 
        return $keyspace . ':' . implode( ':', $components );
    }
 
    public function incr( $key, $value = 1, $flags = 0 ) {
        if ( !wincache_lock( $key ) ) { // optimize with FIFO lock
            return false;
        }
 
        $n = $this->doGet( $key );
        if ( $this->isInteger( $n ) ) {
            $n = max( $n + (int)$value, 0 );
            $oldTTL = wincache_ucache_info( false, $key )["ucache_entries"][1]["ttl_seconds"];
            $this->set( $key, $n, $oldTTL );
        } else {
            $n = false;
        }
 
        wincache_unlock( $key );
 
        return $n;
    }
 
    public function decr( $key, $value = 1, $flags = 0 ) {
        return $this->incr( $key, -$value, $flags );
    }
}