PHPackages                             cloudbase/loom-spinner - 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. [CLI &amp; Console](/categories/cli)
4. /
5. cloudbase/loom-spinner

ActiveLibrary[CLI &amp; Console](/categories/cli)

cloudbase/loom-spinner
======================

A simple command-line Docker environment spinner for PHP.

3.3.0(6mo ago)013[1 issues](https://github.com/Winning-Software/loom-spinner/issues)GPL-3.0-or-laterPHP

Since Apr 24Pushed 6mo agoCompare

[ Source](https://github.com/Winning-Software/loom-spinner)[ Packagist](https://packagist.org/packages/cloudbase/loom-spinner)[ RSS](/packages/cloudbase-loom-spinner/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (6)Versions (35)Used By (0)

Loom Spinner CLI
================

[](#loom-spinner-cli)

[![Version 3.3.0](https://camo.githubusercontent.com/4c0e721bce959df3076bb49176b35f54ae01ba82c471f8d8737d33c7059ff762/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d332e332e302d626c7565)](https://camo.githubusercontent.com/4c0e721bce959df3076bb49176b35f54ae01ba82c471f8d8737d33c7059ff762/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d332e332e302d626c7565)[![License GPL-3.0-or-later](https://camo.githubusercontent.com/1f081152ea1147a9fac48726615f330f4a74ce18c28d10e42bf4f62b9ecb6009/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c2d2d332e302d2d6f722d2d6c617465722d343061646263)](https://camo.githubusercontent.com/1f081152ea1147a9fac48726615f330f4a74ce18c28d10e42bf4f62b9ecb6009/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d47504c2d2d332e302d2d6f722d2d6c617465722d343061646263)

Loom Spinner is a streamlined environment management tool for PHP developers.

It makes launching minimal, pre-configured Docker containers effortless, providing a fast, consistent, and hassle-free workflow for your projects.

Run simple commands from anywhere on your system to manage your environments.

> This project is built for Linux and has not been fully tested on Windows or MacOS. Full Windows/MacOS support is planned for a future release.

At a Glance
===========

[](#at-a-glance)

Effortlessly create custom Docker environments for each of your PHP projects. A default Loom Spinner environment provides:

- **PHP 8.4** (with XDebug &amp; OpCache)
- **Nginx**
- **MySQL 9.3**
- **NodeJS 25** (Node, NPM, &amp; NPX)

Your project directory is automatically mounted into the PHP container, and the `public` directory is served via Nginx at:

```
https://{project-name}.app
```

You can access the container directly from your terminal to run tests or other commands in an isolated environment.

Installation
============

[](#installation)

**Requirements:**

- Composer
- Docker Desktop or Docker Engine

To install globally, run:

```
composer global require cloudbase/loom-spinner
```

> **Optional HTTPS/SSL Support**
>
> For prettified `https://{project-name}.app` URLs, install `mkcert` before using Loom Spinner.

Linux example:

```
sudo apt install mkcert libnss3-tools
mkcert -install
```

Quick Start
===========

[](#quick-start)

Spin up your project and add the hosts entry in a single sequence:

```
cd /path/to/my-project
loom spin:up my-project .
sudo loom env:hosts:add my-project
```

> ✅ This will create the Docker containers (PHP, Nginx, MySQL) and ensure your system can resolve for clean URLs.

Usage
=====

[](#usage)

Launch a new environment:

```
loom spin:up my-project /path/to/my-project
```

Or from the project directory:

```
cd /path/to/my-project
loom spin:up my-project .
```

Hosts Entry
-----------

[](#hosts-entry)

To access your project via the browser, add an entry to `/etc/hosts`:

```
sudo loom env:hosts:add my-project
```

Database Credentials
--------------------

[](#database-credentials)

Your default database credentials are:

UsernamePasswordrootdockerTo see which port your database container is using, run:

```
loom env:list
```

You can customise your credentials, see the [Configuration](https://github.com/CloudBaseHQ/loom-spinner/wiki/Configuration)section of the documentation for more details.

Managing Your Environment
-------------------------

[](#managing-your-environment)

ActionCommandStop containers`loom spin:stop my-project`Start containers`loom spin:start my-project`Attach to PHP container`loom spin:attach my-project`Destroy environment`loom spin:down my-project`List all environments`loom env:list`---

Happy spinning! 🧵

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance67

Regular maintenance activity

Popularity5

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 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 ~6 days

Total

32

Last Release

203d ago

Major Versions

1.5.2 → 2.0.02025-10-14

2.0.0 → 3.0.02025-10-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/7b90e8b50322861eede874ba8de6e5417bb734b25117d2dda5f8df2729942d81?d=identicon)[cloudbase](/maintainers/cloudbase)

---

Top Contributors

[![DanielWinning](https://avatars.githubusercontent.com/u/71671373?v=4)](https://github.com/DanielWinning "DanielWinning (138 commits)")

###  Code Quality

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/cloudbase-loom-spinner/health.svg)

```
[![Health](https://phpackages.com/badges/cloudbase-loom-spinner/health.svg)](https://phpackages.com/packages/cloudbase-loom-spinner)
```

###  Alternatives

[crunzphp/crunz

Schedule your tasks right from the code.

2292.0M6](/packages/crunzphp-crunz)[crazywhalecc/static-php-cli

Build single static PHP binary, with PHP project together, with popular extensions included.

1.8k13.9k](/packages/crazywhalecc-static-php-cli)[phpcr/phpcr-shell

Shell for PHPCR

721.3M8](/packages/phpcr-phpcr-shell)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[madewithlove/license-checker

CLI tool to verify allowed licenses for composer dependencies

54449.8k21](/packages/madewithlove-license-checker)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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