wikimedia/mediawiki-extensions-Translate

<?php
declare( strict_types = 1 );

namespace MediaWiki\Extension\Translate\MessageLoading;

/**
 * @since 2024.05
 * @license GPL-2.0-or-later
 * @author Niklas Laxström
 */
abstract class MessageIndexStore {
    abstract public function retrieve( bool $readLatest = false ): array;

    public function get( string $key ) {
        // Default implementation
        $mi = $this->retrieve();
        return $mi[$key] ?? null;
    }

    abstract public function store( array $array, array $diff ): void;

    /** @return string[] */
    public function getKeys(): array {
        return array_keys( $this->retrieve() );
    }

    /**
     * These are probably slower than serialize and unserialize,
     * but they are more space efficient because we only need
     * strings and arrays.
     * @param mixed $data
     * @return mixed
     */
    protected function serialize( $data ) {
        return is_array( $data ) ? implode( '|', $data ) : $data;
    }

    protected function unserialize( $data ) {
        $array = explode( '|', $data );
        return count( $array ) > 1 ? $array : $data;
    }
}