{"id":15021465,"url":"https://github.com/php/pie","last_synced_at":"2026-04-01T17:12:59.466Z","repository":{"id":225106022,"uuid":"765049687","full_name":"php/pie","owner":"php","description":"🥧 The PHP Installer for Extensions","archived":false,"fork":false,"pushed_at":"2026-03-17T10:59:22.000Z","size":2158,"stargazers_count":1771,"open_issues_count":20,"forks_count":59,"subscribers_count":29,"default_branch":"1.4.x","last_synced_at":"2026-03-18T00:32:29.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/php.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/supported-extensions.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-02-29T07:28:59.000Z","updated_at":"2026-03-17T17:14:36.000Z","dependencies_parsed_at":"2026-03-17T11:06:05.217Z","dependency_job_id":null,"html_url":"https://github.com/php/pie","commit_stats":{"total_commits":247,"total_committers":11,"mean_commits":"22.454545454545453","dds":0.1417004048582996,"last_synced_commit":"89379c047566313ac9d600f2f07506341f460995"},"previous_names":["php/pie"],"tags_count":37,"template":false,"template_full_name":null,"purl":"pkg:github/php/pie","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/php%2Fpie","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/php%2Fpie/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/php%2Fpie/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/php%2Fpie/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/php","download_url":"https://codeload.github.com/php/pie/tar.gz/refs/heads/1.4.x","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/php%2Fpie/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-09-24T19:56:36.560Z","updated_at":"2026-04-01T17:12:59.462Z","avatar_url":"https://github.com/php.png","language":"PHP","readme":"# 🥧 PIE (PHP Installer for Extensions)\n\n## What is PIE?\n\nPIE is the official installer for PHP extensions, which replaces\n[PECL](https://pecl.php.net/) (which is now deprecated). PIE is distributed as a\n[PHAR](https://www.php.net/manual/en/intro.phar.php), just like Composer, and\nworks in a similar way to Composer, but it installs PHP extensions (PHP Modules\nor Zend Extensions) to your PHP installation, rather than pulling PHP packages\ninto your project or library.\n\n# Using PIE - what do I need to get started?\n\n## Prerequisites\n\nYou will need PHP 8.1 or newer to run PIE, but PIE can install an extension to\nany other installed PHP version.\n\nOn Linux/OSX, if any build tools needed are missing, PIE will ask if you would\nlike to automatically install them first (this is a new feature in 1.4.0).\n\nOn Windows, you do not need any build toolchain installed, since PHP extensions\nfor Windows are distributed as pre-compiled packages containing the extension\nDLL.\n\n## Installing PIE\n\n- Download `pie.phar` either:\n  - [latest stable release](https://github.com/php/pie/releases)\n  - [latest unstable nightly](https://php.github.io/pie/pie-nightly.phar)\n- Verify the PHAR's source with `gh attestation verify --owner php pie.phar`\n- You may then invoke PIE with `php pie.phar \u003ccommand\u003e`\n\nFurther installation details can be found in the [usage](./docs/usage.md) docs.\nThis documentation assumes you have moved `pie.phar` into your `$PATH`, e.g.\n`/usr/local/bin/pie` on non-Windows systems or created an alias in your shell RC file.\n\n## Using PIE\n\n### Installing a single extension using PIE\n\nYou can install an extension using the `install` command. For example, to\ninstall the `example_pie_extension` extension, you would run:\n\n```shell\n$ pie install asgrim/example-pie-extension\nThis command may need elevated privileges, and may prompt you for your password.\nYou are running PHP 8.3.10\nTarget PHP installation: 8.3.10 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)\nFound package: asgrim/example-pie-extension:1.0.1 which provides ext-example_pie_extension\nphpize complete.\nConfigure complete.\nBuild complete: /tmp/pie_downloader_66e0b1de73cdb6.04069773/asgrim-example-pie-extension-769f906/modules/example_pie_extension.so\nInstall complete: /usr/lib/php/20230831/example_pie_extension.so\nYou must now add \"extension=example_pie_extension\" to your php.ini\n$\n```\n\n### Installing all extensions for a PHP project\n\nWhen in your PHP project, you can install any missing top-level extensions:\n\n```\n$ pie install\n🥧 PHP Installer for Extensions (PIE), 0.9.0, from The PHP Foundation\nYou are running PHP 8.3.19\nTarget PHP installation: 8.3.19 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)\nChecking extensions for your project your-vendor/your-project\nrequires: curl ✅ Already installed\nrequires: intl ✅ Already installed\nrequires: json ✅ Already installed\nrequires: example_pie_extension ⚠️  Missing\n\nThe following packages may be suitable, which would you like to install:\n  [0] None\n  [1] asgrim/example-pie-extension: Example PIE extension\n \u003e 1\n   \u003e 🥧 PHP Installer for Extensions (PIE), 0.9.0, from The PHP Foundation\n   \u003e This command may need elevated privileges, and may prompt you for your password.\n   \u003e You are running PHP 8.3.19\n   \u003e Target PHP installation: 8.3.19 nts, on Linux/OSX/etc x86_64 (from /usr/bin/php8.3)\n   \u003e Found package: asgrim/example-pie-extension:2.0.2 which provides ext-example_pie_extension\n   ... (snip) ...\n   \u003e ✅ Extension is enabled and loaded in /usr/bin/php8.3\n\nFinished checking extensions.\n```\n\n\u003e [!TIP]\n\u003e If you are running PIE in a non-interactive shell (for example, CI, a\n\u003e container), pass the `--allow-non-interactive-project-install` flag to run\n\u003e this command. It may still fail if more than one PIE package provides a\n\u003e particular extension.\n\n## Extensions that support PIE\n\nA list of extensions that support PIE can be found on\n[https://packagist.org/extensions](https://packagist.org/extensions).\n\n# I have a bug, feature idea, question, need help, etc.\n\n - If you have an idea, question, or need help, please use the [Discussions](https://github.com/php/pie/discussions).\n   - **Please check with us first before contributing new features** - it may be\n     something we're already working on, as the PHP Foundation is actively\n     developing this too, and there are new features already in the pipeline...\n - If you have a bug to report, please use the [Issues](https://github.com/php/pie/issues).\n\n# I'm an extension maintainer - how do I add PIE support?\n\nIf you are an extension maintainer wanting to add PIE support to your extension,\nplease read [extension-maintainers](./docs/extension-maintainers.md).\n\n# More documentation...\n\nThe full documentation for PIE can be found in [usage](./docs/usage.md) docs.\n","funding_links":[],"categories":["PHP","Table of Contents"],"sub_categories":["Dependency Management"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphp%2Fpie","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fphp%2Fpie","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fphp%2Fpie/lists"}