File interface in Zircon Profile 8
Same name and namespace in other branches
Common file handling functions.
Fields on the file entity:
- fid: File ID
- uid: The {users}.uid of the user who is associated with the file.
- filename: Name of the file with no path components. This may differ from the basename of the filepath if the file is renamed to avoid overwriting an existing file.
- uri: URI of the file.
- filemime: The file's MIME type.
- filesize: The size of the file in bytes.
- status: A bitmapped field indicating the status of the file. The first 8 bits are reserved for Drupal core. The least significant bit indicates temporary (0) or permanent (1). Temporary files will be removed during cron runs if they are older than the configuration value "system.file.temporary_maximum_age", and if clean-up is enabled. Permanent files will not be removed.
- timestamp: UNIX timestamp for the date the file was added to the database.
File
- core/
includes/ file.inc, line 32 - API for handling file uploads and server file management.
Functions
Name | Location | Description |
---|---|---|
drupal_basename Deprecated |
core/ |
Gets the filename from a given path. |
drupal_chmod Deprecated |
core/ |
Sets the permissions on a file or directory. |
drupal_dirname Deprecated |
core/ |
Gets the name of the directory from a given path. |
drupal_mkdir Deprecated |
core/ |
Creates a directory, optionally creating missing components in the path to the directory. |
drupal_move_uploaded_file Deprecated |
core/ |
Moves an uploaded file to a new location. |
drupal_realpath Deprecated |
core/ |
Resolves the absolute filepath of a local URI or filepath. |
drupal_rmdir Deprecated |
core/ |
Removes a directory. |
drupal_tempnam Deprecated |
core/ |
Creates a file with a unique filename in the specified directory. |
drupal_unlink Deprecated |
core/ |
Deletes a file. |
file_build_uri |
core/ |
Constructs a URI to Drupal's default files location given a relative path. |
file_create_filename |
core/ |
Creates a full file path from a directory and filename. |
file_create_url |
core/ |
Creates a web-accessible URL for a stream to an external or local file. |
file_default_scheme |
core/ |
Gets the default file stream implementation. |
file_delete |
core/ |
Deletes a file and its database record. |
file_delete_multiple |
core/ |
Deletes files. |
file_destination |
core/ |
Determines the destination path for a file. |
file_directory_os_temp |
core/ |
Discovers a writable system-appropriate temporary directory. |
file_directory_temp |
core/ |
Gets and sets the path of the configured temporary directory. |
file_ensure_htaccess |
core/ |
Creates a .htaccess file in each Drupal files directory if it is missing. |
file_get_file_references |
core/ |
Retrieves a list of references to a file. |
file_htaccess_lines Deprecated |
core/ |
Returns the standard .htaccess lines that Drupal writes to file directories. |
file_munge_filename |
core/ |
Modifies a filename as needed for security purposes. |
file_prepare_directory |
core/ |
Checks that the directory exists and is writable. |
file_save_htaccess |
core/ |
Creates a .htaccess file in the given directory. |
file_scan_directory |
core/ |
Finds all files that match a given mask in a given directory. |
file_stream_wrapper_uri_normalize |
core/ |
Normalizes a URI by making it syntactically correct. |
file_stream_wrapper_valid_scheme Deprecated |
core/ |
Checks that the scheme of a stream URI is valid. |
file_unmanaged_copy |
core/ |
Copies a file to a new location without invoking the file API. |
file_unmanaged_delete |
core/ |
Deletes a file without database changes or hook invocations. |
file_unmanaged_delete_recursive |
core/ |
Deletes all files and directories in the specified filepath recursively. |
file_unmanaged_move |
core/ |
Moves a file to a new location without database changes or hook invocation. |
file_unmanaged_save_data |
core/ |
Saves a file to the specified destination without invoking file API. |
file_unmunge_filename |
core/ |
Undoes the effect of file_munge_filename(). |
file_upload_max_size |
core/ |
Determines the maximum file upload size by querying the PHP settings. |
file_uri_scheme Deprecated |
core/ |
Returns the scheme of a URI (e.g. a stream). |
file_uri_target |
core/ |
Returns the part of a URI after the schema. |
file_url_transform_relative |
core/ |
Transforms an absolute URL of a local file to a relative URL. |
file_valid_uri |
core/ |
Determines whether the URI has a valid scheme for file API operations. |
Constants
Name | Location | Description |
---|---|---|
FILE_CREATE_DIRECTORY |
core/ |
Flag used by file_prepare_directory() -- create directory if not present. |
FILE_EXISTS_ERROR |
core/ |
Flag for dealing with existing files: Do nothing and return FALSE. |
FILE_EXISTS_RENAME |
core/ |
Flag for dealing with existing files: Appends number until name is unique. |
FILE_EXISTS_REPLACE |
core/ |
Flag for dealing with existing files: Replace the existing file. |
FILE_MODIFY_PERMISSIONS |
core/ |
Flag used by file_prepare_directory() -- file permissions may be changed. |
FILE_STATUS_PERMANENT |
core/ |
Indicates that the file is permanent and should not be deleted. |