Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/yannoff/p-a-w

Php Any Where - Run PHP. Any version. Without install.
https://github.com/yannoff/p-a-w

command-line composer offenbach phar php php- php-cli php-fpm php-shell php55 php56 php70 php71 php72 php73 php74 php80 php81 php82 php83-rc

Last synced: about 7 hours ago
JSON representation

Php Any Where - Run PHP. Any version. Without install.

Host: GitHub
URL: https://github.com/yannoff/p-a-w
Owner: yannoff
License: mit
Created: 2023-02-07T20:37:12.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2024-03-02T16:32:50.000Z (7 months ago)
Last Synced: 2024-03-02T17:35:28.762Z (7 months ago)
Topics: command-line, composer, offenbach, phar, php, php-, php-cli, php-fpm, php-shell, php55, php56, php70, php71, php72, php73, php74, php80, php81, php82, php83-rc
Language: Shell
Homepage:
Size: 11.7 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# P A W

Run PHP. Any version. Without install.

## Get it

> _**Important note:** This script is designed to run on Linux and requires [docker](https://docs.docker.com/engine/install/) to be installed._

Get the latest release from github...

```bash
# $BINDIR may be any of the $PATH directories, eg: ~/bin, /usr/local/bin, etc...
curl -Lo $BINDIR/php https://github.com/yannoff/p-a-w/releases/latest/download/php
# Make the main script executable
chmod +x $BINDIR/php
```

...add support for the desired php versions

```bash
ln -s $BINDIR/php $BINDIR/php5.6
ln -s $BINDIR/php $BINDIR/php7.4
ln -s $BINDIR/php $BINDIR/php8.0
```

..and **that's it !**

## How it works

Based on the multi-call binary principle (as the well-known [BusyBox](https://busybox.net/about.html) project) , each `php` **⁽¹⁾** file is just a symlink pointing to the main [`php`](php) entrypoint script: PHP version is deduced from the invoked filename.

> _**⁽¹⁾** If invoked without any suffix, the default version will be used: either the [`PHP_VERSION`](#customizing) env var (if set), the latest GA release (currently 8.3) otherwise._

Hence, adding support for a PHP version is dead-simple: just create a new `php` **⁽²⁾** symlink to the main [`php`](php) script.

_For example:_

```bash
# Assume ~/bin is in the $PATH system-wide environment variable
~/bin $ ln -s php php7.4
# Now PHP 7.4 can be accessed from everywhere in the system
~/bin $ cd /some/other/path
/some/other/path $ php7.4 --version
PHP 7.4.28 (cli) (built: Mar 29 2022 03:52:02) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies
with Zend OPcache v7.4.28, Copyright (c), by Zend Technologies
```

> _**⁽²⁾** Version must be one of the following:
`5.5`,
`5.6`,
`7.0`,
`7.1`,
`7.2`,
`7.3`,
`7.4`,
`8.0`,
`8.1`,
`8.2`,
> `8.3`_

## Examples

_The following examples are given assuming that:_
- _The `php` multi-call script is in one of the `$PATH` dirs_
- _A symlink to it has been created for each php version_

#### Open a php interactive command prompt

_Open a PHP 8.0 interactive shell in the current directory_

```bash
php8.0 -a
```

#### Open a bash session

_Open a PHP 8.2 container-secluded bash session, with access to the current directory_

```bash
php8.2
```

### Customizing

_The following environment variables allow to fine-tune the PAW script behaviour_

Name|Description|Fallback value
---|---|---
`PHP_VERSION`|The default version to use for `PHP`|`8.3`
`PAW_IMAGE`|PHP docker image to leverage|[`yannoff/php-fpm`](https://github.com/yannoff/docker-php-fpm) **⁽³⁾**
`PAW_DEBUG`|If set, turn on debug mode|-

> _**⁽³⁾** Based on [Alpine](https://www.alpinelinux.org/), this image uses `musl-libc`, [which implementation differs](https://wiki.musl-libc.org/functional-differences-from-glibc.html) from `glibc` on some aspects._

## Credits

Licensed under the [MIT License](LICENSE).