class S3fsTest in S3 File System 8.3
Same name and namespace in other branches
- 4.0.x tests/src/Functional/S3fsTest.php \Drupal\Tests\s3fs\Functional\S3fsTest
S3 File System Tests.
Ensure that the remote file system functionality provided by S3 File System works correctly.
The AWS credentials must be configured in prepareConfig() because settings.php, which does not get executed during a BrowserTestBase.
@group s3fs
Hierarchy
- class \Drupal\Tests\BrowserTestBase extends \PHPUnit\Framework\TestCase uses FunctionalTestSetupTrait, TestSetupTrait, AssertLegacyTrait, BlockCreationTrait, ConfigTestTrait, ContentTypeCreationTrait, NodeCreationTrait, PhpunitCompatibilityTrait, RandomGeneratorTrait, TestRequirementsTrait, UiHelperTrait, UserCreationTrait, XdebugRequestTrait
- class \Drupal\Tests\s3fs\Functional\S3fsTestBase
- class \Drupal\Tests\s3fs\Functional\S3fsTest
- class \Drupal\Tests\s3fs\Functional\S3fsTestBase
Expanded class hierarchy of S3fsTest
File
- tests/
src/ Functional/ S3fsTest.php, line 21
Namespace
Drupal\Tests\s3fs\FunctionalView source
class S3fsTest extends S3fsTestBase {
/**
* {@inheritdoc}
*/
protected static $modules = [
's3fs',
'image',
];
/**
* Coverage test for the stream wrapper.
*/
public function testStreamWrapperCoverage() {
$test_uri1 = "{$this->remoteTestsFolderUri}/test_file1.txt";
$test_uri2 = "{$this->remoteTestsFolderUri}/test_file2.txt";
$this
->assertTrue(\Drupal::service('stream_wrapper_manager')
->isValidScheme('s3'), '"s3" is a valid stream wrapper scheme.');
$this
->assertEqual(\Drupal::service('stream_wrapper_manager')
->getClass('s3'), 'Drupal\\s3fs\\StreamWrapper\\S3fsStream', 'URIs with scheme "s3" should be handled by S3fsStream.');
// The test.txt file contains enough data to force multiple calls
// to write_stream().
$file_contents = file_get_contents(__DIR__ . '/../../fixtures/test.txt');
$this
->assertTrue(\Drupal::service('file_system')
->mkdir($this->remoteTestsFolderUri), 'Exercised mkdir to create the testing directory (in the DB).');
$this
->assertTrue(is_dir($this->remoteTestsFolderUri), 'Make sure the folder we just created correctly reports that it is a folder.');
$this
->verbose("Exercising file upload functionality.");
$start_time = time();
$s3_file1 = file_save_data($file_contents, $test_uri1);
$end_time = time();
$total = $end_time - $start_time;
$this
->verbose("Upload time: {$total} seconds");
$this
->assertTrue(\Drupal::service('stream_wrapper_manager')
->isValidUri($s3_file1
->getFileUri()), "Uploaded the first test file, {$test_uri1}.");
$this
->verbose("Exercising file copy functionality.");
$s3_file2 = file_copy($s3_file1, $test_uri2);
$this
->assertNotIdentical($s3_file2, FALSE, "Copied the the first test file to {$test_uri2}.");
$this
->verbose('Exercising the dir_*() functions.');
$files = \Drupal::service('file_system')
->scanDirectory($this->remoteTestsFolderUri, '#.*#');
$this
->assertTrue(isset($files[$test_uri1]), 'The first test file is in the tests directory.');
$this
->assertTrue(isset($files[$test_uri2]), 'The second test file is in the tests directory.');
$this
->assertEqual(count($files), 2, "There are exactly two files in the tests directory.");
$this
->verbose('Exercising getExternalUrl().');
$url = file_create_url($test_uri1);
$this
->assertNotIdentical($url, FALSE, 'file_create_url() succeeded.');
$this
->verbose('Exercising unlink().');
$this
->assertIdentical(self::fileDelete($s3_file1), TRUE, "Deleted the first test file.");
$this
->assertIdentical(file_exists($test_uri1), FALSE, 'The wrapper reports that the first test file no longer exists.');
$this
->verbose('Exercising rename().');
$this
->assertTrue(rename($test_uri2, $test_uri1), "Renamed the second test file to the newly-vacated URI of {$test_uri1}.");
$s3_file2
->setFileUri($test_uri1);
$s3_file2
->save();
// Rename a 'directory' should fail.
$dir_move_test_src = $this->remoteTestsFolderUri . '/directoryToBeMoved';
$dir_move_test_dest = $this->remoteTestsFolderUri . '/destinationDirectory';
$this
->assertTrue(\Drupal::service('file_system')
->mkdir($dir_move_test_src), 'Created testing directory to attempt move.');
$this
->assertNotFalse(file_put_contents($dir_move_test_src . '/test.file', 'test'), "Created file in directory that will be moved.");
$this
->assertFalse(rename($dir_move_test_src, $dir_move_test_dest), 'Should not be able to move a directory.');
$this
->assertFalse(is_file($dir_move_test_dest . '/test.file'), 'Test file should not exist as directory moves are not supported.');
$this
->assertTrue(unlink($dir_move_test_src . '/test.file'), "Deleted the test move file.");
$this
->verbose('Exercising rmdir().');
$this
->assertFalse(\Drupal::service('file_system')
->rmdir($this->remoteTestsFolderUri), 'rmdir() did not delete the tests folder because it is not empty.');
$this
->assertTrue(\Drupal::service('file_system')
->rmdir($dir_move_test_src), "Delete the move test directory");
$this
->assertTrue(self::fileDelete($s3_file2), 'Deleted the last test file.');
$this
->assertTrue(\Drupal::service('file_system')
->rmdir($this->remoteTestsFolderUri), 'Deleted the tests folder.');
$this
->assertFalse(is_dir($this->remoteTestsFolderUri), 'The wrapper reports that the tests folder is gone.');
$this
->verbose('Testing max filename limits');
// 250 characters + 's3://' = 255 characters max limit.
$sourceMaxString = 'C9Xa0jcb8RqTvu5KKSjziAmiRHJJDsbIdZTSt345KkJJRAhkfJk8OddTyBgps5u6RAEwkQ6WKfnSd2jQKQAm5BmcYVSMMtkUcSJo5TsvCgS4s5UrVEXPKcLqsP4JQuEAMDbIrqCD0WXuTDAUCF38oQvyaXplxwSwgjBavS4XkeYCqUjMXBSWtUeDLbiLkzfMFUHa1QcHciy318id75KOuSvMC4x2z1177Ht90zR4PNvTDvE7smPNEOL8Y';
$uriMaxLength = 255;
// 245 Character long string to work with on future tests.
$baseLongDir = "{$this->remoteTestsFolderUri}/" . substr($sourceMaxString, 0, $uriMaxLength - strlen($this->remoteTestsFolderUri) - 11);
$this
->assertEquals($uriMaxLength - 10, strlen($baseLongDir));
// Max length mkdir().
// 256 characters long the last / is stripped making 255 limit safe.
$pathDirMaxLength = "{$baseLongDir}/dir/12345/";
$this
->assertTrue(\Drupal::service('file_system')
->mkdir($pathDirMaxLength), 'Creating max path length directory');
$this
->assertTrue(is_dir($pathDirMaxLength), 'Verify max path length directory exists');
// 257 characters long the last / is stripped making 256 exceeding limit.
$pathDirExceedMaxLength = "{$baseLongDir}/dir/123456/";
$this
->assertFalse(\Drupal::service('file_system')
->mkdir($pathDirExceedMaxLength), 'Creating directory that exceeds path length limit');
$this
->assertFalse(is_dir($pathDirExceedMaxLength), 'Verify directory that exceeds max path length doesnt exist');
// Max length stream_open().
$pathFileMaxLength = "{$baseLongDir}/78901.txt";
$pathFileExceedMaxLength = "{$baseLongDir}/789012.txt";
$this
->assertNotFalse(file_put_contents($pathFileMaxLength, $file_contents), 'Creating max path length filename');
$this
->assertTrue(is_file($pathFileMaxLength), 'Verify max path length file exists');
$this
->assertFalse(@file_put_contents($pathFileExceedMaxLength, $file_contents), 'Creating file exceeds max path length');
$this
->assertFalse(is_file($pathFileExceedMaxLength), 'File that exceeds max path length doesnt exist');
// Max length rename().
$pathFileRenameMaxLength = "{$baseLongDir}/78901.ace";
$this
->assertTrue(rename($pathFileMaxLength, $pathFileRenameMaxLength), 'Rename file to max path length');
$this
->assertFalse(rename($pathFileRenameMaxLength, $pathFileExceedMaxLength), 'Rename file to exceed max path length');
// Set config and flush static to test cache-control header.
$this
->config('s3fs.settings')
->set('cache_control_header', 'public, max-age=300')
->save();
drupal_static_reset('S3fsStream_constructed_settings');
// Verify header exists on new files.
$headerPutUri = 's3://' . $this
->randomMachineName();
file_put_contents($headerPutUri, $file_contents);
$url = file_create_url($headerPutUri);
$this
->drupalGet($url);
$this
->assertSession()
->responseHeaderEquals('cache-control', 'public, max-age=300');
// Make sure the header exists and age changes on copy().
$this
->config('s3fs.settings')
->set('cache_control_header', 'public, max-age=301')
->save();
drupal_static_reset('S3fsStream_constructed_settings');
$headerCopyUri = 's3://' . $this
->randomMachineName();
copy($headerPutUri, $headerCopyUri);
$url = file_create_url($headerCopyUri);
$this
->drupalGet($url);
$this
->assertSession()
->responseHeaderEquals('cache-control', 'public, max-age=301');
}
/**
* Test the image derivative functionality.
*/
public function testImageDerivatives() {
// Prevent issues with derivative tokens during test.
$this
->config('image.settings')
->set('allow_insecure_derivatives', TRUE)
->save();
// Use the large image style for for presigned tests.
$this
->config('s3fs.settings')
->set('presigned_urls', "6000|.*/large/.*")
->save();
$img_uri1 = "{$this->remoteTestsFolderUri}/test.png";
$img_localpath = __DIR__ . '/../../fixtures/test.png';
// Upload the test image.
$this
->assertTrue(\Drupal::service('file_system')
->mkdir($this->remoteTestsFolderUri), 'Created the testing directory in the DB.');
$img_data = file_get_contents($img_localpath);
$img_file = file_save_data($img_data, $img_uri1);
$this
->assertNotIdentical($img_file, FALSE, "Copied the the test image to {$img_uri1}.");
// Request a derivative.
// Parse query parameters to ensure they get passed.
$style_url_parsed = UrlHelper::parse(ImageStyle::load('thumbnail')
->buildUrl($img_uri1));
$derivative = $this
->drupalGet($style_url_parsed['path'], [
'query' => $style_url_parsed['query'],
]);
$this
->assertNotFalse(imagecreatefromstring($derivative), 'The returned derivative is a valid image.');
$style_presigned_url_parsed = UrlHelper::parse(ImageStyle::load('large')
->buildUrl($img_uri1));
$presigned_derivative = $this
->drupalGet($style_presigned_url_parsed['path'], [
'query' => $style_presigned_url_parsed['query'],
]);
$this
->assertNotFalse(imagecreatefromstring($presigned_derivative), 'The returned signed derivative is a valid image.');
}
/**
* Test the cache refresh.
*/
public function testCacheRefresh() {
// Add several files to the bucket using the AWS SDK directly, so that
// s3fs won't cache them.
$filenames = [
'files/test2.txt',
'parts/test3.txt',
'test.txt',
];
foreach ($filenames as $filename) {
$filename = $this->remoteTestsFolderKey . '/' . $filename;
$this->s3
->putObject([
'Bucket' => $this->s3Config['bucket'],
'Key' => $filename,
'ACL' => 'public-read',
]);
}
$config = $this->s3Config;
// Set the current test folder as the root prefix.
$config['root_folder'] = $this->remoteTestsFolderKey;
\Drupal::service('s3fs')
->refreshCache($config);
// Query the DB to confirm that all the new files are cached.
$result = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute();
$cached_files = [];
foreach ($result as $record) {
$cached_files[] = str_replace('s3://', '', $record->uri);
}
$this
->assertEqual($filenames, $cached_files, 'The test files were all cached.');
// Flush the cache, then do a refresh without versions support.
$this->connection
->delete('s3fs_file')
->execute();
// Disable Version Syncing.
$config['disable_version_sync'] = TRUE;
\Drupal::service('s3fs')
->refreshCache($config);
$config['disable_version_sync'] = FALSE;
// Query the DB to confirm that all the new files are cached.
$result = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute();
$cached_files = [];
foreach ($result as $record) {
$cached_files[] = str_replace('s3://', '', $record->uri);
}
$this
->assertEqual($filenames, $cached_files, 'The test files were all cached without versions.');
// Flush the cache, then do a refresh using the root_folder setting.
// Only the file in the root folder (test3.txt) should become cached.
$this->connection
->delete('s3fs_file')
->execute();
$config['root_folder'] = $this->remoteTestsFolderKey . '/parts';
\Drupal::service('s3fs')
->refreshCache($config);
// Confirm that only the file in the "parts" folder was cached.
$records = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute()
->fetchAll();
$this
->assertEqual(count($records), 1, 'There was only one file in the partially refreshed cache.');
$this
->assertEqual($records[0]->uri, 's3://test3.txt', 'That file was the one in the "parts" folder, which is now the root folder, so "parts" is not in the URI.');
// Now test using the Batch system.
// Set the current test folder as the root prefix.
$config['root_folder'] = $this->remoteTestsFolderKey;
$this
->cacheBatchExecute($config);
// Query the DB to confirm that all the new files are cached.
$result = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute();
$cached_files = [];
foreach ($result as $record) {
$cached_files[] = str_replace('s3://', '', $record->uri);
}
$this
->assertEqual($cached_files, $filenames, 'Batch refresh cached all files.');
// Flush the cache, then do a refresh using the root_folder setting.
// Only the file in the root folder (test3.txt) should become cached.
$this->connection
->delete('s3fs_file')
->execute();
$config['root_folder'] = $this->remoteTestsFolderKey . '/parts';
$this
->cacheBatchExecute($config);
// Confirm that only the file in the "parts" folder was cached.
$records = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute()
->fetchAll();
$this
->assertEqual(count($records), 1, 'Batch partial refresh cached only one file.');
$this
->assertEqual($records[0]->uri, 's3://test3.txt', 'Batched refresh successfully stripped the "parts" folder which is now the root folder.');
// Batch with disable_version_sync.
$config['root_folder'] = $this->remoteTestsFolderKey;
$config['disable_version_sync'] = TRUE;
$this
->cacheBatchExecute($config);
// Query the DB to confirm that all the new files are cached.
$result = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute();
$cached_files = [];
foreach ($result as $record) {
$cached_files[] = str_replace('s3://', '', $record->uri);
}
$this
->assertEqual($cached_files, $filenames, 'Batch refresh with disable_version_sync cached all files.');
// Flush the cache, then do a refresh using the root_folder setting.
// Only the file in the root folder (test3.txt) should become cached.
$this->connection
->delete('s3fs_file')
->execute();
$config['root_folder'] = $this->remoteTestsFolderKey . '/parts';
$this
->cacheBatchExecute($config);
// Confirm that only the file in the "parts" folder was cached.
$records = $this->connection
->select('s3fs_file', 's')
->fields('s')
->condition('dir', 0, '=')
->execute()
->fetchAll();
$this
->assertEqual(count($records), 1, 'Batch partial refresh with disable_version_sync cached only one file.');
$this
->assertEqual($records[0]->uri, 's3://test3.txt', 'Batched refresh with disable_version_sync successfully stripped the "parts" folder which is now the root folder.');
}
/**
* File delete wrapper that returns result.
*
* @param \Drupal\file\FileInterface $file
* A file object to delete.
*
* @return bool
* TRUE if file was deleted, FALSE otherwise.
*/
protected static function fileDelete(FileInterface $file) {
$file
->delete();
$exists = file_exists($file
->getFileUri());
return !$exists;
}
/**
* Create and execute a S3fsRefreshCacheBatch job.
*
* @param array $config
* S3fs Config array to be used for the batch.
*/
private function cacheBatchExecute(array $config) {
$cacheBatchService = \Drupal::service('s3fs.refresh_cache_batch');
// This should match S3fsRefreshCacheBatch->execute() to just before
// PHP_SAPI check and a rewrite of $this.
// Create batch.
$batch_builder = $cacheBatchService
->getBatch();
$args = [
$config,
];
$batch_builder
->addOperation([
S3fsRefreshCacheBatch::class,
'refreshCacheOperation',
], $args);
batch_set($batch_builder
->toArray());
$batch =& batch_get();
// End copy from S3fsRefreshCacheBatch->execute().
// We intentionally cut out the PHP_SAPI check and go to executing it.
$batch['progressive'] = FALSE;
$batch['file'] = drupal_get_path('module', 's3fs') . 'src/Batch/S3fsRefreshCacheBatch.php';
batch_process();
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
AssertHelperTrait:: |
protected static | function | Casts MarkupInterface objects into strings. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead. | |
AssertLegacyTrait:: |
protected | function | Asserts whether an expected cache tag was present in the last response. | |
AssertLegacyTrait:: |
protected | function | Asserts that the element with the given CSS selector is not present. | |
AssertLegacyTrait:: |
protected | function | Asserts that the element with the given CSS selector is present. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS found escaped on the loaded page, fail otherwise. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given name or ID. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given ID and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists with the given name and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists in the current page by the given XPath. | |
AssertLegacyTrait:: |
protected | function | Asserts that a checkbox field in the current page is checked. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field exists in the current page with a given Xpath result. | |
AssertLegacyTrait:: |
protected | function | Checks that current response header equals value. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertSame() instead. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if a link with the specified label is found. | |
AssertLegacyTrait:: |
protected | function | Passes if a link containing a given href (part) is found. | |
AssertLegacyTrait:: |
protected | function | Asserts whether an expected cache tag was absent in the last response. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text is not found escaped on the loaded page. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does NOT exist with the given name or ID. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist with the given ID and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist with the given name and value. | |
AssertLegacyTrait:: |
protected | function | Asserts that a field does not exist or its value does not match, by XPath. | |
AssertLegacyTrait:: |
protected | function | Asserts that a checkbox field in the current page is not checked. | |
AssertLegacyTrait:: |
protected | function | Passes if a link with the specified label is not found. | |
AssertLegacyTrait:: |
protected | function | Passes if a link containing a given href (part) is not found. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option does NOT exist in the current page. | |
AssertLegacyTrait:: |
protected | function | Triggers a pass if the Perl regex pattern is not found in the raw content. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS not found on the loaded page, fail otherwise. | 1 |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotEquals() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the page (with HTML stripped) does not contains the text. | 1 |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertNotSame() instead. | |
AssertLegacyTrait:: |
protected | function | Passes if the text is found MORE THAN ONCE on the text version of the page. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option in the current page exists. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option with the visible text exists. | |
AssertLegacyTrait:: |
protected | function | Asserts that a select option in the current page is checked. | |
AssertLegacyTrait:: |
protected | function | Triggers a pass if the Perl regex pattern is found in the raw content. | |
AssertLegacyTrait:: |
protected | function | Passes if the raw text IS found on the loaded page, fail otherwise. | 1 |
AssertLegacyTrait:: |
protected | function | Asserts the page responds with the specified response code. | 1 |
AssertLegacyTrait:: |
protected | function | Passes if the page (with HTML stripped) contains the text. | 1 |
AssertLegacyTrait:: |
protected | function | Helper for assertText and assertNoText. | |
AssertLegacyTrait:: |
protected | function | Pass if the page title is the given string. | |
AssertLegacyTrait:: |
protected | function | Passes if the text is found ONLY ONCE on the text version of the page. | |
AssertLegacyTrait:: |
protected | function | Passes if the internal browser's URL matches the given path. | |
AssertLegacyTrait:: |
protected | function | Builds an XPath query. | |
AssertLegacyTrait:: |
protected | function | Helper: Constructs an XPath for the given set of attributes and value. | |
AssertLegacyTrait:: |
protected | function | Get all option elements, including nested options, in a select. | |
AssertLegacyTrait:: |
protected | function | Gets the current raw content. | |
AssertLegacyTrait:: |
protected | function | Deprecated Scheduled for removal in Drupal 10.0.0. Use self::assertTrue() instead. | |
AssertLegacyTrait:: |
protected | function | ||
BlockCreationTrait:: |
protected | function | Creates a block instance based on default settings. Aliased as: drupalPlaceBlock | |
BrowserHtmlDebugTrait:: |
protected | property | The Base URI to use for links to the output files. | |
BrowserHtmlDebugTrait:: |
protected | property | Class name for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Counter for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Counter storage for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | Directory name for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | property | HTML output output enabled. | |
BrowserHtmlDebugTrait:: |
protected | property | The file name to write the list of URLs to. | |
BrowserHtmlDebugTrait:: |
protected | property | HTML output test ID. | |
BrowserHtmlDebugTrait:: |
protected | function | Formats HTTP headers as string for HTML output logging. | |
BrowserHtmlDebugTrait:: |
protected | function | Returns headers in HTML output format. | 1 |
BrowserHtmlDebugTrait:: |
protected | function | Logs a HTML output message in a text file. | |
BrowserHtmlDebugTrait:: |
protected | function | Creates the directory to store browser output. | |
BrowserTestBase:: |
protected | property | The base URL. | |
BrowserTestBase:: |
protected | property | The config importer that can be used in a test. | |
BrowserTestBase:: |
protected | property | An array of custom translations suitable for drupal_rewrite_settings(). | |
BrowserTestBase:: |
protected | property | The database prefix of this test run. | |
BrowserTestBase:: |
protected | property | Mink session manager. | |
BrowserTestBase:: |
protected | property | ||
BrowserTestBase:: |
protected | property | 1 | |
BrowserTestBase:: |
protected | property | The original container. | |
BrowserTestBase:: |
protected | property | The original array of shutdown function callbacks. | |
BrowserTestBase:: |
protected | property | ||
BrowserTestBase:: |
protected | property | The profile to install as a basis for testing. | 39 |
BrowserTestBase:: |
protected | property | The app root. | |
BrowserTestBase:: |
protected | property | Browser tests are run in separate processes to prevent collisions between code that may be loaded by tests. | |
BrowserTestBase:: |
protected | property | Time limit in seconds for the test. | |
BrowserTestBase:: |
protected | property | The translation file directory for the test environment. | |
BrowserTestBase:: |
protected | function | Clean up the Simpletest environment. | |
BrowserTestBase:: |
protected | function | Configuration accessor for tests. Returns non-overridden configuration. | |
BrowserTestBase:: |
protected | function | Translates a CSS expression to its XPath equivalent. | |
BrowserTestBase:: |
protected | function | Gets the value of an HTTP response header. | |
BrowserTestBase:: |
protected | function | Returns all response headers. | |
BrowserTestBase:: |
public static | function | Ensures test files are deletable. | |
BrowserTestBase:: |
protected | function | Gets an instance of the default Mink driver. | |
BrowserTestBase:: |
protected | function | Gets the JavaScript drupalSettings variable for the currently-loaded page. | 1 |
BrowserTestBase:: |
protected | function | Obtain the HTTP client for the system under test. | |
BrowserTestBase:: |
protected | function | Get the Mink driver args from an environment variable, if it is set. Can be overridden in a derived class so it is possible to use a different value for a subset of tests, e.g. the JavaScript tests. | 1 |
BrowserTestBase:: |
protected | function | Helper function to get the options of select field. | |
BrowserTestBase:: |
protected | function |
Provides a Guzzle middleware handler to log every response received. Overrides BrowserHtmlDebugTrait:: |
|
BrowserTestBase:: |
public | function | Returns Mink session. | |
BrowserTestBase:: |
protected | function | Get session cookies from current session. | |
BrowserTestBase:: |
protected | function |
Retrieves the current calling line in the class under test. Overrides BrowserHtmlDebugTrait:: |
|
BrowserTestBase:: |
protected | function | Visits the front page when initializing Mink. | 3 |
BrowserTestBase:: |
protected | function | Initializes Mink sessions. | 1 |
BrowserTestBase:: |
public | function | Installs Drupal into the Simpletest site. | 1 |
BrowserTestBase:: |
protected | function | Registers additional Mink sessions. | |
BrowserTestBase:: |
protected | function | Transforms a nested array into a flat array suitable for drupalPostForm(). | |
BrowserTestBase:: |
protected | function | Performs an xpath search on the contents of the internal browser. | |
BrowserTestBase:: |
public | function | 1 | |
BrowserTestBase:: |
public | function | Prevents serializing any properties. | |
ConfigTestTrait:: |
protected | function | Returns a ConfigImporter object to import test configuration. | |
ConfigTestTrait:: |
protected | function | Copies configuration objects from source storage to target storage. | |
ContentTypeCreationTrait:: |
protected | function | Creates a custom content type based on default settings. Aliased as: drupalCreateContentType | 1 |
FunctionalTestSetupTrait:: |
protected | property | The flag to set 'apcu_ensure_unique_prefix' setting. | 1 |
FunctionalTestSetupTrait:: |
protected | property | The class loader to use for installation and initialization of setup. | |
FunctionalTestSetupTrait:: |
protected | property | The config directories used in this test. | |
FunctionalTestSetupTrait:: |
protected | property | The "#1" admin user. | |
FunctionalTestSetupTrait:: |
protected | function | Execute the non-interactive installer. | 1 |
FunctionalTestSetupTrait:: |
protected | function | Returns all supported database driver installer objects. | |
FunctionalTestSetupTrait:: |
protected | function | Initialize various configurations post-installation. | 2 |
FunctionalTestSetupTrait:: |
protected | function | Initializes the kernel after installation. | |
FunctionalTestSetupTrait:: |
protected | function | Initialize settings created during install. | |
FunctionalTestSetupTrait:: |
protected | function | Initializes user 1 for the site to be installed. | |
FunctionalTestSetupTrait:: |
protected | function | Installs the default theme defined by `static::$defaultTheme` when needed. | |
FunctionalTestSetupTrait:: |
protected | function | Install modules defined by `static::$modules`. | 1 |
FunctionalTestSetupTrait:: |
protected | function | Returns the parameters that will be used when Simpletest installs Drupal. | 9 |
FunctionalTestSetupTrait:: |
protected | function | Prepares the current environment for running the test. | 23 |
FunctionalTestSetupTrait:: |
protected | function | Creates a mock request and sets it on the generator. | |
FunctionalTestSetupTrait:: |
protected | function | Prepares site settings and services before installation. | 2 |
FunctionalTestSetupTrait:: |
protected | function | Resets and rebuilds the environment after setup. | |
FunctionalTestSetupTrait:: |
protected | function | Rebuilds \Drupal::getContainer(). | |
FunctionalTestSetupTrait:: |
protected | function | Resets all data structures after having enabled new modules. | |
FunctionalTestSetupTrait:: |
protected | function | Changes parameters in the services.yml file. | |
FunctionalTestSetupTrait:: |
protected | function | Sets up the base URL based upon the environment variable. | |
FunctionalTestSetupTrait:: |
protected | function | Rewrites the settings.php file of the test site. | |
NodeCreationTrait:: |
protected | function | Creates a node based on default settings. Aliased as: drupalCreateNode | |
NodeCreationTrait:: |
public | function | Get a node from the database based on its title. Aliased as: drupalGetNodeByTitle | |
PhpunitCompatibilityTrait:: |
public | function | Returns a mock object for the specified class using the available method. | |
PhpunitCompatibilityTrait:: |
public | function | Compatibility layer for PHPUnit 6 to support PHPUnit 4 code. | |
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. | |
RefreshVariablesTrait:: |
protected | function | Refreshes in-memory configuration and state information. | 3 |
S3fsTest:: |
protected static | property |
Modules to enable. Overrides S3fsTestBase:: |
|
S3fsTest:: |
private | function | Create and execute a S3fsRefreshCacheBatch job. | |
S3fsTest:: |
protected static | function | File delete wrapper that returns result. | |
S3fsTest:: |
public | function | Test the cache refresh. | |
S3fsTest:: |
public | function | Test the image derivative functionality. | |
S3fsTest:: |
public | function | Coverage test for the stream wrapper. | |
S3fsTestBase:: |
protected | property | S3 Credentials provided and bucket exists. | |
S3fsTestBase:: |
protected | property | The database connection. | |
S3fsTestBase:: |
protected | property |
The theme to install as the default for testing. Overrides BrowserTestBase:: |
1 |
S3fsTestBase:: |
protected | property | Folder name to use for placing tests files. | |
S3fsTestBase:: |
protected | property | Full base key path for tests folder. | |
S3fsTestBase:: |
protected | property | URI for accessing the data via StreamWrapper. | |
S3fsTestBase:: |
protected | property | The AWS SDK for PHP S3Client object. | |
S3fsTestBase:: |
protected | property | The s3fs module config. | |
S3fsTestBase:: |
protected | property | The AWS SDK for PHP S3Client object. | |
S3fsTestBase:: |
protected | function | Converts s3fs config to an array. | |
S3fsTestBase:: |
protected | function |
Overrides BrowserTestBase:: |
2 |
S3fsTestBase:: |
protected | function |
Clean up S3 folder. Overrides BrowserTestBase:: |
|
SessionTestTrait:: |
protected | property | The name of the session cookie. | |
SessionTestTrait:: |
protected | function | Generates a session cookie name. | |
SessionTestTrait:: |
protected | function | Returns the session name in use on the child site. | |
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. | |
TestSetupTrait:: |
protected static | property | An array of config object names that are excluded from schema checking. | |
TestSetupTrait:: |
protected | property | The dependency injection container used in the test. | |
TestSetupTrait:: |
protected | property | The DrupalKernel instance used in the test. | |
TestSetupTrait:: |
protected | property | The site directory of the original parent site. | |
TestSetupTrait:: |
protected | property | The private file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The public file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The site directory of this test run. | |
TestSetupTrait:: |
protected | property | Set to TRUE to strict check all configuration saved. | 2 |
TestSetupTrait:: |
protected | property | The temporary file directory for the test environment. | |
TestSetupTrait:: |
protected | property | The test run ID. | |
TestSetupTrait:: |
protected | function | Changes the database connection to the prefixed one. | |
TestSetupTrait:: |
protected | function | Gets the config schema exclusions for this test. | |
TestSetupTrait:: |
public static | function | Returns the database connection to the site running Simpletest. | |
TestSetupTrait:: |
protected | function | Generates a database prefix for running tests. | 2 |
UiHelperTrait:: |
protected | property | The current user logged in using the Mink controlled browser. | |
UiHelperTrait:: |
protected | property | The number of meta refresh redirects to follow, or NULL if unlimited. | |
UiHelperTrait:: |
protected | property | The number of meta refresh redirects followed during ::drupalGet(). | |
UiHelperTrait:: |
public | function | Returns WebAssert object. | 1 |
UiHelperTrait:: |
protected | function | Builds an a absolute URL from a system path or a URL object. | |
UiHelperTrait:: |
protected | function | Checks for meta refresh tag and if found call drupalGet() recursively. | |
UiHelperTrait:: |
protected | function | Clicks the element with the given CSS selector. | |
UiHelperTrait:: |
protected | function | Follows a link by complete name. | |
UiHelperTrait:: |
protected | function | Searches elements using a CSS selector in the raw content. | |
UiHelperTrait:: |
protected | function | Retrieves a Drupal path or an absolute path. | 3 |
UiHelperTrait:: |
protected | function | Logs in a user using the Mink controlled browser. | |
UiHelperTrait:: |
protected | function | Logs a user out of the Mink controlled browser and confirms. | |
UiHelperTrait:: |
protected | function | Executes a form submission. | |
UiHelperTrait:: |
protected | function | Returns whether a given user account is logged in. | |
UiHelperTrait:: |
protected | function | Takes a path and returns an absolute path. | |
UiHelperTrait:: |
protected | function | Retrieves the plain-text content from the current page. | |
UiHelperTrait:: |
protected | function | Get the current URL from the browser. | |
UiHelperTrait:: |
protected | function | Prepare for a request to testing site. | 1 |
UiHelperTrait:: |
protected | function | Fills and submits a form. | |
UserCreationTrait:: |
protected | function | Checks whether a given list of permission names is valid. | |
UserCreationTrait:: |
protected | function | Creates an administrative role. | |
UserCreationTrait:: |
protected | function | Creates a role with specified permissions. Aliased as: drupalCreateRole | |
UserCreationTrait:: |
protected | function | Create a user with a given set of permissions. Aliased as: drupalCreateUser | |
UserCreationTrait:: |
protected | function | Grant permissions to a user role. | |
UserCreationTrait:: |
protected | function | Switch the current logged in user. | |
UserCreationTrait:: |
protected | function | Creates a random user account and sets it as current user. | |
XdebugRequestTrait:: |
protected | function | Adds xdebug cookies, from request setup. |