file.install

Same filename in other branches
  1. 7.x modules/file/file.install
  2. 9 core/modules/file/file.install
  3. 8.9.x core/modules/file/file.install
  4. 10 core/modules/file/file.install

Install, update and uninstall functions for File module.

File

core/modules/file/file.install

View source
<?php


/**
 * @file
 * Install, update and uninstall functions for File module.
 */

/**
 * Implements hook_schema().
 */
function file_schema() {
    $schema['file_usage'] = [
        'description' => 'Track where a file is used.',
        'fields' => [
            'fid' => [
                'description' => 'File ID.',
                'type' => 'int',
                'unsigned' => TRUE,
                'not null' => TRUE,
            ],
            'module' => [
                'description' => 'The name of the module that is using the file.',
                'type' => 'varchar_ascii',
                'length' => DRUPAL_EXTENSION_NAME_MAX_LENGTH,
                'not null' => TRUE,
                'default' => '',
            ],
            'type' => [
                'description' => 'The name of the object type in which the file is used.',
                'type' => 'varchar_ascii',
                'length' => 64,
                'not null' => TRUE,
                'default' => '',
            ],
            'id' => [
                'description' => 'The primary key of the object using the file.',
                'type' => 'varchar_ascii',
                'length' => 64,
                'not null' => TRUE,
                'default' => 0,
            ],
            'count' => [
                'description' => 'The number of times this file is used by this object.',
                'type' => 'int',
                'unsigned' => TRUE,
                'not null' => TRUE,
                'default' => 0,
            ],
        ],
        'primary key' => [
            'fid',
            'type',
            'id',
            'module',
        ],
        'indexes' => [
            'type_id' => [
                'type',
                'id',
            ],
            'fid_count' => [
                'fid',
                'count',
            ],
            'fid_module' => [
                'fid',
                'module',
            ],
        ],
    ];
    return $schema;
}

/**
 * Implements hook_requirements().
 *
 * Display information about getting upload progress bars working.
 */
function file_requirements($phase) {
    $requirements = [];
    if ($phase != 'runtime') {
        return $requirements;
    }
    $server_software = \Drupal::request()->server
        ->get('SERVER_SOFTWARE', '');
    // Get the web server identity.
    $is_nginx = preg_match("/Nginx/i", $server_software);
    $is_apache = preg_match("/Apache/i", $server_software);
    $fastcgi = $is_apache && (str_contains($server_software, 'mod_fastcgi') || str_contains($server_software, 'mod_fcgi'));
    // Check the uploadprogress extension is loaded.
    if (extension_loaded('uploadprogress')) {
        $value = t('Enabled (<a href="http://pecl.php.net/package/uploadprogress">PECL uploadprogress</a>)');
        $description = NULL;
    }
    else {
        $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>.');
    }
    // Adjust the requirement depending on what the server supports.
    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.');
    }
    $requirements['file_progress'] = [
        'title' => t('Upload progress'),
        'value' => $value,
        'description' => $description,
    ];
    return $requirements;
}

/**
 * Implements hook_update_last_removed().
 */
function file_update_last_removed() : int {
    return 8700;
}

Functions

Title Deprecated Summary
file_requirements Implements hook_requirements().
file_schema Implements hook_schema().
file_update_last_removed Implements hook_update_last_removed().

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