Extending / Filesystem Layer / Overview of Bolt's Filesystem

Note: You are currently reading the documentation for Bolt 3.7. Looking for the documentation for Bolt 5.2 instead?

Bolt uses a visualised filesystem layer, built using Flysystem.

Each filesystem is registered with the Filesystem Manager on what are referred to as a "mount point". These mount points include:

• cache — User's cache mount point
• config — User's config mount point
• extensions — User's extension mount point
• extensions_config — User's extension config mount point
• files — User's files mount point
• themes — User's extension mount point
• web — User's web root mount point

Requesting a named, valid, mount point from the Filesystem Manager will return a filesystem.

Inside each filesystem are a group of files and directories, that can be created, read, updated, and deleted, via the mount point's filesystem object.

So the interaction with files & directories generally follows the code path

Filesystem Manager service -> \Bolt\Filesystem\FilesystemInterface mount point object -> \Bolt\Filesystem\Handler\FileInterface or \Bolt\Filesystem\Handler\DirectoryInterface object

For more details on using these, refer to the following sections:

• Filesystem Manager service
• Filesystems
  • Working with files
  • Working with directories
  • Using file type handlers