# Loom Spinner
An environment management application for PHP developers.
Allows you to spin up minimal, sensibly pre-configured Docker
containers for PHP development, for a fast, consistent and smooth development experience.
Simple commands you can run from anywhere on your system.
# The Lowdown
Create pre-configured Docker environments on a project-by-project basis, tailored specifically for developing PHP
applications. The default setup gives you an environment with:
- PHP 8.4 (with XDebug + OpCache)
- Nginx
- SQLite3
- NodeJS 23 (Node, NPM + NPX)
Your project is mounted to the PHP container and your projects `public` directory is served via Nginx at
`http://localhost:`. Your container is also accessible via the command line, so you can run unit tests
or other commands inside your sandboxed environment.
**Loom Spinner CLI is currently in the early stages of development and thus only has limited features, such as only
allowing you to use a SQLite database. More options will be added in subsequent releases.**
# Installation
Pre-Requisites:
- Composer
- Docker Desktop/Docker Engine
```shell
composer global require loomlabs/loom-spinner-cli
```
# Usage
Start your (Docker) engines, then:
```shell
cd /path/to/my-project
loom spin:up my-project .
```
Check your new containers ports by inspecting the containers in Docker Desktop or running `docker ps`.
Your projects public directory is now available at `http://localhost:`. Voila!
## What Else?
Want to stop your containers?
```shell
loom spin:stop my-project
```
Start them again?
```shell
loom spin:start my-project
```
Destroy your containers?
```shell
loom spin:down my-project
```
What's more, `loom` can be configured further with a simple set of configuration options. For a more detailed
quick-start guide or for more information on using and configuring **Loom Spinner CLI**, please consult the wiki.
Happy spinning! 🧵