Skip to content

Commit 6585680

Browse files
committed
Added to usage docs about executable PIE version
1 parent ad58139 commit 6585680

File tree

1 file changed

+18
-0
lines changed

1 file changed

+18
-0
lines changed

docs/usage.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,24 @@ RUN pie install asgrim/example-pie-extension
7070
If the extension you would like to install needs additional libraries or other
7171
dependencies, then these must be installed beforehand too.
7272

73+
### Executable PIE (Experimental)
74+
75+
As of 1.4.0 an **experimental** executable (binary) version of PIE is included.
76+
The PIE is built using [Static PHP](https://static-php.dev/), which builds a
77+
self-contained PHP executable with the extensions that PIE needs to run, and
78+
bundles the PHAR as a single distributable executable. Please keep in mind that
79+
this is **experimental** and we do not recommend this for production use for
80+
the time being. Please also note there are some limitations:
81+
82+
- [php/pie#459](https://github.com/php/pie/discussions/459) - the OSX version
83+
is not signed with an Apple Developer account, which means (at your own risk)
84+
you would need to tell your system to trust the downloaded executable.
85+
- [php/pie#460](https://github.com/php/pie/discussions/460) - all the binary
86+
versions have the `pie self-update` feature disabled for now.
87+
88+
If you find the binary releases useful, please leave feedback or upvote on the
89+
relevant discussions, so we can gauge interest in improving this functionality.
90+
7391
## Prerequisites for PIE
7492

7593
Running PIE requires PHP 8.1 or newer. However, you may still use PIE to install

0 commit comments

Comments
 (0)