function node_query_node_access_alter
Same name in other branches
- 7.x modules/node/node.module \node_query_node_access_alter()
- 8.9.x core/modules/node/node.module \node_query_node_access_alter()
- 10 core/modules/node/node.module \node_query_node_access_alter()
Implements hook_query_TAG_alter().
This is the hook_query_alter() for queries tagged with 'node_access'. It adds node access checks for the user account given by the 'account' meta-data (or current user if not provided), for an operation given by the 'op' meta-data (or 'view' if not provided; other possible values are 'update' and 'delete').
Queries tagged with 'node_access' that are not against the {node} table must add the base table as metadata. For example:
$query->addTag('node_access')
->addMetaData('base_table', 'taxonomy_index');
Related topics
File
-
core/
modules/ node/ node.module, line 941
Code
function node_query_node_access_alter(AlterableInterface $query) {
// Read meta-data from query, if provided.
if (!($account = $query->getMetaData('account'))) {
$account = \Drupal::currentUser();
}
if (!($op = $query->getMetaData('op'))) {
$op = 'view';
}
// If $account can bypass node access, or there are no node access modules,
// or the operation is 'view' and the $account has a global view grant
// (such as a view grant for node ID 0), we don't need to alter the query.
if ($account->hasPermission('bypass node access')) {
return;
}
if (!\Drupal::moduleHandler()->hasImplementations('node_grants')) {
return;
}
if ($op == 'view' && node_access_view_all_nodes($account)) {
return;
}
$tables = $query->getTables();
$base_table = $query->getMetaData('base_table');
// If the base table is not given, default to one of the node base tables.
if (!$base_table) {
/** @var \Drupal\Core\Entity\Sql\DefaultTableMapping $table_mapping */
$table_mapping = \Drupal::entityTypeManager()->getStorage('node')
->getTableMapping();
$node_base_tables = $table_mapping->getTableNames();
foreach ($tables as $table_info) {
if (!$table_info instanceof SelectInterface) {
$table = $table_info['table'];
// Ensure that 'node' and 'node_field_data' are always preferred over
// 'node_revision' and 'node_field_revision'.
if ($table == 'node' || $table == 'node_field_data') {
$base_table = $table;
break;
}
// If one of the node base tables are in the query, add it to the list
// of possible base tables to join against.
if (in_array($table, $node_base_tables)) {
$base_table = $table;
}
}
}
// Bail out if the base table is missing.
if (!$base_table) {
throw new Exception('Query tagged for node access but there is no node table, specify the base_table using meta data.');
}
}
// Update the query for the given storage method.
\Drupal::service('node.grant_storage')->alterQuery($query, $tables, $op, $account, $base_table);
// Bubble the 'user.node_grants:$op' cache context to the current render
// context.
$request = \Drupal::requestStack()->getCurrentRequest();
$renderer = \Drupal::service('renderer');
if ($request->isMethodCacheable() && $renderer->hasRenderContext()) {
$build = [
'#cache' => [
'contexts' => [
'user.node_grants:' . $op,
],
],
];
$renderer->render($build);
}
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.