class Path

1. 9.x drupal/core/lib/Drupal/Core/Path/Path.php \Drupal\Core\Path\Path
2. 9.x drupal/core/modules/node/lib/Drupal/node/Plugin/views/field/Path.php \Drupal\node\Plugin\views\field\Path

AliasTest.php in drupal/core/modules/system/lib/Drupal/system/Tests/Path/AliasTest.php

Definition of Drupal\system\Tests\Path\CrudTest.

ExecutableFinder::find in drupal/core/vendor/symfony/process/Symfony/Component/Process/ExecutableFinder.php

Finds an executable by name.

file_views_data in drupal/core/modules/file/file.views.inc

Implements hook_views_data().

menu_edit_item in drupal/core/modules/menu/menu.admin.inc

Menu callback; Build the menu link editing form.

node_views_data in drupal/core/modules/node/node.views.inc

Implements hook_views_data().

PathAliasTest::getInfo in drupal/core/modules/path/lib/Drupal/path/Tests/PathAliasTest.php

... See full list

class Path {

  /**
   * The database connection.
   *
   * @var \Drupal\Core\Database\Connection
   */
  protected $connection;

  /**
   * Constructs a Path CRUD object.
   *
   * @param \Drupal\Core\Database\Connection $connection
   *   A database connection for reading and writing path aliases.
   *
   * @param \Drupal\Core\Path\AliasManager $alias_manager
   *   An alias manager with an internal cache of stored aliases.
   *
   * @todo This class should not take an alias manager in its constructor. Once
   *   we move to firing an event for CRUD operations instead of invoking a
   *   hook, we can have a listener that calls cacheClear() on the alias manager.
   */
  public function __construct(Connection $connection, AliasManager $alias_manager) {
    $this->connection = $connection;
    $this->alias_manager = $alias_manager;
  }

  /**
   * Saves a path alias to the database.
   *
   * @param string $source
   *   The internal system path.
   *
   * @param string $alias
   *   The URL alias.
   *
   * @param string $langcode
   *   The language code of the alias.
   *
   * @param int $pid
   *   Unique path alias identifier.
   *
   * @return
   *   FALSE if the path could not be saved or an associative array containing
   *   the following keys:
   *   - source: The internal system path.
   *   - alias: The URL alias.
   *   - pid: Unique path alias identifier.
   *   - langcode: The language code of the alias.
   */
  public function save($source, $alias, $langcode = LANGUAGE_NOT_SPECIFIED, $pid = NULL) {
    $fields = array(
      'source' => $source,
      'alias' => $alias,
      'langcode' => $langcode,
    );

    // Insert or update the alias.
    if (empty($pid)) {
      $query = $this->connection
        ->insert('url_alias')
        ->fields($fields);
      $pid = $query
        ->execute();
      $fields['pid'] = $pid;

      // @todo: Find a correct place to invoke hook_path_insert().
      $hook = 'path_insert';
    }
    else {
      $fields['pid'] = $pid;
      $query = $this->connection
        ->update('url_alias')
        ->fields($fields)
        ->condition('pid', $pid);
      $pid = $query
        ->execute();

      // @todo: figure out where we can invoke hook_path_update()
      $hook = 'path_update';
    }
    if ($pid) {

      // @todo Switch to using an event for this instead of a hook.
      module_invoke_all($hook, $fields);
      $this->alias_manager
        ->cacheClear();
      return $fields;
    }
    return FALSE;
  }

  /**
   * Fetches a specific URL alias from the database.
   *
   * @param $conditions
   *   An array of query conditions.
   *
   * @return
   *   FALSE if no alias was found or an associative array containing the
   *   following keys:
   *   - source: The internal system path.
   *   - alias: The URL alias.
   *   - pid: Unique path alias identifier.
   *   - langcode: The language code of the alias.
   */
  public function load($conditions) {
    $select = $this->connection
      ->select('url_alias');
    foreach ($conditions as $field => $value) {
      $select
        ->condition($field, $value);
    }
    return $select
      ->fields('url_alias')
      ->execute()
      ->fetchAssoc();
  }

  /**
   * Deletes a URL alias.
   *
   * @param array $conditions
   *   An array of criteria.
   */
  public function delete($conditions) {
    $path = $this
      ->load($conditions);
    $query = $this->connection
      ->delete('url_alias');
    foreach ($conditions as $field => $value) {
      $query
        ->condition($field, $value);
    }
    $deleted = $query
      ->execute();

    // @todo Switch to using an event for this instead of a hook.
    module_invoke_all('path_delete', $path);
    $this->alias_manager
      ->cacheClear();
    return $deleted;
  }

}