Skip to content

add documentation about deb/rpm packages and how to install extensions #1756

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 6 commits into
base: main
Choose a base branch
from
+34 −0
Open

add documentation about deb/rpm packages and how to install extensions #1756

Changes from 2 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
04590b3
add documentation about rpm packages and how to install extensions
henderkes Jul 19, 2025
2b6dc5a
suggestion
henderkes Jul 25, 2025
6bd48ce
drop rhel 7 from docs
henderkes Aug 20, 2025
c6a1949
Merge remote-tracking branch 'dunglas/main'
henderkes Sep 11, 2025
55fc915
add deb instructions
henderkes Sep 11, 2025
ff1e4a4
revert readme header
henderkes Sep 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 18 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# FrankenPHP: Modern App Server for PHP

<h1 align="center"><a href="https://frankenphp.dev"><img src="frankenphp.png" alt="FrankenPHP" width="600"></a></h1>
<h1 style="text-align: center;"><a href="https://frankenphp.dev"><img src="frankenphp.png" alt="FrankenPHP" width="600"></a></h1>

FrankenPHP is a modern application server for PHP built on top of the [Caddy](https://caddyserver.com/) web server.

Expand Down Expand Up @@ -43,6 +43,21 @@ You can also run command-line scripts with:
frankenphp php-cli /path/to/your/script.php
```

### RPM Packages

We offer RPM packages for Red Hat Enterprise Linux 7 to 10. To install, run:

```console
sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm
sudo dnf module enable php-zts:static-8.4 # optional, defaults to 8.4, 8.2-8.4 available
sudo dnf install frankenphp
# to install extensions:
sudo dnf install php-zts-xdebug
# if an extension is not available by default, install it with pie
sudo dnf install php-zts-devel
sudo pie install asgrim/example-pie-extension --with-php-config=php-config-zts
```

### Docker

Alternatively, [Docker images](https://frankenphp.dev/docs/docker/) are available:
Expand Down Expand Up @@ -76,6 +91,8 @@ To serve the content of the current directory, run:
frankenphp php-server
```

If you need extensions, you will have to install them with [pie](https://github.com/php/pie).
Copy link

@You-saku You-saku Jul 24, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[imo]
I learned about pie for the first time.
Is it unnecessary to describe pecl? I feel that pecl is also well-known.

Copy link
Contributor Author

@henderkes henderkes Jul 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pecl is unmaintained and being phased out. Pie is its replacement.

Copy link

@You-saku You-saku Jul 25, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you your reply.


## Docs

- [Classic mode](https://frankenphp.dev/docs/classic/)
Expand Down
Loading