class SmsFrameworkPhoneNumberVerificationTest in SMS Framework 2.x
Same name and namespace in other branches
- 8 tests/src/Kernel/SmsFrameworkPhoneNumberVerificationTest.php \Drupal\Tests\sms\Kernel\SmsFrameworkPhoneNumberVerificationTest
- 2.1.x tests/src/Kernel/SmsFrameworkPhoneNumberVerificationTest.php \Drupal\Tests\sms\Kernel\SmsFrameworkPhoneNumberVerificationTest
Tests Phone Number Provider.
@group SMS Framework @coversDefaultClass \Drupal\sms\Provider\PhoneNumberVerification
Hierarchy
- class \Drupal\KernelTests\KernelTestBase extends \PHPUnit\Framework\TestCase implements ServiceProviderInterface uses \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, AssertContentTrait, AssertLegacyTrait, ConfigTestTrait, ExtensionListTestTrait, PhpUnitCompatibilityTrait, RandomGeneratorTrait, TestRequirementsTrait, PhpUnitWarnings
- class \Drupal\Tests\sms\Kernel\SmsFrameworkKernelBase uses SmsFrameworkTestTrait
- class \Drupal\Tests\sms\Kernel\SmsFrameworkPhoneNumberVerificationTest
- class \Drupal\Tests\sms\Kernel\SmsFrameworkKernelBase uses SmsFrameworkTestTrait
Expanded class hierarchy of SmsFrameworkPhoneNumberVerificationTest
File
- tests/
src/ Kernel/ SmsFrameworkPhoneNumberVerificationTest.php, line 21
Namespace
Drupal\Tests\sms\KernelView source
class SmsFrameworkPhoneNumberVerificationTest extends SmsFrameworkKernelBase {
/**
* {@inheritdoc}
*/
public static $modules = [
'sms',
'entity_test',
'user',
'field',
'telephone',
'dynamic_entity_reference',
'sms_test_gateway',
];
/**
* The phone number provider.
*
* @var \Drupal\sms\Provider\PhoneNumberProviderInterface
*/
protected $phoneNumberProvider;
/**
* Phone number verification provider.
*
* @var \Drupal\sms\Provider\PhoneNumberVerificationInterface
*/
protected $phoneNumberVerificationProvider;
/**
* A telephone field for testing.
*
* @var \Drupal\field\FieldStorageConfigInterface
*/
protected $phoneField;
/**
* Phone number settings for entity_test entity type.
*
* @var \Drupal\sms\Entity\PhoneNumberSettingsInterface
*/
protected $phoneNumberSettings;
/**
* The default gateway.
*
* @var \Drupal\sms\Entity\SmsGatewayInterface
*/
protected $gateway;
/**
* {@inheritdoc}
*/
protected function setUp() {
parent::setUp();
$this
->installEntitySchema('entity_test');
$this
->installEntitySchema('sms_phone_number_verification');
$this->gateway = $this
->createMemoryGateway([
'skip_queue' => TRUE,
]);
$this
->setFallbackGateway($this->gateway);
$this->phoneNumberVerificationProvider = $this->container
->get('sms.phone_number.verification');
$this->phoneField = FieldStorageConfig::create([
'entity_type' => 'entity_test',
'field_name' => mb_strtolower($this
->randomMachineName()),
'type' => 'telephone',
]);
$this->phoneField
->save();
FieldConfig::create([
'entity_type' => 'entity_test',
'bundle' => 'entity_test',
'field_name' => $this->phoneField
->getName(),
])
->save();
$this->phoneNumberSettings = PhoneNumberSettings::create();
$this->phoneNumberSettings
->setPhoneNumberEntityTypeId('entity_test')
->setPhoneNumberBundle('entity_test')
->setFieldName('phone_number', $this->phoneField
->getName())
->setVerificationMessage($this
->randomString())
->save();
}
/**
* Tests read only phone number config helper.
*
* @covers ::getPhoneNumberSettings
*/
public function testGetPhoneNumberSettings() {
$return = $this->phoneNumberVerificationProvider
->getPhoneNumberSettings($this
->randomMachineName(), $this
->randomMachineName());
$this
->assertNull($return, 'Phone number settings does not exist.');
$return = $this->phoneNumberVerificationProvider
->getPhoneNumberSettings('entity_test', $this
->randomMachineName());
$this
->assertNull($return, 'Phone number settings does not exist.');
$return = $this->phoneNumberVerificationProvider
->getPhoneNumberSettings('entity_test', 'entity_test');
$this
->assertTrue($return instanceof PhoneNumberSettingsInterface);
}
/**
* Tests read only phone number config helper via entity with no settings..
*
* @covers ::getPhoneNumberSettingsForEntity
*/
public function testGetPhoneNumberSettingsForEntityNoSettings() {
$test_entity_random_bundle = EntityTest::create([
'name' => $this
->randomMachineName(),
'type' => $this
->randomMachineName(),
]);
$this
->expectException(PhoneNumberSettingsException::class);
$this->phoneNumberVerificationProvider
->getPhoneNumberSettingsForEntity($test_entity_random_bundle);
}
/**
* Tests read only phone number config helper via entity.
*
* @covers ::getPhoneNumberSettingsForEntity
*/
public function testGetPhoneNumberSettingsForEntity() {
$entity = $this
->createEntityWithPhoneNumber($this->phoneNumberSettings);
$return = $this->phoneNumberVerificationProvider
->getPhoneNumberSettingsForEntity($entity);
$this
->assertTrue($return instanceof PhoneNumberSettingsInterface);
}
/**
* Tests get verification by code.
*
* @covers ::getPhoneVerificationByCode
*/
public function testGetPhoneVerificationByCode() {
$this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
'+123123123',
]);
$verification = $this
->getLastVerification();
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByCode($verification
->getCode());
$this
->assertEquals($return
->id(), $verification
->id());
}
/**
* Tests get verification by non-existent code.
*
* @covers ::getPhoneVerificationByCode
*/
public function testGetPhoneVerificationByFakeCode() {
$this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
'+123123123',
]);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByCode($this
->randomMachineName());
$this
->assertFalse($return);
}
/**
* Tests get verification by phone number.
*
* @covers ::getPhoneVerificationByPhoneNumber
*/
public function testGetPhoneVerificationByPhoneNumber() {
$phone_number1 = '+123123123';
$this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
$phone_number1,
]);
// Decoy:
$phone_number2 = '+456456456';
$this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
$phone_number2,
]);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number1, NULL);
$this
->assertEquals(1, count($return));
}
/**
* Tests get verification by phone number with verified option.
*
* @covers ::getPhoneVerificationByPhoneNumber
*/
public function testGetPhoneVerificationByPhoneNumberVerified() {
$phone_number1 = '+123123123';
$phone_number2 = '+456456456';
$entity = $this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
$phone_number1,
$phone_number2,
]);
$this
->verifyPhoneNumber($entity, $phone_number2);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number1, TRUE);
$this
->assertEquals(0, count($return));
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number1, FALSE);
$this
->assertEquals(1, count($return));
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number2, FALSE);
$this
->assertEquals(0, count($return));
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number2, TRUE);
$this
->assertEquals(1, count($return));
}
/**
* Tests get verification by phone number with entity type ID option.
*
* @covers ::getPhoneVerificationByPhoneNumber
*/
public function testGetPhoneVerificationByPhoneNumberEntityType() {
$phone_number = '+123123123';
$this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
$phone_number,
]);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number, NULL, 'entity_test');
$this
->assertEquals(1, count($return));
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByPhoneNumber($phone_number, NULL, $this
->randomMachineName());
$this
->assertEquals(0, count($return));
}
/**
* Tests get verification by entity.
*
* @covers ::getPhoneVerificationByEntity
*/
public function testGetPhoneVerificationByEntity() {
$phone_number = '+123123123';
$entity = $this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
$phone_number,
]);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByEntity($entity, $phone_number);
$this
->assertNotFalse($return);
}
/**
* Tests get verification by entity with phone number without verification.
*
* @covers ::getPhoneVerificationByEntity
*/
public function testGetPhoneVerificationByEntityInvalidPhone() {
$entity = $this
->createEntityWithPhoneNumber($this->phoneNumberSettings, [
'+123123123',
]);
$return = $this->phoneNumberVerificationProvider
->getPhoneVerificationByEntity($entity, '+456456456');
$this
->assertFalse($return);
}
/**
* Tests creating new verification for an entity.
*
* @covers ::newPhoneVerification
*/
public function testNewPhoneVerification() {
$phone_number = '+123123123';
$entity = $this
->createEntityWithPhoneNumber($this->phoneNumberSettings);
$return = $this->phoneNumberVerificationProvider
->newPhoneVerification($entity, $phone_number);
$this
->assertTrue($return instanceof PhoneNumberVerificationInterface);
// Catch the phone verification message.
$sent_messages = $this
->getTestMessages($this->gateway);
$this
->assertEquals(1, count($sent_messages));
$verification_message = reset($sent_messages);
$this
->assertTrue($verification_message
->getOption('_is_verification_message'));
$verification = $this
->getLastVerification();
$this
->assertEquals($entity
->id(), $verification
->getEntity()
->id());
$this
->assertEquals($phone_number, $verification
->getPhoneNumber());
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AssertContentTrait:: |
protected | property | The current raw content. | |
AssertContentTrait:: |
protected | property | The drupalSettings value from the current raw $content. | |
AssertContentTrait:: |
protected | property | The XML structure parsed from the current raw $content. | 1 |
AssertContentTrait:: |
protected | property | The plain-text content of raw $content (text nodes). | |
AssertContentTrait:: |
protected | function | Passes if the raw text IS found escaped on the loaded page, fail otherwise. | |
AssertContentTrait:: |
protected | function | Asserts that a field exists with the given name or ID. | |
AssertContentTrait:: |
protected | function | Asserts that a field exists with the given ID and value. | |
AssertContentTrait:: |
protected | function | Asserts that a field exists with the given name and value. | |
AssertContentTrait:: |
protected | function | Asserts that a field exists in the current page by the given XPath. | |
AssertContentTrait:: |
protected | function | Asserts that a checkbox field in the current page is checked. | |
AssertContentTrait:: |
protected | function | Asserts that a field exists in the current page with a given Xpath result. | |
AssertContentTrait:: |
protected | function | Passes if a link with the specified label is found. | |
AssertContentTrait:: |
protected | function | Passes if a link containing a given href (part) is found. | |
AssertContentTrait:: |
protected | function | Asserts that each HTML ID is used for just a single element. | |
AssertContentTrait:: |
protected | function | Passes if the raw text IS NOT found escaped on the loaded page, fail otherwise. | |
AssertContentTrait:: |
protected | function | Asserts that a field does not exist with the given name or ID. | |
AssertContentTrait:: |
protected | function | Asserts that a field does not exist with the given ID and value. | |
AssertContentTrait:: |
protected | function | Asserts that a field does not exist with the given name and value. | |
AssertContentTrait:: |
protected | function | Asserts that a field does not exist or its value does not match, by XPath. | |
AssertContentTrait:: |
protected | function | Asserts that a checkbox field in the current page is not checked. | |
AssertContentTrait:: |
protected | function | Passes if a link with the specified label is not found. | |
AssertContentTrait:: |
protected | function | Passes if a link containing a given href (part) is not found. | |
AssertContentTrait:: |
protected | function | Passes if a link containing a given href is not found in the main region. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page does not exist. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page is not checked. | |
AssertContentTrait:: |
protected | function | Triggers a pass if the perl regex pattern is not found in raw content. | |
AssertContentTrait:: |
protected | function | Passes if the raw text is NOT found on the loaded page, fail otherwise. | |
AssertContentTrait:: |
protected | function | Passes if the page (with HTML stripped) does not contains the text. | |
AssertContentTrait:: |
protected | function | Pass if the page title is not the given string. | |
AssertContentTrait:: |
protected | function | Passes if the text is found MORE THAN ONCE on the text version of the page. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page exists. | |
AssertContentTrait:: |
protected | function | Asserts that a select option with the visible text exists. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page is checked. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page is checked. | |
AssertContentTrait:: |
protected | function | Asserts that a select option in the current page exists. | |
AssertContentTrait:: |
protected | function | Triggers a pass if the Perl regex pattern is found in the raw content. | |
AssertContentTrait:: |
protected | function | Passes if the raw text IS found on the loaded page, fail otherwise. | |
AssertContentTrait:: |
protected | function | Passes if the page (with HTML stripped) contains the text. | |
AssertContentTrait:: |
protected | function | Helper for assertText and assertNoText. | |
AssertContentTrait:: |
protected | function | Asserts that a Perl regex pattern is found in the plain-text content. | |
AssertContentTrait:: |
protected | function | Asserts themed output. | |
AssertContentTrait:: |
protected | function | Pass if the page title is the given string. | |
AssertContentTrait:: |
protected | function | Passes if the text is found ONLY ONCE on the text version of the page. | |
AssertContentTrait:: |
protected | function | Helper for assertUniqueText and assertNoUniqueText. | |
AssertContentTrait:: |
protected | function | Builds an XPath query. | |
AssertContentTrait:: |
protected | function | Helper: Constructs an XPath for the given set of attributes and value. | |
AssertContentTrait:: |
protected | function | Searches elements using a CSS selector in the raw content. | |
AssertContentTrait:: |
protected | function | Get all option elements, including nested options, in a select. | |
AssertContentTrait:: |
protected | function | Gets the value of drupalSettings for the currently-loaded page. | |
AssertContentTrait:: |
protected | function | Gets the current raw content. | |
AssertContentTrait:: |
protected | function | Get the selected value from a select field. | |
AssertContentTrait:: |
protected | function | Retrieves the plain-text content from the current raw content. | |
AssertContentTrait:: |
protected | function | Get the current URL from the cURL handler. | 1 |
AssertContentTrait:: |
protected | function | Parse content returned from curlExec using DOM and SimpleXML. | |
AssertContentTrait:: |
protected | function | Removes all white-space between HTML tags from the raw content. | |
AssertContentTrait:: |
protected | function | Sets the value of drupalSettings for the currently-loaded page. | |
AssertContentTrait:: |
protected | function | Sets the raw content (e.g. HTML). | |
AssertContentTrait:: |
protected | function | Performs an xpath search on the contents of the internal browser. | |
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
AssertLegacyTrait:: |
protected | function | ||
ConfigTestTrait:: |
protected | function | Returns a ConfigImporter object to import test configuration. | |
ConfigTestTrait:: |
protected | function | Copies configuration objects from source storage to target storage. | |
ExtensionListTestTrait:: |
protected | function | Gets the path for the specified module. | |
ExtensionListTestTrait:: |
protected | function | Gets the path for the specified theme. | |
KernelTestBase:: |
protected | property | Back up and restore any global variables that may be changed by tests. | |
KernelTestBase:: |
protected | property | Back up and restore static class properties that may be changed by tests. | |
KernelTestBase:: |
protected | property | Contains a few static class properties for performance. | |
KernelTestBase:: |
protected | property | ||
KernelTestBase:: |
protected | property | @todo Move into Config test base class. | 7 |
KernelTestBase:: |
protected static | property | An array of config object names that are excluded from schema checking. | |
KernelTestBase:: |
protected | property | ||
KernelTestBase:: |
protected | property | ||
KernelTestBase:: |
protected | property | Do not forward any global state from the parent process to the processes that run the actual tests. | |
KernelTestBase:: |
protected | property | The app root. | |
KernelTestBase:: |
protected | property | Kernel tests are run in separate processes because they allow autoloading of code from extensions. Running the test in a separate process isolates this behavior from other tests. Subclasses should not override this property. | |
KernelTestBase:: |
protected | property | ||
KernelTestBase:: |
protected | property | Set to TRUE to strict check all configuration saved. | 6 |
KernelTestBase:: |
protected | property | The virtual filesystem root directory. | |
KernelTestBase:: |
protected | function | 1 | |
KernelTestBase:: |
protected | function | Bootstraps a basic test environment. | |
KernelTestBase:: |
private | function | Bootstraps a kernel for a test. | |
KernelTestBase:: |
protected | function | Configuration accessor for tests. Returns non-overridden configuration. | |
KernelTestBase:: |
protected | function | Disables modules for this test. | |
KernelTestBase:: |
protected | function | Enables modules for this test. | |
KernelTestBase:: |
protected | function | Gets the config schema exclusions for this test. | |
KernelTestBase:: |
protected | function | Returns the Database connection info to be used for this test. | 3 |
KernelTestBase:: |
public | function | ||
KernelTestBase:: |
private | function | Returns Extension objects for $modules to enable. | |
KernelTestBase:: |
private static | function | Returns the modules to enable for this test. | |
KernelTestBase:: |
protected | function | Initializes the FileCache component. | |
KernelTestBase:: |
protected | function | Installs default configuration for a given list of modules. | |
KernelTestBase:: |
protected | function | Installs the storage schema for a specific entity type. | |
KernelTestBase:: |
protected | function | Installs database tables from a module schema definition. | |
KernelTestBase:: |
protected | function | ||
KernelTestBase:: |
public | function |
Registers test-specific services. Overrides ServiceProviderInterface:: |
24 |
KernelTestBase:: |
protected | function | Renders a render array. | 1 |
KernelTestBase:: |
protected | function | Sets the install profile and rebuilds the container to update it. | |
KernelTestBase:: |
protected | function | Sets an in-memory Settings variable. | |
KernelTestBase:: |
public static | function | 1 | |
KernelTestBase:: |
protected | function | Sets up the filesystem, so things like the file directory. | 2 |
KernelTestBase:: |
protected | function | Stops test execution. | |
KernelTestBase:: |
protected | function | 4 | |
KernelTestBase:: |
public | function | @after | |
KernelTestBase:: |
protected | function | Dumps the current state of the virtual filesystem to STDOUT. | |
KernelTestBase:: |
public | function | Prevents serializing any properties. | |
PhpUnitWarnings:: |
private static | property | Deprecation warnings from PHPUnit to raise with @trigger_error(). | |
PhpUnitWarnings:: |
public | function | Converts PHPUnit deprecation warnings to E_USER_DEPRECATED. | |
RandomGeneratorTrait:: |
protected | property | The random generator. | |
RandomGeneratorTrait:: |
protected | function | Gets the random generator for the utility methods. | |
RandomGeneratorTrait:: |
protected | function | Generates a unique random string containing letters and numbers. | 1 |
RandomGeneratorTrait:: |
public | function | Generates a random PHP object. | |
RandomGeneratorTrait:: |
public | function | Generates a pseudo-random string of ASCII characters of codes 32 to 126. | |
RandomGeneratorTrait:: |
public | function | Callback for random string validation. | |
SmsFrameworkPhoneNumberVerificationTest:: |
protected | property | The default gateway. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public static | property |
Modules to enable. Overrides KernelTestBase:: |
|
SmsFrameworkPhoneNumberVerificationTest:: |
protected | property | A telephone field for testing. | |
SmsFrameworkPhoneNumberVerificationTest:: |
protected | property | The phone number provider. | |
SmsFrameworkPhoneNumberVerificationTest:: |
protected | property | Phone number settings for entity_test entity type. | |
SmsFrameworkPhoneNumberVerificationTest:: |
protected | property | Phone number verification provider. | |
SmsFrameworkPhoneNumberVerificationTest:: |
protected | function |
Overrides SmsFrameworkKernelBase:: |
|
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests read only phone number config helper. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests read only phone number config helper via entity. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests read only phone number config helper via entity with no settings.. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by code. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by entity. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by entity with phone number without verification. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by non-existent code. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by phone number. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by phone number with entity type ID option. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests get verification by phone number with verified option. | |
SmsFrameworkPhoneNumberVerificationTest:: |
public | function | Tests creating new verification for an entity. | |
SmsFrameworkTestTrait:: |
protected | function | Creates an entity, and optionally adds phone numbers. | |
SmsFrameworkTestTrait:: |
protected | function | Creates a memory gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Create a result and reports for a message. | |
SmsFrameworkTestTrait:: |
protected | function | Get all messages received by a gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Get the last message sent to gateway. | |
SmsFrameworkTestTrait:: |
public | function | Get the last SMS message sent to 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Gets the last SMS report for messages sent to 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Gets the last phone number verification that was created. | |
SmsFrameworkTestTrait:: |
protected | function | Gets an SMS report for message with message ID. | |
SmsFrameworkTestTrait:: |
protected | function | Gets all SMS reports for messages sent to 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
public | function | Get all SMS messages sent to a 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Generates random phone numbers for tests. | |
SmsFrameworkTestTrait:: |
protected | function | Generates a random SMS message by the specified user. | |
SmsFrameworkTestTrait:: |
protected | function | Resets incoming messages stored in memory by gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Resets the SMS reports stored in memory by 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
public | function | Resets SMS messages stored in memory by 'Memory' gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Sets the fallback gateway. | |
SmsFrameworkTestTrait:: |
protected | function | Forces verification of a phone number for an entity. | |
StorageCopyTrait:: |
protected static | function | Copy the configuration from one storage to another and remove stale items. | |
TestRequirementsTrait:: |
private | function | Checks missing module requirements. | |
TestRequirementsTrait:: |
protected | function | Check module requirements for the Drupal use case. | 1 |
TestRequirementsTrait:: |
protected static | function | Returns the Drupal root directory. |