README

Get information about files. Focused on exotic file types.

Supported Filetypes

Restore Extension From Content

Can scan files to try to recognize the type and its file extension. Works for a ton of types.

CLI Usage

This package contains a script (fileinfo) that can be run from the CLI.
Usage: fileinfo [options] <file> [<file>...] [options]
See fileinfo --help for more information

List of supported options:

Does work with multiple input files (fileinfo samples/*), however, the output differs and might not be considered stable when multiple files are shown.

Development Notes

Adding a new FileInfoExtractor

1. Create a new class in src/InfoExtractor/Extractor/[…]
2. Implement InfoExtractor
   • Try to use keys from InfoCommonKeys
3. Create a new KnownExtension and Context
4. Register it in DefaultDefinition

Adding a new ExtensionReader

For simple, non-offset magic bytes, add an entry to FileExtensionMagicByteSupplier::DEFAULT_SIMPLE_MAGIC.

For more complex ones:

1. Create a new class in src/FileExtension/Reader/[…]
2. Implement FileExtensionMagicByteReader
3. Register it in FileExtensionMagicByteSupplier::DEFAULT_READERS

Acquiring sample files

Run the following command and give it an extension: bin/download-samples.php $extension
--all can be used to download all available samples.

Note that not all extensions have samples to download, due to practical or copyright reasons.

Local docker testing

dcd run --rm php bin/fileinfo ./samples/$file