function FileSystem::prepareDirectory

File

core/lib/Drupal/Core/File/FileSystem.php, line 481

Class

FileSystem

Provides helpers to operate on files and stream wrappers.

Namespace

Code

public function prepareDirectory(&$directory, $options = self::MODIFY_PERMISSIONS) {
    if (!$this->streamWrapperManager
        ->isValidUri($directory)) {
        // Only trim if we're not dealing with a stream.
        $directory = rtrim($directory, '/\\');
    }
    if (!is_dir($directory)) {
        if (!($options & static::CREATE_DIRECTORY)) {
            return FALSE;
        }
        // Let mkdir() recursively create directories and use the default
        // directory permissions.
        $success = @$this->mkdir($directory, NULL, TRUE);
        if ($success) {
            return TRUE;
        }
        // If the operation failed, check again if the directory was created
        // by another process/server, only report a failure if not. In this case
        // we still need to ensure the directory is writable.
        if (!is_dir($directory)) {
            return FALSE;
        }
    }
    $writable = is_writable($directory);
    if (!$writable && $options & static::MODIFY_PERMISSIONS) {
        return $this->chmod($directory);
    }
    return $writable;
}