Installation requirements
PHP, Composer, extensions, and the two installation paths.
On this page
Requirements
Use PHP 8.4+ and Composer. Loom's repository quick start targets Linux, macOS, or WSL2.
Required PHP extensions are pdo, mbstring, json, and openssl. Add the PDO driver for your database when using SQLite, MySQL, or PostgreSQL. File-backed content does not require a database.
Optional capabilities need additional extensions:
| Capability | Extension |
|---|---|
| HTTP client | curl |
| Redis cache | redis |
| APCu cache | apcu |
Markdown requires a parser package. The installer offers CommonMark, Parsedown, or HTML-only content.
Start from the repository
git clone https://github.com/anvyr/loom.git
cd loom
./install.sh
Follow Your first page for the rest of the walkthrough. The installer performs setup; cloning the repository alone does not install dependencies.
Use Loom as a package
For an application that owns its bootstrap and directory structure:
composer require anvyr/loom:^1.0
This installs the framework package, not a ready-made application. Your project must provide its HTTP entry point, bootstrap, configuration, content, and views. The source repository contains the bootstrap and public entry point to inspect.
Check the environment
From a configured application root:
php loom diagnose
php loom diagnose --json
Use CLI diagnostics to inspect configuration and page discovery.