No description
Find a file
2025-04-24 10:22:52 +01:00
bin Update README, update composer.json 2025-04-24 03:15:08 +01:00
config Remove disable-node option due to node being installed in the php-fpm container by default 2025-04-24 01:12:48 +01:00
data Create basic project data structure from env template 2025-04-12 17:28:57 +01:00
src Remove disable-node option due to node being installed in the php-fpm container by default 2025-04-24 01:12:48 +01:00
.gitignore Nginx setup 2025-04-13 20:07:48 +01:00
composer.json Update README, update composer.json 2025-04-24 03:15:08 +01:00
header.jpg Add header to README 2025-04-24 03:51:17 +01:00
phpunit.xml Add phpunit config 2025-04-09 01:46:19 +01:00
README.md Update README 2025-04-24 10:22:52 +01:00

Loom Spinner CLI Header Image & Logo

Loom Spinner

Version 1.1.0

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:<nginx-port>. 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
composer global require loomlabs/loom-spinner-cli

Usage

Start your (Docker) engines, then:

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:<nginx-container-port>. Voila!

What Else?

Want to stop your containers?

loom spin:stop my-project

Start them again?

loom spin:start my-project

Destroy your containers?

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! 🧵