Skip to content

Commit

Permalink
Merge pull request #102 from alexandre-daubois/pie-reqs
Browse files Browse the repository at this point in the history
Add build tools to Pie requirements in the docs
  • Loading branch information
asgrim authored Nov 18, 2024
2 parents 9b56c41 + 8ac279f commit a4d3138
Showing 1 changed file with 40 additions and 1 deletion.
41 changes: 40 additions & 1 deletion docs/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,11 +27,50 @@ system:
sudo curl -L --output /usr/local/bin/pie https://github.com/php/pie/releases/latest/download/pie.phar && sudo chmod +x /usr/local/bin/pie
```

## Prerequisities for PIE
## Prerequisites for PIE

Running PIE requires PHP 8.1 or newer. However, you may still use PIE to install
an extension for an older version of PHP.

Additionally to PHP, PIE requires the following tools to be available on your
system in order to download, build and install extensions:

- The `zip` extension enabled for the PHP version running PIE, or `git` to
download the extension source code
- `autoconf`, `automake`, `libtool`, `m4`, `make`, and `gcc` to build the extension
- PHP development tools (such as `php-config` and `phpize`) to prepare the
extension for building.

Also, each extension may have its own requirements, such as additional libraries.

### Using Linux

On a Debian-based system, you may install the required tools with:

```shell
sudo apt-get install git autoconf automake libtool m4 make gcc
```

On a Red Hat-based system, you may install the required tools with:

```shell
sudo yum install git autoconf automake libtool m4 make gcc
```

### Using macOS

On macOS, you may install the required tools with [Homebrew](https://brew.sh):

```shell
brew install git autoconf automake libtool m4 make gcc
```

### Using Windows

On Windows, extensions are typically distributed as precompiled binaries.
Instead of building the extension yourself, it will be downloaded as DLL
files and placed in the PHP extensions directory.

## Downloading, Building, or Installing an extension

PIE has the ability to:
Expand Down

0 comments on commit a4d3138

Please sign in to comment.