/haulable

Create standalone PHP CLI applications with PHP Micro CLI

Primary LanguagePHPMIT LicenseMIT

Total Downloads Latest Stable Version License

image

Haulable is a CLI tool that packages your existing PHP CLI Phar with PHP Micro CLI for MacOS (Apple/Intel), Linux, and Windows. This enables your existing PHP CLI app built with something like Laravel Zero to be truly portable as the end user will no longer need PHP to be installed to run your application.

Requirements

  • Haulable currently only runs on MacOS/Linux; however, it will package your CLI for Windows.
  • Your CLI application must be built using PHP8.0+

Installation

To install Haulable, you can use composer to install globally, or you can use the Phar directly by downloading the latest build.

composer global require configured/haulable

Usage

To use Haulable, once installed, you can simply run haulable your_cli_app.phar. Haulable will then ask you for what target system(s) you'd like to package your CLI app for.

image

Options

Haulable accepts options and arguments to make it easier to use in CI pipelines

Platform

An option can be one of the following:

  • All Platforms
  • MacOS (Intel)
  • MacOS (Apple)
  • Linux (x86_64)
  • Linux (aarch64)
  • Windows (x64)
haulable your_cli_app.phar --platform="<option>"

License

Haulable is open-sourced software licensed under the MIT license.