function file_requirements

Same name in other branches
  1. 7.x modules/file/file.install \file_requirements()
  2. 8.9.x core/modules/file/file.install \file_requirements()
  3. 10 core/modules/file/file.install \file_requirements()
  4. 11.x 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

Code

function file_requirements($phase) {
    $requirements = [];
    // Check the server's ability to indicate upload progress.
    if ($phase == 'runtime') {
        $description = NULL;
        $implementation = file_progress_implementation();
        // The environment variable might be missing. Fallback to an empty string to
        // prevent passing NULL to preg_match(), a few lines later.
        $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) {
            $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="http://pecl.php.net/package/uploadprogress">PECL uploadprogress library</a>.');
        }
        elseif ($implementation == 'uploadprogress') {
            $value = t('Enabled (<a href="http://pecl.php.net/package/uploadprogress">PECL uploadprogress</a>)');
        }
        $requirements['file_progress'] = [
            'title' => t('Upload progress'),
            'value' => $value,
            'description' => $description,
        ];
    }
    return $requirements;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.