ArchiverInterface.php

<?php

namespace Drupal\Core\Archiver;


/**
 * Defines the common interface for all Archiver classes.
 *
 * @see \Drupal\Core\Archiver\ArchiverManager
 * @see \Drupal\Core\Archiver\Attribute\Archiver
 * @see plugin_api
 */
interface ArchiverInterface {
    
    /**
     * Adds the specified file or directory to the archive.
     *
     * @param string $file_path
     *   The full system path of the file or directory to add. Only local files
     *   and directories are supported.
     *
     * @return $this
     *   The called object.
     */
    public function add($file_path);
    
    /**
     * Removes the specified file from the archive.
     *
     * @param string $path
     *   The file name relative to the root of the archive to remove.
     *
     * @return $this
     *   The called object.
     */
    public function remove($path);
    
    /**
     * Extracts multiple files in the archive to the specified path.
     *
     * @param string $path
     *   A full system path of the directory to which to extract files.
     * @param array $files
     *   Optionally specify a list of files to be extracted. Files are
     *   relative to the root of the archive. If not specified, all files
     *   in the archive will be extracted.
     *
     * @return $this
     *   The called object.
     */
    public function extract($path, array $files = []);
    
    /**
     * Lists all files in the archive.
     *
     * @return array
     *   An array of file names relative to the root of the archive.
     */
    public function listContents();

}