peklaiho / madlisp

v1.1.0 2026-08-19 13:25 UTC

Requires

• php: >=7.4

Requires (Dev)

• phpunit/phpunit: ^9.5

MIT

• Pekka Laiho

• lisp

Published on Packagist.org on 2026-08-20 06:11 UTC

README

MadLisp is a Lisp interpreter written in PHP.

Requirements

The project requires PHP 8.3 or newer and Composer.

Quickstart

Create a new directory and require the project using composer:

$ mkdir mylisp
$ cd mylisp
$ composer require peklaiho/madlisp

Use the vendor/bin/madlisp executable to start the interpreter. Start the REPL with the -r option:

$ vendor/bin/madlisp -r
>

You can evaluate Lisp code interactively inside the REPL:

> (+ 1 2 3)
6

Alternatively you can evaluate a file that contains Lisp code:

$ echo "(+ 1 2 3)" > mylisp.mad
$ vendor/bin/madlisp mylisp.mad
6

Documentation

The full documentation is available on the project website.

Status

The language seems stable at this point so I am releasing it as 1.0. Please report any issues.

License

MIT