Creates a role with specified permissions.

Parameters

array $permissions: Array of permission names to assign to role.

string $rid: (optional) The role ID (machine name). Defaults to a random name.

string $name: (optional) The label for the role. Defaults to a random string.

int $weight: (optional) The weight for the role. Defaults to NULL which sets the weight to maximum + 1.

Return value

string Role ID of newly created role, or FALSE if role creation failed.

22 calls to UserCreationTrait::createRole()

AccessTest::setUp in core/modules/views/tests/src/Functional/Plugin/AccessTest.php

Sets up the test.

AccessTestBase::setUp in core/modules/user/tests/src/Functional/Views/AccessTestBase.php

Sets up the test.

ConfigTranslationListUiTest::doUserRoleListTest in core/modules/config_translation/tests/src/Functional/ConfigTranslationListUiTest.php

Tests the role listing for the translate operation.

ContextualFiltersStringTest::setUp in core/modules/views/tests/src/Functional/Plugin/ContextualFiltersStringTest.php

Sets up the test.

HandlerFieldRoleTest::testRole in core/modules/user/tests/src/Functional/Views/HandlerFieldRoleTest.php

... See full list

File

core/modules/user/tests/src/Traits/UserCreationTrait.php, line 247

Class

UserCreationTrait

Provides test methods for user creation and authentication.

Namespace

Drupal\Tests\user\Traits

Code

protected function createRole(array $permissions, $rid = NULL, $name = NULL, $weight = NULL) {
  // Generate a random, lowercase machine name if none was passed.
  if (!isset($rid)) {
    $rid = strtolower($this->randomMachineName(8));
  }
  // Generate a random label.
  if (!isset($name)) {
    // In the role UI role names are trimmed and random string can start or
    // end with a space.
    $name = trim($this->randomString(8));
  }
  // Check the all the permissions strings are valid.
  if (!$this->checkPermissions($permissions)) {
    return FALSE;
  }
  // Create new role.
  $role = Role::create([
    'id' => $rid,
    'label' => $name,
  ]);
  if (isset($weight)) {
    $role->set('weight', $weight);
  }
  $result = $role->save();
  $this->assertSame(SAVED_NEW, $result, new FormattableMarkup('Created role ID @rid with name @name.', [
    '@name' => var_export($role->label(), TRUE),
    '@rid' => var_export($role->id(), TRUE),
  ]), 'Role');
  if ($result === SAVED_NEW) {
    // Grant the specified permissions to the role, if any.
    if (!empty($permissions)) {
      $this->grantPermissions($role, $permissions);
      $assigned_permissions = Role::load($role->id())
        ->getPermissions();
      $missing_permissions = array_diff($permissions, $assigned_permissions);
      $this->assertEmpty($missing_permissions);
    }
    return $role->id();
  }
  else {
    return FALSE;
  }
}

---