You are here

interface ShellManagerInterface in FillPDF 8.4

Same name and namespace in other branches
  1. 5.0.x src/ShellManagerInterface.php \Drupal\fillpdf\ShellManagerInterface

Provides an interface for FillPDF execution manager.

@internal

Hierarchy

Expanded class hierarchy of ShellManagerInterface

All classes that implement ShellManagerInterface

File

src/ShellManagerInterface.php, line 10

Namespace

Drupal\fillpdf
View source
interface ShellManagerInterface {

  /**
   * Replacement for percentage while escaping.
   */
  const PERCENTAGE_REPLACE = 'PERCENTSIGN';

  /**
   * Whether we are running on Windows OS.
   *
   * @return bool
   *   TRUE if we're running on Windows, otherwise FALSE.
   */
  public function isWindows();

  /**
   * Gets the list of locales installed on the server.
   *
   * @return string[]
   *   Associative array of installed locales as returned by 'locale -a' on *nix
   *   systems, keyed by itself. Will return an empty array on Windows servers.
   */
  public function getInstalledLocales();

  /**
   * Escapes a string.
   *
   * PHP escapeshellarg() drops non-ascii characters, this is a replacement.
   *
   * Stop-gap replacement until core issue #1561214 has been solved. Solution
   * proposed in #1502924-8.
   *
   * PHP escapeshellarg() on Windows also drops % (percentage sign) characters.
   * We prevent this by replacing it with a pattern that should be highly
   * unlikely to appear in the string itself and does not contain any
   * "dangerous" character at all (very wide definition of dangerous). After
   * escaping we replace that pattern back with a % character.
   *
   * @param string $arg
   *   The string to escape.
   *
   * @return string
   *   Escaped string.
   *
   * @see https://www.drupal.org/project/drupal/issues/1561214
   */
  public function escapeShellArg($arg);

}

Members

Namesort descending Modifiers Type Description Overrides
ShellManagerInterface::escapeShellArg public function Escapes a string. 1
ShellManagerInterface::getInstalledLocales public function Gets the list of locales installed on the server. 1
ShellManagerInterface::isWindows public function Whether we are running on Windows OS. 1
ShellManagerInterface::PERCENTAGE_REPLACE constant Replacement for percentage while escaping.