function file_htaccess_lines

7.x file.inc file_htaccess_lines($private = TRUE)
6.x file.inc file_htaccess_lines()

Returns the standard .htaccess lines that Drupal writes to file directories.

Parameters

$private: (Optional) Set to FALSE to return the .htaccess lines for an open and public directory. The default is TRUE, which returns the .htaccess lines for a private and protected directory.

Return value

A string representing the desired contents of the .htaccess file.

See also

file_create_htaccess()

Related topics

File interface
Common file handling functions.
2 calls to file_htaccess_lines()
FileDirectoryTest::testFileCheckDirectoryHandling in drupal-7.x/modules/simpletest/tests/file.test
Test directory handling functions.
file_create_htaccess in drupal-7.x/includes/file.inc
Creates a .htaccess file in the given directory.

File

drupal-7.x/includes/file.inc, line 516
API for handling file uploads and server file management.

Code

function file_htaccess_lines($private = TRUE) {
  $lines = <<<EOF
# Turn off all options we don't need.
Options None
Options +FollowSymLinks

# Set the catch-all handler to prevent scripts from being executed.
SetHandler Drupal_Security_Do_Not_Remove_See_SA_2006_006
<Files *>
  # Override the handler again if we're run later in the evaluation list.
  SetHandler Drupal_Security_Do_Not_Remove_See_SA_2013_003
</Files>

# If we know how to do it safely, disable the PHP engine entirely.
<IfModule mod_php5.c>
  php_flag engine off
</IfModule>
EOF;

  if ($private) {
    $lines = "Deny from all\n\n" . $lines;
  }

  return $lines;
}