diff --git a/php/content.md b/php/content.md
index f53d27d4f293..02dd2241c619 100644
--- a/php/content.md
+++ b/php/content.md
@@ -71,8 +71,23 @@ See also ["Dockerizing Compiled Software"](https://tianon.xyz/post/2017/12/26/do
 
 Some extensions are compiled by default. This depends on the PHP version you are using. Run `php -m` in the container to get a list for your specific version.
 
+### PIE extensions
+
+The latest recommended way of installing PHP extensions is through [PIE](https://github.com/php/pie). To install a PIE-compatible extension, use `pie install` to download, compile and enable it.
+
+```dockerfile
+FROM %%IMAGE%%:8.2-cli
+
+# Install PIE here (see https://github.com/php/pie/blob/main/docs/usage.md)
+
+RUN pie install phpredis/phpredis:^6.1 \
+	&& pie install xdebug/xdebug:^3.4
+```
+
 ### PECL extensions
 
+⚠️ Note: Installation of PEAR and thus also PECL with PHP is deprecated and thus subject to removal in a future PHP version. See also https://github.com/php/php-src/commit/e93d6d97aab7a5de1f7b8dc750ca9d08214de8c4.
+
 Some extensions are not provided with the PHP source, but are instead available through [PECL](https://pecl.php.net/). To install a PECL extension, use `pecl install` to download and compile it, then use `docker-php-ext-enable` to enable it:
 
 ```dockerfile