path.inc 7.56 KB
Newer Older
1
<?php
2
3
4

/**
 * @file
5
 * Functions to handle paths in Drupal.
6
7
 */

8
use Drupal\Core\Routing\RequestHelper;
9
10
use Symfony\Component\HttpFoundation\Request;

11
12
13
14
15
16
17
/**
 * Check if the current page is the front page.
 *
 * @return
 *   Boolean value: TRUE if the current page is the front page; FALSE if otherwise.
 */
function drupal_is_front_page() {
18
  // Use the advanced drupal_static() pattern, since this is called very often.
19
20
21
22
23
  static $drupal_static_fast;
  if (!isset($drupal_static_fast)) {
    $drupal_static_fast['is_front_page'] = &drupal_static(__FUNCTION__);
  }
  $is_front_page = &$drupal_static_fast['is_front_page'];
24
25

  if (!isset($is_front_page)) {
26
    $is_front_page = (current_path() == \Drupal::config('system.site')->get('page.front'));
27
28
29
  }

  return $is_front_page;
30
}
31
32
33
34
35
36
37
38
39
40
41
42
43

/**
 * Check if a path matches any pattern in a set of patterns.
 *
 * @param $path
 *   The path to match.
 * @param $patterns
 *   String containing a set of patterns separated by \n, \r or \r\n.
 *
 * @return
 *   Boolean value: TRUE if the path matches a pattern, FALSE otherwise.
 */
function drupal_match_path($path, $patterns) {
44
  $regexps = &drupal_static(__FUNCTION__);
45

46
  if (!isset($regexps[$patterns])) {
47
48
49
50
51
52
53
54
55
56
    // Convert path settings to a regular expression.
    // Therefore replace newlines with a logical or, /* with asterisks and the <front> with the frontpage.
    $to_replace = array(
      '/(\r\n?|\n)/', // newlines
      '/\\\\\*/',     // asterisks
      '/(^|\|)\\\\<front\\\\>($|\|)/' // <front>
    );
    $replacements = array(
      '|',
      '.*',
57
      '\1' . preg_quote(\Drupal::config('system.site')->get('page.front'), '/') . '\2'
58
59
60
    );
    $patterns_quoted = preg_quote($patterns, '/');
    $regexps[$patterns] = '/^(' . preg_replace($to_replace, $replacements, $patterns_quoted) . ')$/';
61
  }
62
  return (bool)preg_match($regexps[$patterns], $path);
63
}
64
65
66
67
68
69
70
71
72
73
74

/**
 * Return the current URL path of the page being viewed.
 *
 * Examples:
 * - http://example.com/node/306 returns "node/306".
 * - http://example.com/drupalfolder/node/306 returns "node/306" while
 *   base_path() returns "/drupalfolder/".
 * - http://example.com/path/alias (which is a path alias for node/306) returns
 *   "node/306" as opposed to the path alias.
 *
75
 * This function is available only after DRUPAL_BOOTSTRAP_FULL.
76
77
78
 *
 * @return
 *   The current Drupal URL path.
79
80
 *
 * @see request_path()
81
82
 */
function current_path() {
83
84
85
  // @todo Remove the check for whether the request service exists and the
  // fallback code below, once the path alias logic has been figured out in
  // http://drupal.org/node/1269742.
86
87
  if (\Drupal::getContainer()->isScopeActive('request')) {
    $path = \Drupal::request()->attributes->get('_system_path');
88
89
90
    if ($path !== NULL) {
      return $path;
    }
91
  }
92
93
  // If we are outside the request scope, fall back to using the path stored in
  // _current_path().
94
  return _current_path();
95
}
96

97
/**
98
 * Fetches a specific URL alias from the database.
99
100
101
102
103
 *
 * @param $conditions
 *   A string representing the source, a number representing the pid, or an
 *   array of query conditions.
 *
104
 * @see \Drupal\Core\Path\Path::load()
105
106
107
108
109
110
111
112
113
114
115
 */
function path_load($conditions) {
  if (is_numeric($conditions)) {
    $conditions = array('pid' => $conditions);
  }
  elseif (is_string($conditions)) {
    $conditions = array('source' => $conditions);
  }
  elseif (!is_array($conditions)) {
    return FALSE;
  }
116
  return \Drupal::service('path.crud')->load($conditions);
117
118
}

119
/**
120
 * Determines whether a path is in the administrative section of the site.
121
 *
122
123
124
 * By default, paths are considered to be non-administrative. If a path does
 * not match any of the patterns in path_get_admin_paths(), or if it matches
 * both administrative and non-administrative patterns, it is considered
125
126
127
128
 * non-administrative.
 *
 * @param $path
 *   A Drupal path.
129
 *
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
 * @return
 *   TRUE if the path is administrative, FALSE otherwise.
 *
 * @see path_get_admin_paths()
 * @see hook_admin_paths()
 * @see hook_admin_paths_alter()
 */
function path_is_admin($path) {
  $path_map = &drupal_static(__FUNCTION__);
  if (!isset($path_map['admin'][$path])) {
    $patterns = path_get_admin_paths();
    $path_map['admin'][$path] = drupal_match_path($path, $patterns['admin']);
    $path_map['non_admin'][$path] = drupal_match_path($path, $patterns['non_admin']);
  }
  return $path_map['admin'][$path] && !$path_map['non_admin'][$path];
}

/**
148
 * Gets a list of administrative and non-administrative paths.
149
150
151
152
153
154
155
156
157
158
159
160
161
 *
 * @return array
 *   An associative array containing the following keys:
 *   'admin': An array of administrative paths and regular expressions
 *            in a format suitable for drupal_match_path().
 *   'non_admin': An array of non-administrative paths and regular expressions.
 *
 * @see hook_admin_paths()
 * @see hook_admin_paths_alter()
 */
function path_get_admin_paths() {
  $patterns = &drupal_static(__FUNCTION__);
  if (!isset($patterns)) {
162
    $paths = \Drupal::moduleHandler()->invokeAll('admin_paths');
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
    drupal_alter('admin_paths', $paths);
    // Combine all admin paths into one array, and likewise for non-admin paths,
    // for easier handling.
    $patterns = array();
    $patterns['admin'] = array();
    $patterns['non_admin'] = array();
    foreach ($paths as $path => $enabled) {
      if ($enabled) {
        $patterns['admin'][] = $path;
      }
      else {
        $patterns['non_admin'][] = $path;
      }
    }
    $patterns['admin'] = implode("\n", $patterns['admin']);
    $patterns['non_admin'] = implode("\n", $patterns['non_admin']);
  }
  return $patterns;
}
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198

/**
 * Checks a path exists and the current user has access to it.
 *
 * @param $path
 *   The path to check.
 * @param $dynamic_allowed
 *   Whether paths with menu wildcards (like user/%) should be allowed.
 *
 * @return
 *   TRUE if it is a valid path AND the current user has access permission,
 *   FALSE otherwise.
 */
function drupal_valid_path($path, $dynamic_allowed = FALSE) {
  global $menu_admin;
  // We indicate that a menu administrator is running the menu access check.
  $menu_admin = TRUE;
199
200
201
202
203
204
205
206
207
208
  /** @var $route_provider \Drupal\Core\Routing\RouteProviderInterface */
  $route_provider = \Drupal::service('router.route_provider');

  if ($dynamic_allowed && preg_match('/\/\%/', $path)) {
    $router_path = '/' . str_replace('%', '{}', $path);
  }
  else {
    $router_path = $path;
  }

209
210
211
  if ($path == '<front>' || url_is_external($path)) {
    $item = array('access' => TRUE);
  }
212
213
214
215
  elseif (($collection = $route_provider->getRoutesByPattern('/' . $router_path)) && $collection->count() > 0) {
    $routes = $collection->all();
    $route_name = key($routes);
  }
216
217
218
  elseif ($dynamic_allowed && preg_match('/\/\%/', $path)) {
    // Path is dynamic (ie 'user/%'), so check directly against menu_router table.
    if ($item = db_query("SELECT * FROM {menu_router} where path = :path", array(':path' => $path))->fetchAssoc()) {
219
220
      $item['link_path']  = $item['path'];
      $item['link_title'] = $item['title'];
221
222
223
      $item['external']   = FALSE;
      $item['options'] = '';
      _menu_link_translate($item);
224
      $route_name = $item['route_name'];
225
226
227
228
    }
  }
  else {
    $item = menu_get_item($path);
229
    $route_name = $item['route_name'];
230
231
  }
  // Check the new routing system.
232
  if (!empty($route_name)) {
233
    $map = array();
234
235
236
237
238
239
    $route = \Drupal::service('router.route_provider')->getRouteByName($route_name);
    $request = RequestHelper::duplicate(\Drupal::request(), '/' . $path);
    $request->attributes->set('_system_path', $path);
    $request->attributes->set('_menu_admin', TRUE);

    $item['access'] = menu_item_route_access($route, $path, $map, $request);
240
241
242
243
  }
  $menu_admin = FALSE;
  return $item && $item['access'];
}