# php-ver-manager

A hark fork of ![jalendport/switch-php](https://github.com/jalendport/switch-php/blob/master/LICENSE.md) which aims to continue supporting new PHP versions and fixing any stability issues. 

Easily maintain and switch between PHP versions on your Mac. Requires ![Homebrew](https://brew.sh/) and works with Laravel Valet.

## Installation:

Installing `php-ver-manager` is as easy as running:

```
npm install --global php-ver-manager
```

If you use Yarn, you can do this:

```
yarn global add php-ver-manager
```

Alternatively you can move the `php-ver-manager.sh` file from this repo into your home directory and add this line in your `.bashrc`/`.zshrc`/etc.:

```
source ~/php-ver-manager.sh
```


### Usage:

You must have PHP installed via Homebrew in order for `php-ver-manager` to work. `php-ver-manager` also works really well with Laravel Valet, but Valet is not a requirement in order to use `php-ver-manager`.

Here's an example of how you would use `php-ver-manager`:

```
$ php-ver-manager 7.1 -v -m 512M
```

1. `php-ver-manager` -> The main command. (Required)
1. `7.1` -> Specify the version of PHP you want to switch too, in this case `php71`. (Required)
1. `-v` -> Request verbose output (Optional)
1. `-m 512M` -> Request a custom PHP memory setting. If you don't pass an additional arugment, the memory will be reset to the Valet default. (Optional)

Here's the full list of versions/options:

```bash
Usage:
  version [options] [arguments]

Options:
  -h, --help      Display the help message
  -v, --verbose   Display more info during the process
  -m, --memory    Customize the PHP memory setting (Valet only)

Available Versions:
  5.6              Switch to php@5.6
  7.0              Switch to php@7.0
  7.1              Switch to php@7.1
  7.2              Switch to php@7.2
  7.3              Switch to php@7.3
  7.4              Switch to php@7.4
  8.0              Switch to php@8.0
```


### Customizing the PHP Memory Settings:

- If you don't pass an argument to `-m` or `--memory`, it will reset any previously set custom memory settings to the default Valet config.
- Alternatively, you can pass an argument to `-m` or    `--memory` if you want to override the default Valet memory settings. For example, you can do:

```
php-ver-manager 7.1 -m 512M       # php@7.1 with 512MB of memory
php-ver-manager 7.3 -m 2G -v      # php@7.3 with 2GB of memory; verbose output
php-ver-manager 5.6 --memory=1G   # php@5.6 with 1GB of memory
```

- *Note: customizing PHP memory settings currently only works for Laravel Valet users. If you don't use Valet, we hope to get this working for you as well in an upcoming release.*