You are here

function file_requirements in Zircon Profile 8.0

Same name and namespace in other branches
  1. 8 core/modules/file/file.install \file_requirements()

Implements hook_requirements().

Display information about getting upload progress bars working.

File

core/modules/file/file.install, line 65
Install, update and uninstall functions for File module.

Code

function file_requirements($phase) {
  $requirements = array();

  // Check the server's ability to indicate upload progress.
  if ($phase == 'runtime') {
    $description = NULL;
    $implementation = file_progress_implementation();
    $server_software = \Drupal::request()->server
      ->get('SERVER_SOFTWARE');

    // Test the web server identity.
    if (preg_match("/Nginx/i", $server_software)) {
      $is_nginx = TRUE;
      $is_apache = FALSE;
      $fastcgi = FALSE;
    }
    elseif (preg_match("/Apache/i", $server_software)) {
      $is_nginx = FALSE;
      $is_apache = TRUE;
      $fastcgi = strpos($server_software, 'mod_fastcgi') !== FALSE || strpos($server_software, 'mod_fcgi') !== FALSE;
    }
    else {
      $is_nginx = FALSE;
      $is_apache = FALSE;
      $fastcgi = FALSE;
    }
    if (!$is_apache && !$is_nginx) {
      $value = t('Not enabled');
      $description = t('Your server is not capable of displaying file upload progress. File upload progress requires an Apache server running PHP with mod_php or Nginx with PHP-FPM.');
    }
    elseif ($fastcgi) {
      $value = t('Not enabled');
      $description = t('Your server is not capable of displaying file upload progress. File upload progress requires PHP be run with mod_php or PHP-FPM and not as FastCGI.');
    }
    elseif (!$implementation && extension_loaded('apc')) {
      $value = t('Not enabled');
      $description = t('Your server is capable of displaying file upload progress through APC, but it is not enabled. Add <code>apc.rfc1867 = 1</code> to your php.ini configuration. Alternatively, it is recommended to use <a href=":url">PECL uploadprogress</a>, which supports more than one simultaneous upload.', array(
        ':url' => 'http://pecl.php.net/package/uploadprogress',
      ));
    }
    elseif (!$implementation) {
      $value = t('Not enabled');
      $description = t('Your server is capable of displaying file upload progress, but does not have the required libraries. It is recommended to install the <a href=":uploadprogress_url">PECL uploadprogress library</a> (preferred) or to install <a href=":apc_url">APC</a>.', array(
        ':uploadprogress_url' => 'http://pecl.php.net/package/uploadprogress',
        ':apc_url' => 'http://php.net/apc',
      ));
    }
    elseif ($implementation == 'apc') {
      $value = t('Enabled (<a href=":url">APC RFC1867</a>)', array(
        ':url' => 'http://php.net/manual/apc.configuration.php#ini.apc.rfc1867',
      ));
      $description = t('Your server is capable of displaying file upload progress using APC RFC1867. Note that only one upload at a time is supported. It is recommended to use the <a href=":url">PECL uploadprogress library</a> if possible.', array(
        ':url' => 'http://pecl.php.net/package/uploadprogress',
      ));
    }
    elseif ($implementation == 'uploadprogress') {
      $value = t('Enabled (<a href=":url">PECL uploadprogress</a>)', array(
        ':url' => 'http://pecl.php.net/package/uploadprogress',
      ));
    }
    $requirements['file_progress'] = array(
      'title' => t('Upload progress'),
      'value' => $value,
      'description' => $description,
    );
  }
  return $requirements;
}