pronskiy / phpup

The PHP toolchain: run Composer, PHPStan, Rector, or any PHP script without having PHP installed.

phpup
The PHP Toolchain

Phpup is a single-file binary with zero dependencies that includes Composer and other PHP tools. It also allows installing a per-project PHP based on your composer.json.

You don't need to have PHP or anything at all on your system to run it.

Warning

Under heavy development
Currently, this is an MVP, and only macOS aarch64 is supported.

Installation

Download phpup binary from the release page and put it into a directory on your PATH, so you can simply call phpup from any directory.

curl -OL https://github.com/pronskiy/phpup/releases/latest/download/phpup
chmod +x phpup
sudo mv phpup /usr/local/bin/phpup

Usage

• phpup list – See the list of available commands.

• phpup <file> – Run any php file. 🚧

• phpup composer – Composer that does not require PHP to be installed.

• phpup conductor <command> – Like npx but for PHP. 🚧

• phpup locus – Installs PHP binary under your project's vendor/bin/php based on the requirements in composer.json.

• phpup phpstan – PHPStan that does not require PHP. 🚧

• phpup rector – Rector that does not require PHP. 🚧

Contributing

Contributions are very welcome! However, it's recommended to first create an issue describing the idea — let's find the best approach together.

See some ideas in the todo list below.

Build Requirements

Before you begin, ensure you have met the following requirements:

• Make (version 3.0 or later)
• Box (version 4.x)

Building Binary

make build

TODO

• Run php script #1

• Accept a reference to a packagist/gh repo, to be able to run its scripts/bin/

  • https://twitter.com/AdrienBrault/status/1782476060426179049
  • https://twitter.com/pronskiy/status/1768219585151402251
  • https://github.com/artisan-build/conductor
  • https://github.com/pronskiy/conductor
  • artisan-build/conductor#8

• Support Windows

• Support Linux

• Make symfony/console app

• Add help command

• Extract packing with box and micro php to a stand-alone GitHub action

• Reduce size of the resulting binary

• Check microphp's patches:

  • Bypass cli SAPI name checks
  • static_opcache

• [ ] Add more tools

  • [ ] PHP-CS-Fixer
  • [ ] PHPUnit

• [ ] Support Rector 🚧

• [ ] Support PHPStan 🚧

Credits

This package entirely relies on https://github.com/static-php and https://github.com/easysoft/phpmicro.

phpup's Issues

Allow executing php files without installing additional php interpreter

Suggested by @marco-introini:

Something like "if the first parameter is not in phpup list of commands execute vendor/bin/php passing the argument". I don't know if it makes sense.
In this way, we can be up and running in very few steps:

phpup composer init
<add PHP version in composer.json>
phpup locus
<create my first PHP file>
phpup myFile.php (as an extra: maybe this can execute phpup locus if no PHP binary is found inside the vendor directory)

Better yet, maybe creating a new init command can reduce the effort:
phpup init
can: make composer init, add PHP version in composer.json, execute phpup locus

In this way to create a new project:

phpup init 8.3
<create myFile.php>
phpup myFile.php

Autodetect OS while installing and Linux support