PHPackages                             rnab/soar - 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. [DevOps & Deployment](/categories/devops)
4. /
5. rnab/soar

ActiveLibrary[DevOps & Deployment](/categories/devops)

rnab/soar
=========

Manage php docker development environment

1.0.0(2mo ago)00MITShell

Since Mar 2Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/Roy-Nilsson-AB/soar)[ Packagist](https://packagist.org/packages/rnab/soar)[ RSS](/packages/rnab-soar/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Soar
====

[](#soar)

A bash wrapper around Docker Compose that simplifies PHP development workflows.

Soar provides convenient shortcuts for common tasks like running Symfony console commands, Magento CLI, Composer, database operations, and opening shells in containers. Any unrecognized command is passed directly to docker-compose.

Installation
------------

[](#installation)

Add the repository to your global Composer configuration:

```
composer global config repositories.soar vcs git@github.com:Roy-Nilsson-AB/soar.git
```

Then install the package:

```
composer global require rnab/soar
```

Add Composer's global bin directory to your PATH by adding this to your `~/.bashrc` or `~/.zshrc`:

```
export PATH="$HOME/.composer/vendor/bin:$PATH"
```

Then reload your shell or run `source ~/.bashrc`.

Quick Start
-----------

[](#quick-start)

Run soar from your project directory (where your `docker-compose.yml` is located):

```
soar up -d              # Start services
soar console cache:clear # Run Symfony command
soar shell              # Open shell in PHP container
soar db                 # Open MySQL client
```

Commands
--------

[](#commands)

CommandDescription`soar up -d`Start services in background`soar stop`Stop services`soar restart`Restart services`soar ps`Show container status`soar console `Run Symfony console command`soar magento `Run Magento CLI command`soar magento install`Install Magento with env vars`soar magento clean`Clear Magento generated files`soar composer `Run Composer`soar bin `Run vendor bin tool (phpunit, phpstan, etc.)`soar db`Open MySQL client`soar db import `Import SQL dump (supports .gz)`soar db dump`Export database`soar db exec ""`Execute SQL query`soar shell [container]`Open shell in container (default: php)`soar stopall`Stop ALL Docker containers`soar stopother`Stop non-project containersAny unrecognized command is passed directly to docker-compose.

Configuration
-------------

[](#configuration)

Soar automatically sources `.env` and `.env.$APP_ENV` from your project directory.

See [.env.example](.env.example) for available configuration options.

### Service Names

[](#service-names)

Default service names can be overridden via environment variables:

- `DOCKER_PHP_SERVICE` (default: `php`)
- `DOCKER_DB_SERVICE` (default: `db`)
- `DOCKER_WEB_SERVER_SERVICE` (default: `nginx`)

Documentation
-------------

[](#documentation)

For detailed documentation, see [CLAUDE.md](CLAUDE.md).

License
-------

[](#license)

MIT

Author
------

[](#author)

Roy Nilsson ()

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance85

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity34

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

77d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c875ad4c9ecf2f9ee532b7d0e85c9c2de4bd8118f82046c5bfaa6bfefc5601b3?d=identicon)[rnab](/maintainers/rnab)

---

Top Contributors

[![roynilsson](https://avatars.githubusercontent.com/u/18714244?v=4)](https://github.com/roynilsson "roynilsson (18 commits)")

---

Tags

docker

### Embed Badge

![Health badge](/badges/rnab-soar/health.svg)

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

###  Alternatives

[spatie/docker

Run a docker container in your PHPUnit tests

478120.2k12](/packages/spatie-docker)[ryoluo/sail-ssl

Laravel Sail plugin to enable SSL (HTTPS) connection with Nginx.

188672.6k2](/packages/ryoluo-sail-ssl)[aschmelyun/fleet

Run multiple Laravel Sail websites on your local environment

33269.5k](/packages/aschmelyun-fleet)[testcontainers/testcontainers

Testcontainers implementation in PHP

199184.7k17](/packages/testcontainers-testcontainers)[contributte/bootstrap

Extra contrib to nette/boostrap

111.5M3](/packages/contributte-bootstrap)[phpexperts/dockerize

The quickest and easiest way to switch any PHP app/library to use Docker.

7116.9k21](/packages/phpexperts-dockerize)

PHPackages © 2026

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