Project Manager is designed to help organise micro-services based PHP projects. It incorporates commands for creating new services, libraries, and managing them. Project configuration is stored as YAML files that you commit to a git repo and share with your team. If you want to stop using it, delete the phar and the files and continue on. There is no special configuration needed in any project.
- groups separate micro-service projects together
- gives an overview of running docker processes across all services
- supports dependencies between services
- supports multiple projects on a single machine
- supports templates for libraries and services
- supports docker container definitions for easier adding to services
- all configuration is by yaml files
Project Manager requires PHP 8.1+ to be installed and in your shell path.
Grab the phar archive and copy it to /usr/local/bin
or add it to your path.
Symlink the phar to spm
or a.n.other name. Be sure to verify the SHA checksum with
the ones in the release checksums text file.
Or:
$ brew install somnambulist-tech/somnambulist/spm
Run: spm init
to create the standard configuration (see later).
See getting started for the next steps.
More:
If installed via brew: brew remove somnambulist-tech/somnambulist/spm
Remove any symlinks you have and delete the phar file. Delete the configuration folder
from ~/.config/spm_projects.d/
or ~/.spm_projects.d/
unlink /usr/local/bin/spm && rm -v /usr/local/bin/somnambulist-project-manager.phar
To build the phar archive, first checkout / clone the project manager project. Run
composer install
and ensure that phar.readonly
is set to 0
in your php.ini.
You can then run: bin/compile
which will create a somnambulist-project-manager.phar
file in the project root. The compile command will output the SHA384 hash together with the
file location / name.
Make an issue on the github repo: https://github.com/somnambulist-tech/project-manager/issues
Pull requests are welcome!