https://github.com/php/pie
🥧 The PHP Installer for Extensions
https://github.com/php/pie
Last synced: about 1 month ago
JSON representation
🥧 The PHP Installer for Extensions
- Host: GitHub
- URL: https://github.com/php/pie
- Owner: php
- License: bsd-3-clause
- Created: 2024-02-29T07:28:59.000Z (about 2 years ago)
- Default Branch: 1.4.x
- Last Pushed: 2026-03-17T10:59:22.000Z (about 2 months ago)
- Last Synced: 2026-03-18T00:32:29.105Z (about 2 months ago)
- Language: PHP
- Homepage:
- Size: 2.06 MB
- Stars: 1,771
- Watchers: 29
- Forks: 59
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Support: docs/supported-extensions.md
Awesome Lists containing this project
- awesome-php - Pie - The official PHP installer for extensions. (Table of Contents / Dependency Management)
- fucking-awesome-php - Pie - The official PHP installer for extensions. (Table of Contents / Dependency Management)
README
# 🥧 PIE (PHP Installer for Extensions)
## What is PIE?
PIE is the official installer for PHP extensions, which replaces
[PECL](https://pecl.php.net/) (which is now deprecated). PIE is distributed as a
[PHAR](https://www.php.net/manual/en/intro.phar.php), just like Composer, and
works in a similar way to Composer, but it installs PHP extensions (PHP Modules
or Zend Extensions) to your PHP installation, rather than pulling PHP packages
into your project or library.
# Using PIE - what do I need to get started?
## Prerequisites
You will need PHP 8.1 or newer to run PIE, but PIE can install an extension to
any other installed PHP version.
On Linux/OSX, if any build tools needed are missing, PIE will ask if you would
like to automatically install them first (this is a new feature in 1.4.0).
On Windows, you do not need any build toolchain installed, since PHP extensions
for Windows are distributed as pre-compiled packages containing the extension
DLL.
## Installing PIE
- Download `pie.phar` either:
- [latest stable release](https://github.com/php/pie/releases)
- [latest unstable nightly](https://php.github.io/pie/pie-nightly.phar)
- Verify the PHAR's source with `gh attestation verify --owner php pie.phar`
- You may then invoke PIE with `php pie.phar `
Further installation details can be found in the [usage](./docs/usage.md) docs.
This documentation assumes you have moved `pie.phar` into your `$PATH`, e.g.
`/usr/local/bin/pie` on non-Windows systems or created an alias in your shell RC file.
## Using PIE
### Installing a single extension using PIE
You can install an extension using the `install` command. For example, to
install the `example_pie_extension` extension, you would run:
```shell
$ pie install asgrim/example-pie-extension
This command may need elevated privileges, and may prompt you for your password.
You are running PHP 8.3.10
Target PHP installation: 8.3.10 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)
Found package: asgrim/example-pie-extension:1.0.1 which provides ext-example_pie_extension
phpize complete.
Configure complete.
Build complete: /tmp/pie_downloader_66e0b1de73cdb6.04069773/asgrim-example-pie-extension-769f906/modules/example_pie_extension.so
Install complete: /usr/lib/php/20230831/example_pie_extension.so
You must now add "extension=example_pie_extension" to your php.ini
$
```
### Installing all extensions for a PHP project
When in your PHP project, you can install any missing top-level extensions:
```
$ pie install
🥧 PHP Installer for Extensions (PIE), 0.9.0, from The PHP Foundation
You are running PHP 8.3.19
Target PHP installation: 8.3.19 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)
Checking extensions for your project your-vendor/your-project
requires: curl ✅ Already installed
requires: intl ✅ Already installed
requires: json ✅ Already installed
requires: example_pie_extension ⚠️ Missing
The following packages may be suitable, which would you like to install:
[0] None
[1] asgrim/example-pie-extension: Example PIE extension
> 1
> 🥧 PHP Installer for Extensions (PIE), 0.9.0, from The PHP Foundation
> This command may need elevated privileges, and may prompt you for your password.
> You are running PHP 8.3.19
> Target PHP installation: 8.3.19 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)
> Found package: asgrim/example-pie-extension:2.0.2 which provides ext-example_pie_extension
... (snip) ...
> ✅ Extension is enabled and loaded in /usr/bin/php8.3
Finished checking extensions.
```
> [!TIP]
> If you are running PIE in a non-interactive shell (for example, CI, a
> container), pass the `--allow-non-interactive-project-install` flag to run
> this command. It may still fail if more than one PIE package provides a
> particular extension.
## Extensions that support PIE
A list of extensions that support PIE can be found on
[https://packagist.org/extensions](https://packagist.org/extensions).
# I have a bug, feature idea, question, need help, etc.
- If you have an idea, question, or need help, please use the [Discussions](https://github.com/php/pie/discussions).
- **Please check with us first before contributing new features** - it may be
something we're already working on, as the PHP Foundation is actively
developing this too, and there are new features already in the pipeline...
- If you have a bug to report, please use the [Issues](https://github.com/php/pie/issues).
# I'm an extension maintainer - how do I add PIE support?
If you are an extension maintainer wanting to add PIE support to your extension,
please read [extension-maintainers](./docs/extension-maintainers.md).
# More documentation...
The full documentation for PIE can be found in [usage](./docs/usage.md) docs.