PHPackages                             ryannerd/willow - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. ryannerd/willow

ActiveProject[Admin Panels](/categories/admin)

ryannerd/willow
===============

Willow Framework for creating ORM/RESTful APIs

3.0.2(4y ago)202165[9 issues](https://github.com/RyanNerd/willow/issues)[1 PRs](https://github.com/RyanNerd/willow/pulls)MITPHPPHP ^7.4 | ^8.0CI failing

Since May 8Pushed 4y ago5 watchersCompare

[ Source](https://github.com/RyanNerd/willow)[ Packagist](https://packagist.org/packages/ryannerd/willow)[ RSS](/packages/ryannerd-willow/feed)WikiDiscussions 3.x Synced 3d ago

READMEChangelog (10)Dependencies (15)Versions (74)Used By (0)

🌳 Willow Framework 🌳
====================

[](#-willow-framework-)

[![License: MIT](https://camo.githubusercontent.com/fdf2982b9f5d7489dcf44570e714e3a15fce6253e0cc6b5aa61a075aac2ff71b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d79656c6c6f772e737667)](https://opensource.org/licenses/MIT)

> [![willow](https://raw.githubusercontent.com/RyanNerd/willow/master/willow.png)](https://willow.plexie.com/app/#/public/project/f66cdc9e-18dd-419c-8575-0c8901152cd3) Willow is a type a girl who is beautiful and amazing and is kinda a special person and loved by everyone around her most willows can be your best of friends she's up for anything and she's loves anything fun you throw at her...

~ [Urban Dictionary](https://www.urbandictionary.com/define.php?term=Willow)

For developers, Willow is an *opinionated* PHP framework used to quickly create CRUD based RESTful APIs.

Willow is a marriage 💒 between [Slim](http://slimframework.com) and [Eloquent ORM](https://github.com/illuminate/database)with [Robo](http://robo.li/) as your [wedding planner](https://en.wikipedia.org/wiki/Wedding_planner).

For instructions and getting started see the [Willow Framework User Guide](https://www.notion.so/Willow-Framework-Users-Guide-bf56317580884ccd95ed8d3889f83c72)

Willow works best as a framework in this situation:

- You need to quickly spin up a [RESTful](https://restfulapi.net/) [datacentric](https://www.codecademy.com/articles/what-is-crud) API
- You have defined your database with your tables already in place
- You are just starting your project and need to *hit the ground running*

### 📃 Requirements

[](#-requirements)

- PHP 7.4+ (Willow 3.0+)
- Databases:
    - MySQL 5.6+
    - SQLite3
    - Postgres (untested)
    - MSSQL (untested)
- [Composer](https://getcomposer.org) (For Willow to work best this must be installed globally)

NotesWillow will work on Windows only if running in the Windows Subsystem for Linux (WSL)Previous versions of Willow are no longer supported (sorry I don't have the bandwidth to support these)### 💾 Installation

[](#-installation)

To install Willow run:

```
composer create-project --ignore-platform-reqs ryannerd/willow:^3 [your-project-name]
cd [your-project-name]
```

This will create a skeleton Willow project. Willow tries to symlink to [robo](https://robo.li/) You can then use Willow (robo) commands to build your app.

### Demo

[](#demo)

```
./willow sample
```

The result in your browser should look something like this:

```
{
  "authenticated": true,
  "success": true,
  "status": 200,
  "data": {
    "id": "hello-world"
  },
  "missing": [ ],
  "message": "Sample test",
  "timestamp": 1556903905
}
```

### Willow (robo) Commands

[](#willow-robo-commands)

```
# Documentation and demo
./willow docs   # bring up the documentation web page
./willow list   # list all available Willow commands
./willow sample # launch the sample API in a web browser
./willow banner # show the Willow introductory banner

# Willow core commands
./willow make   # Connects to your database and builds routes, controllers, models, actions, etc.
./willow reset  # Resets the project back to factory defaults
./willow eject  # Removes the sample artifacts from the project

# Database commands
./willow tables  # list all the tables in the database
./willow details # Show details (column names and types) of a selected table
```

### Contributing

[](#contributing)

Do this:

1. Fork this repo
2. Make changes on your fork
3. Push a PR

Note: the main branch isn't `master` it's `3.x` which is where you want to push your PR.

Special thanks to:

[The Slim Framework](https://slimframework.com)

[Illuminate / Eloquent ORM](https://github.com/illuminate/database)

Willow icon made by [Freepik](https://www.freepik.com/ "Freepik")from [www.flaticon.com](https://www.flaticon.com/ "Flaticon")is licensed by [CC 3.0 BY](http://creativecommons.org/licenses/by/3.0/ "Creative Commons BY 3.0")

###  Health Score

35

—

LowBetter than 79% of packages

Maintenance11

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity79

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~11 days

Recently: every ~5 days

Total

71

Last Release

1796d ago

Major Versions

0.1.7 → 1.0.02020-01-01

1.1.4 → 2.0.12020-02-19

1.1.5 → 2.0.02020-02-26

1.x-dev → 2.0.62021-05-21

2.x-dev → 3.0.02021-06-13

PHP version history (3 changes)0.0.0PHP ^7.1

2.0.0PHP ^7.4

2.0.6PHP ^7.4 | ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/5910f1b7f153bb1cbc0ebb53f3ce905d1dc4440d374419fbfc6418b5cef46c56?d=identicon)[RyanNerd](/maintainers/RyanNerd)

---

Top Contributors

[![RyanNerd](https://avatars.githubusercontent.com/u/10543911?v=4)](https://github.com/RyanNerd "RyanNerd (290 commits)")

---

Tags

crudcrud-apiframework-phprestful-api

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/ryannerd-willow/health.svg)

```
[![Health](https://phpackages.com/badges/ryannerd-willow/health.svg)](https://phpackages.com/packages/ryannerd-willow)
```

###  Alternatives

[phlak/directory-lister

PHP directory lister

2.5k1.4k](/packages/phlak-directory-lister)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[neos/flow

Flow Application Framework

862.0M451](/packages/neos-flow)[neos/flow-development-collection

Flow packages in a joined repository for pull requests.

144179.3k3](/packages/neos-flow-development-collection)[shopware/administration

Administration frontend for the Shopware Core

413.9M75](/packages/shopware-administration)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)