shivammathur/spc

0.0.5 2022-09-26 04:30 UTC

MIT

• Shivam Mathur

README

setup-php-cli (SPC) is a command line utility to run setup-php.

OS Support

Install

• Using composer

composer global require shivammathur/spc
sudo cp $(composer global config home)/vendor/bin/spc /usr/local/bin/spc
sudo chmod a+x /usr/local/bin/spc

• Download from Releases

# Download
curl -o /tmp/spc -sL https://github.com/shivammathur/spc/releases/latest/download/spc

# Verify
curl -o /tmp/spc.asc -sL https://github.com/shivammathur/spc/releases/latest/download/spc.asc
curl -o /tmp/key.asc -sL https://github.com/shivammathur.gpg
gpg --import /tmp/key.asc
gpg --verify /tmp/spc.asc /tmp/spc

# Install
sudo mv /tmp/spc /usr/local/bin/spc
sudo chmod a+x /usr/local/bin/spc

Options

-p "[PHP Version]", --php-version "[PHP Version]"    Specify PHP version (Required if PHP is not installed)
-e "[Extensions]", --extensions "[Extensions]"       Specify extensions
-b "[INI File]", --ini-file "[INI Values]"           Specify base ini file
-i "[INI Values]", --ini-values "[INI Values]"       Specify ini values
-c "[Coverage]", --coverage "[Coverage]"             Specify Coverage driver
-t "[Tools]", --tools "[Tools]"                      Specify tools
-f "[Debug]", --debug "[Debug]"                      Specify debug flag
-f "[Fail Fast]", --fail-fast "[Fail Fast]"          Specify fail-fast flag
-z "[PHP TS/NTS]", --phpts "[PHPTS/NTS]"             Specify phpts flag
-u "[Update]", --update "[Update]"                   Specify update flag
-r "[TAG]", --release "[TAG]"                        Specify release
-v, --verbose                                        Specify verbose mode
-V, --version                                        Show version of script
-h, --help                                           Show help

Examples

• Install or switch to a particular PHP version. For example to install PHP 7.4.

spc -p "7.4"

• Install PHP extension, say intl and xml on PHP 7.4.

spc -e "intl, xml"

• Set the base php.ini file, say set it to development.

spc -b "development"

• Add any configuration to your php.ini, say set timezone to UTC.

spc -i "date.timezone=UTC"

• Set a coverage driver, say PCOV.

spc -c "pcov"

• Install a tool supported by setup-php globally.

spc -t "phpunit"

• Setup a debug build of PHP.

spc -p 8.1 -d "true"

• Fail if an extension, or a tool does not install.

spc -t "random_tool" -f "true"

• Update PHP to the latest patch version.

spc -u "true"

• Setup TS/NTS PHP on Windows. (Not supported currently)

spc -p "7.4" -z "ts"

• Use a particular tag/release of setup-php, say to use v1.

spc -r "v1"

• To run spc in the verbose mode, this will use verbose branch of setup-php.

spc -v

• To check options spc supports in command line.

spc -h

• To upgrade spc to latest version.

spc -U

• To check spc version.

spc -V