*
* Represents files in a repository.
*/
+use Wikimedia\AtEase\AtEase;
use MediaWiki\MediaWikiServices;
/**
*
* RepoGroup::singleton()->getLocalRepo()->newFile( $title );
*
- * The convenience functions wfLocalFile() and wfFindFile() should be sufficient
- * in most cases.
+ * Consider the services container below;
+ *
+ * $services = MediaWikiServices::getInstance();
+ *
+ * The convenience services $services->getRepoGroup()->getLocalRepo()->newFile()
+ * and $services->getRepoGroup()->findFile() should be sufficient in most cases.
+ *
+ * @TODO: DI - Instead of using MediaWikiServices::getInstance(), a service should
+ * ideally accept a RepoGroup in its constructor and then, use $this->repoGroup->findFile()
+ * and $this->repoGroup->getLocalRepo()->newFile().
*
* @ingroup FileAbstraction
*/
* @param array $versions Set of record ids of deleted items to restore,
* or empty to restore all revisions.
* @param bool $unsuppress Remove restrictions on content upon restoration?
- * @return int|bool The number of file revisions restored if successful,
- * or false on failure
+ * @return Status
* STUB
* Overridden by LocalFile
*/
$metadata = $this->getMetadata();
if ( is_string( $metadata ) ) {
- $metadata = Wikimedia\quietCall( 'unserialize', $metadata );
+ $metadata = AtEase::quietCall( 'unserialize', $metadata );
}
if ( !is_array( $metadata ) ) {