You are here

function FileTestCase::assertFilePermissions in Drupal 7

Helper function to test the permissions of a file.

Parameters

$filepath: String file path.

$expected_mode: Octal integer like 0664 or 0777.

$message: Optional message.

4 calls to FileTestCase::assertFilePermissions()
FileUnmanagedCopyTest::testNormal in modules/simpletest/tests/file.test
Copy a normal file.
FileUnmanagedCopyTest::testOverwriteSelf in modules/simpletest/tests/file.test
Copy a file onto itself.
FileUnmanagedMoveTest::testNormal in modules/simpletest/tests/file.test
Move a normal file.
FileUnmanagedSaveDataTest::testFileSaveData in modules/simpletest/tests/file.test
Test the file_unmanaged_save_data() function.

File

modules/simpletest/tests/file.test, line 105
This provides SimpleTests for the core file handling functionality. These include FileValidateTest and FileSaveTest.

Class

FileTestCase
Base class for file tests that adds some additional file specific assertions and helper functions.

Code

function assertFilePermissions($filepath, $expected_mode, $message = NULL) {

  // Clear out PHP's file stat cache to be sure we see the current value.
  clearstatcache();

  // Mask out all but the last three octets.
  $actual_mode = fileperms($filepath) & 0777;

  // PHP on Windows has limited support for file permissions. Usually each of
  // "user", "group" and "other" use one octal digit (3 bits) to represent the
  // read/write/execute bits. On Windows, chmod() ignores the "group" and
  // "other" bits, and fileperms() returns the "user" bits in all three
  // positions. $expected_mode is updated to reflect this.
  if (substr(PHP_OS, 0, 3) == 'WIN') {

    // Reset the "group" and "other" bits.
    $expected_mode = $expected_mode & 0700;

    // Shift the "user" bits to the "group" and "other" positions also.
    $expected_mode = $expected_mode | $expected_mode >> 3 | $expected_mode >> 6;
  }
  if (!isset($message)) {
    $message = t('Expected file permission to be %expected, actually were %actual.', array(
      '%actual' => decoct($actual_mode),
      '%expected' => decoct($expected_mode),
    ));
  }
  $this
    ->assertEqual($actual_mode, $expected_mode, $message);
}