PHPBrew

https://phpbrew.github.io/phpbrew
Admin
PHPBrew is a tool that builds and installs multiple PHP versions in your home directory without...
Tokens:4,435
Snippets:79
Trust Score:9.7
Update:5 months ago
Show doc for...
Tokens:
Raw
### Install PHP Extension (Simple)

Source: https://phpbrew.github.io/phpbrew

Install a PHP extension, such as `apcu` or `memcache`, using the `ext install` command.

```bash
$phpbrew ext install apcu
```

```bash
$phpbrew ext install memcache
```

--------------------------------

### Install PHP with Tests and Debug

Source: https://phpbrew.github.io/phpbrew

Install a PHP version with test support enabled. Use the '-d' flag for debug messages during the installation process.

```bash
phpbrew install --test 5.4.0
```

```bash
phpbrew -d install --test 5.4.0
```

--------------------------------

### Install Phpbrew

Source: https://phpbrew.github.io/phpbrew

Download the phpbrew.phar executable and make it executable. This is the initial step to install phpbrew on your system.

```bash
curl -L -O https://github.com/phpbrew/phpbrew/releases/latest/download/phpbrew.phar
chmod +x phpbrew.phar
```

--------------------------------

### Install PHP with Default Variants

Source: https://phpbrew.github.io/phpbrew

Build and install a specific PHP version using the default variant set, which includes commonly used options. For a minimal install, omit '+default'.

```bash
phpbrew install 5.4.0 +default
```

--------------------------------

### Install PHP Extension with Custom Options

Source: https://phpbrew.github.io/phpbrew

Use this command to install a PHP extension with specific configuration options, such as a custom installation path for its dependencies.

```bash
$ phpbrew ext install yaml -- --with-yaml=/opt/local
```

--------------------------------

### Install PHP from GitHub Tag

Source: https://phpbrew.github.io/phpbrew

Install a PHP version directly from a GitHub tag in the php-src repository. Specify the repository, tag, and the desired name for the installed version.

```bash
phpbrew install github:php/php-src@PHP-7.0 as php-7.0.0
```

--------------------------------

### Install PHP with Multiple Extra Variants

Source: https://phpbrew.github.io/phpbrew

Install PHP 5.3.10 with `+mysql`, `+sqlite`, and `+cgi` variants for enhanced functionality.

```bash
$phpbrew install 5.3.10 +mysql+sqlite+cgi
```

--------------------------------

### Install PHP Extension with Specific Version

Source: https://phpbrew.github.io/phpbrew

Install a specific version of a PHP extension, for example, `xdebug` version `2.0.1`.

```bash
$phpbrew ext install xdebug 2.0.1
```

--------------------------------

### Install PHP with Database and Apache Variants

Source: https://phpbrew.github.io/phpbrew

Install PHP 5.3.10 with `+pdo`, `+mysql`, `+pgsql`, and `+apxs2` variants, specifying the apxs2 path.

```bash
$phpbrew install 5.3.10 +pdo +mysql +pgsql +apxs2=/usr/bin/apxs2
```

--------------------------------

### Install PHP with Default Variants

Source: https://phpbrew.github.io/phpbrew

Install a specific PHP version using the `+default` virtual variant, which enables common options.

```bash
phpbrew install 5.3.10 +default
```

--------------------------------

### List Installed PHP Versions

Source: https://phpbrew.github.io/phpbrew

Display a list of all PHP versions that have been installed using PHPBrew.

```bash
$phpbrew list
```

--------------------------------

### Install PHP with Default and Database Variants

Source: https://phpbrew.github.io/phpbrew

Build PHP 5.4.5 with both the `+default` virtual variant and the `+dbs` virtual variant for database support.

```bash
$phpbrew install 5.4.5 +default+dbs
```

--------------------------------

### Install PHP with Specific Database Variants

Source: https://phpbrew.github.io/phpbrew

Build PHP with support for MySQL and PDO by specifying the `+mysql` and `+pdo` variants.

```bash
phpbrew install 5.3.10 +mysql +pdo
```

--------------------------------

### Install PHP Extension with Stability Tag

Source: https://phpbrew.github.io/phpbrew

Install a PHP extension like `xdebug` using a specific stability tag such as `stable`, `latest`, or `beta`.

```bash
$phpbrew ext install xdebug stable
```

```bash
$phpbrew ext install xdebug latest
```

```bash
$phpbrew ext install xdebug beta
```

--------------------------------

### Install PHP with Custom Apache2 Path

Source: https://phpbrew.github.io/phpbrew

Specify a custom path for the Apache2 apxs2 binary when installing PHP with `+apxs2` variant.

```bash
phpbrew install 5.3.10 +mysql +pdo +apxs2=/usr/bin/apxs2
```

--------------------------------

### Install PHP with Parallel Compilation

Source: https://phpbrew.github.io/phpbrew

Install a PHP version using parallel compilation to speed up the build process. Adjust the number of jobs using '-j' or '--jobs' with the number of available processors.

```bash
phpbrew install -j $(nproc) 5.4.0 +default
```

--------------------------------

### Install PHP with Debug and Apache Variants

Source: https://phpbrew.github.io/phpbrew

Build PHP 5.3.10 with `+mysql`, `+debug`, `+pgsql`, and `+apxs2` variants for development and Apache integration.

```bash
$phpbrew install 5.3.10 +mysql+debug+pgsql +apxs2
```

--------------------------------

### Set Current PHP Version for Extension Installation

Source: https://phpbrew.github.io/phpbrew

Before installing extensions, set the active PHP version using the `use` command.

```bash
$phpbrew use php-5.5.6
```

--------------------------------

### Install PHP Extension from GitHub

Source: https://phpbrew.github.io/phpbrew

Install a PHP extension directly from a GitHub repository, specifying the repository and branch. This is useful for extensions not yet available via PECL or for testing development versions.

```bash
$ phpbrew ext install github:php-memcached-dev/php-memcached php7 -- --disable-memcached-sasl
```

--------------------------------

### Install Next Unstable PHP Version

Source: https://phpbrew.github.io/phpbrew

Install the next unstable (development) PHP version and assign it a specific name, such as 'php-7.1.0'.

```bash
phpbrew install next as php-7.1.0
```

--------------------------------

### Install PHP with PostgreSQL Extension

Source: https://phpbrew.github.io/phpbrew

Build PHP 5.4.1 with `+pgsql` and `+pdo` variants to enable PostgreSQL support.

```bash
$phpbrew install 5.4.1 +pgsql+pdo
```

--------------------------------

### Install PHP with Apache2 Variant

Source: https://phpbrew.github.io/phpbrew

Install PHP with MySQL, PDO, and the Apache2 module support using `+mysql`, `+pdo`, and `+apxs2` variants.

```bash
phpbrew install 5.3.10 +mysql +pdo +apxs2
```

--------------------------------

### Install PHP with PostgreSQL on Mac OS X

Source: https://phpbrew.github.io/phpbrew

Install PHP 5.4.1 with `+pdo` and `+pgsql` variants, specifying the PostgreSQL base directory for Mac OS X.

```bash
$phpbrew install 5.4.1 +pdo+pgsql=/opt/local/lib/postgresql91/bin
```

--------------------------------

### Install Older PHP Versions

Source: https://phpbrew.github.io/phpbrew

Install PHP versions older than 5.3. Be aware that successful building of these versions is not guaranteed and issues may not be resolved.

```bash
phpbrew install --old 5.2.13
```

--------------------------------

### Install PHP Extension with Specific Downloader

Source: https://phpbrew.github.io/phpbrew

Choose a specific downloader for installing PHP extensions. Supported downloaders include php_curl, php_stream, curl, and wget. This can be useful for managing network-related issues during downloads.

```bash
phpbrew ext install --downloader php_curl apcu
```

```bash
phpbrew ext install --download php_curl --http-proxy=... --http-proxy-auth=... apcu
```

--------------------------------

### Build PHP with GD Extension and Specific Libraries

Source: https://phpbrew.github.io/phpbrew

Example of building a PHP version with the GD extension enabled, requiring specific paths for libpng and libjpeg, and using a shared GD build. This command also includes other common variants like mysql and gettext.

```bash
$ phpbrew install php-5.4.10 +default +mysql +intl +gettext +apxs2=/usr/bin/apxs2 \ 
-- --with-libdir=lib/x86_64-linux-gnu \
--with-gd=shared \
--enable-gd-natf \
--with-jpeg-dir=/usr \
--with-png-dir=/usr
```

--------------------------------

### Configure PHP-FPM with Custom Files

Source: https://phpbrew.github.io/phpbrew

Manually configure PHP-FPM by copying the default configuration file and specifying paths to PHP and FPM configuration files when starting the service.

```bash
cp -v ~/.phpbrew/php/php-*/etc/php-fpm.conf.default
    ~/.phpbrew/php/php-*/etc/php-fpm.conf

php-fpm --php-ini {php config file} --fpm-config {fpm config file}
```

--------------------------------

### Install PHP with Neutral Compile Options

Source: https://phpbrew.github.io/phpbrew

Build PHP 5.4.1 using the `+neutral` virtual variant, which avoids disabling all options but includes essential ones like `--enable-libxml`.

```bash
$phpbrew install 5.4.1 +neutral
```

--------------------------------

### Enable PHP Extension Manually

Source: https://phpbrew.github.io/phpbrew

Install an extension using PECL and then enable it with phpbrew. This creates a .ini file in the current PHP version's var/db directory to activate the extension.

```bash
pecl install mongo
phpbrew ext enable mongo
```

--------------------------------

### Manage PHP-FPM Service

Source: https://phpbrew.github.io/phpbrew

Control the PHP-FPM service, including starting, stopping, showing modules, testing configuration, and editing the configuration file. Ensure the +fpm variant is enabled when building PHP.

```bash
$ phpbrew fpm start
```

```bash
$ phpbrew fpm stop
```

```bash
phpbrew fpm module
```

```bash
phpbrew fpm test
```

```bash
phpbrew fpm config
```

--------------------------------

### Navigate to PHP Build Directory

Source: https://phpbrew.github.io/phpbrew

Quickly switch to the directory where PHP versions are built.

```bash
$ phpbrew build-dir
```

--------------------------------

### Show Extension Configure Options

Source: https://phpbrew.github.io/phpbrew

View available configure options for built-in PHP extensions, like `apcu`, using the `ext show` command.

```bash
phpbrew ext show apcu
```

--------------------------------

### Navigate to PHP Configuration Directory

Source: https://phpbrew.github.io/phpbrew

Quickly switch to the directory containing PHP configuration files.

```bash
$ phpbrew etc-dir
```

--------------------------------

### List Available Variants

Source: https://phpbrew.github.io/phpbrew

Run this command to see all available default and virtual variants for PHP configuration.

```bash
$ phpbrew variants
```

--------------------------------

### Pass Extra Configure Arguments

Source: https://phpbrew.github.io/phpbrew

Provide additional configure arguments, such as `--enable-ftp` and `--apxs2=/opt/local/apache2/bin/apxs`, by using `--` followed by the arguments.

```bash
$phpbrew install 5.3.10 +mysql +sqlite -- \
    --enable-ftp --apxs2=/opt/local/apache2/bin/apxs
```

--------------------------------

### Navigate to PHP Distribution Directory

Source: https://phpbrew.github.io/phpbrew

Quickly switch to the directory where PHP distribution archives are stored.

```bash
$ phpbrew dist-dir
```

--------------------------------

### Temporarily Use a PHP Version

Source: https://phpbrew.github.io/phpbrew

Switch to a specific PHP version for the current shell session using the `use` command.

```bash
$phpbrew use 5.4.22
```

--------------------------------

### Enable a Single Variant

Source: https://phpbrew.github.io/phpbrew

To enable a specific variant like `+mysql`, simply prepend it with a plus sign.

```bash
+mysql
```

--------------------------------

### Navigate to PHP Variable Directory

Source: https://phpbrew.github.io/phpbrew

Quickly switch to the directory for PHP variable data, such as logs and databases.

```bash
$ phpbrew var-dir
```

--------------------------------

### Move Phpbrew to Bin

Source: https://phpbrew.github.io/phpbrew

Move the downloaded phpbrew.phar to a directory in your system's PATH, such as /usr/local/bin, for global access. Ensure /usr/local/bin is in your PATH.

```bash
sudo mv phpbrew.phar /usr/local/bin/phpbrew
```

--------------------------------

### Initialize Phpbrew Bash Script

Source: https://phpbrew.github.io/phpbrew

Initialize phpbrew for your shell environment by running the 'init' command. Add the generated bash script to your .bashrc or .zshrc for automatic sourcing.

```bash
phpbrew init
```

```bash
[[ -e ~/.phpbrew/bashrc ]] && source ~/.phpbrew/bashrc
```

--------------------------------

### Switch Default PHP Version

Source: https://phpbrew.github.io/phpbrew

Set a specific PHP version as the default for your system using the `switch` command.

```bash
$phpbrew switch 5.4.18
```

--------------------------------

### List Known PHP Versions

Source: https://phpbrew.github.io/phpbrew

Display a list of PHP versions known to phpbrew, categorized by major versions. Use '--more' to see additional minor versions.

```bash
phpbrew known
```

```bash
phpbrew known --more
```

--------------------------------

### Set Phpbrew Lookup Prefix

Source: https://phpbrew.github.io/phpbrew

Configure phpbrew to use a specific package manager for looking up libraries. Options include 'homebrew', 'macports', 'debian', 'ubuntu', or a custom path.

```bash
phpbrew lookup-prefix homebrew
```

```bash
phpbrew lookup-prefix macports
```

--------------------------------

### List Known Older PHP Versions

Source: https://phpbrew.github.io/phpbrew

List known PHP versions that are older than 5.4. Note that building these older versions may not be successful and issues related to them are not typically fixed.

```bash
phpbrew known --old
```

--------------------------------

### Update PHP Release Info

Source: https://phpbrew.github.io/phpbrew

Update the local release information for PHP versions. Use '--old' to include older versions less than 5.4, though support for these is not guaranteed.

```bash
phpbrew update
```

```bash
phpbrew update --old
```

--------------------------------

### Configure php.ini for Current PHP Version

Source: https://phpbrew.github.io/phpbrew

Open the php.ini configuration file for the currently active PHP version in your default editor. You can specify your preferred editor using the EDITOR environment variable.

```bash
$ phpbrew config
```

```bash
export EDITOR=vim
phpbrew config
```

--------------------------------

### Upgrade PHPBrew

Source: https://phpbrew.github.io/phpbrew

Update PHPBrew to the latest version from the master branch on GitHub using the self-update command.

```bash
$ phpbrew self-update
```

--------------------------------

### Clean Up PHP Build Directory

Source: https://phpbrew.github.io/phpbrew

Remove the build directory for a specific PHP version to free up disk space. This command cleans up the temporary build files.

```bash
phpbrew clean php-5.4.0
```

--------------------------------

### Enable PHP Version Info in Shell Prompt

Source: https://phpbrew.github.io/phpbrew

Add the current PHP version to your shell prompt by setting the PHPBREW_SET_PROMPT environment variable and using the phpbrew_current_php_version function in your PS1.

```bash
export PHPBREW_SET_PROMPT=1
```

```bash
PS1=" $(phpbrew_current_php_version) $ "
```

--------------------------------

### Turn Off PHPBrew

Source: https://phpbrew.github.io/phpbrew

Disable PHPBrew's version management for the current shell session using the `off` command.

```bash
$phpbrew off
```

--------------------------------

### Disable a Single Variant

Source: https://phpbrew.github.io/phpbrew

To disable a specific variant like `+debug`, prepend it with a minus sign.

```bash
-debug
```
Tokens:
Raw