interface PhpStorageInterface

Same name in other branches
  1. 9 core/lib/Drupal/Component/PhpStorage/PhpStorageInterface.php \Drupal\Component\PhpStorage\PhpStorageInterface
  2. 8.9.x core/lib/Drupal/Component/PhpStorage/PhpStorageInterface.php \Drupal\Component\PhpStorage\PhpStorageInterface
  3. 11.x core/lib/Drupal/Component/PhpStorage/PhpStorageInterface.php \Drupal\Component\PhpStorage\PhpStorageInterface

Stores and loads PHP code.

Each interface function takes $name as a parameter. This is a virtual file name: for example, 'foo.php' or 'some/relative/path/to/foo.php'. The storage implementation may store these as files within the local file system, use a remote stream, combine multiple virtual files into an archive, store them in database records, or use some other storage technique.

Hierarchy

Expanded class hierarchy of PhpStorageInterface

All classes that implement PhpStorageInterface

2 files declare their use of PhpStorageInterface
PhpBackend.php in core/lib/Drupal/Core/Cache/PhpBackend.php
PhpStorageTestBase.php in core/tests/Drupal/Tests/Component/PhpStorage/PhpStorageTestBase.php

File

core/lib/Drupal/Component/PhpStorage/PhpStorageInterface.php, line 14

Namespace

Drupal\Component\PhpStorage
View source 
interface PhpStorageInterface {
    
    /**
     * Checks whether the PHP code exists in storage.
     *
     * @param string $name
     *   The virtual file name. Can be a relative path.
     *
     * @return bool
     *   TRUE if the virtual file exists, FALSE otherwise.
     */
    public function exists($name);
    
    /**
     * Loads PHP code from storage.
     *
     * Depending on storage implementation, exists() checks can be expensive, so
     * this function may be called for a file that doesn't exist, and that should
     * not result in errors. This function does not return anything, so it is
     * up to the caller to determine if any code was loaded (for example, check
     * class_exists() or function_exists() for what was expected in the code).
     *
     * @param string $name
     *   The virtual file name. Can be a relative path.
     */
    public function load($name);
    
    /**
     * Saves PHP code to storage.
     *
     * @param string $name
     *   The virtual file name. Can be a relative path.
     * @param string $code
     *   The PHP code to be saved.
     *
     * @return bool
     *   TRUE if the save succeeded, FALSE if it failed.
     */
    public function save($name, $code);
    
    /**
     * Whether this is a writable storage.
     *
     * @return bool
     *   TRUE if writable, otherwise FALSE.
     *
     * @deprecated in drupal:10.1.0 and is removed from drupal:11.0.0. There is no
     *   replacement.
     *
     * @see https://www.drupal.org/node/3155413
     */
    public function writeable();
    
    /**
     * Deletes PHP code from storage.
     *
     * @param string $name
     *   The virtual file name. Can be a relative path.
     *
     * @return bool
     *   TRUE if the delete succeeded, FALSE if it failed.
     */
    public function delete($name);
    
    /**
     * Removes all files in this bin.
     */
    public function deleteAll();
    
    /**
     * Gets the full file path.
     *
     * @param string $name
     *   The virtual file name. Can be a relative path.
     *
     * @return string|false
     *   The full file path for the provided name. Return FALSE if the
     *   implementation needs to prevent access to the file.
     */
    public function getFullPath($name);
    
    /**
     * Lists all the files in the storage.
     *
     * @return array
     *   Array of filenames.
     */
    public function listAll();
    
    /**
     * Performs garbage collection on the storage.
     *
     * The storage may choose to delete expired or invalidated items.
     */
    public function garbageCollection();

}

Members

Title Deprecated Modifiers Object type Summary Overrides
PhpStorageInterface::delete public function Deletes PHP code from storage. 2
PhpStorageInterface::deleteAll public function Removes all files in this bin. 2
PhpStorageInterface::exists public function Checks whether the PHP code exists in storage. 2
PhpStorageInterface::garbageCollection public function Performs garbage collection on the storage. 2
PhpStorageInterface::getFullPath public function Gets the full file path. 2
PhpStorageInterface::listAll public function Lists all the files in the storage. 2
PhpStorageInterface::load public function Loads PHP code from storage. 2
PhpStorageInterface::save public function Saves PHP code to storage. 2
PhpStorageInterface::writeable Deprecated public function Whether this is a writable storage. 2

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.