Stars: 2896
Forks: 495
Pull Requests: 342
Issues: 365
Watchers: 100
Last Updated: 2022-11-23 10:08:33
Simple static Composer repository generator - For a full private Composer repo use Private Packagist
License: MIT License
Languages: PHP, Batchfile, Shell, Dockerfile, JavaScript, SCSS, Twig
Simple static Composer repository generator.
Satis requires a recent PHP version, it does not run with unsupported PHP versions. Check the composer.json
file for details.
composer create-project composer/satis:dev-main
php bin/satis build <configuration-file> <output-directory>
Read the more detailed instructions in the documentation.
Pull the image:
docker pull composer/satis
Run the image (with Composer cache from host):
docker run --rm --init -it \
--user $(id -u):$(id -g) \
--volume $(pwd):/build \
--volume "${COMPOSER_HOME:-$HOME/.composer}:/composer" \
composer/satis build <configuration-file> <output-directory>
If you want to run the image without implicitly running Satis, you have to
override the entrypoint specified in the Dockerfile
:
--entrypoint /bin/sh
If you choose to archive packages as part of your build, over time you can be
left with useless files. With the purge
command, you can delete these files.
php bin/satis purge <configuration-file> <output-dir>
Note: don't do this unless you are certain your projects no longer reference any of these archives in their
composer.lock
files.
Updating Satis is as simple as running git pull && composer install
in the
Satis directory.
If you are running Satis as a Docker container, simply pull the latest image.
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.
Fork the project, create a feature branch, and send us a pull request.
If you introduce a new feature, or fix a bug, please try to include a testcase.
While not required, it is appreciated if your contribution meets our coding standards.
You can check these yourself by running the tools we use:
# install tooling & dependencies
for d in tools/*; do composer --working-dir=$d install; done
# run php-cs-fixer
tools/php-cs-fixer/vendor/bin/php-cs-fixer fix
# run phpstan
tools/phpstan/vendor/bin/phpstan
# alternatively, use the shortcuts
composer phpstan
composer php-cs-fixer[-fix]
See the list of contributors who participate(d) in this project.
Satis is licensed under the MIT License - see the LICENSE file for details