diff --git a/docs/src/subsystems/php.md b/docs/src/subsystems/php.md
index 6eedfe74..418b1e87 100644
--- a/docs/src/subsystems/php.md
+++ b/docs/src/subsystems/php.md
@@ -1,11 +1,19 @@
 # PHP subsystem
 
-> !!! PHP support is a work in progress, and it is not yet usable (a
-> builder is missing). You can track the progress in
+> !!! PHP support is experimental. \
+> !!! You can track the progress in
 > [nix-community/dream2nix#240](https://github.com/nix-community/dream2nix/issues/240).
 
 This section documents the PHP subsystem.
 
+## Example
+
+An example of building [composer](https://github.com/composer/composer) using dream2nix.
+
+```nix
+{{#include ../../../examples/php_composer/flake.nix}}
+```
+
 ## Translators
 
 ### composer-lock (pure)