Merge "objectcache: Hard deprecate `ObjectCache::getMainWANInstance()`"
authorjenkins-bot <jenkins-bot@gerrit.wikimedia.org>
Sat, 13 Jul 2019 21:34:28 +0000 (21:34 +0000)
committerGerrit Code Review <gerrit@wikimedia.org>
Sat, 13 Jul 2019 21:34:28 +0000 (21:34 +0000)
1  2 
includes/objectcache/ObjectCache.php

@@@ -359,12 -359,25 +359,13 @@@ class ObjectCache 
         * @deprecated Since 1.28 Use MediaWikiServices::getInstance()->getMainWANObjectCache()
         */
        public static function getMainWANInstance() {
+               wfDeprecated( __METHOD__, '1.28' );
                return MediaWikiServices::getInstance()->getMainWANObjectCache();
        }
  
        /**
         * Get the cache object for the main stash.
         *
 -       * Stash objects are BagOStuff instances suitable for storing light
 -       * weight data that is not canonically stored elsewhere (such as RDBMS).
 -       * Stashes should be configured to propagate changes to all data-centers.
 -       *
 -       * Callers should be prepared for:
 -       *   - a) Writes to be slower in non-"primary" (e.g. HTTP GET/HEAD only) DCs
 -       *   - b) Reads to be eventually consistent, e.g. for get()/getMulti()
 -       * In general, this means avoiding updates on idempotent HTTP requests and
 -       * avoiding an assumption of perfect serializability (or accepting anomalies).
 -       * Reads may be eventually consistent or data might rollback as nodes flap.
 -       * Callers can use BagOStuff:READ_LATEST to see the latest available data.
 -       *
         * @return BagOStuff
         * @since 1.26
         * @deprecated Since 1.28 Use MediaWikiServices::getInstance()->getMainObjectStash()