---
title: "FrankenPHP: 适用于 PHP 的现代应用服务器"
sidebar:
  label: "简介"
seo:
  description: "FrankenPHP 是建立在 Caddy Web 服务器之上的现代 PHP 应用程序服务器。"
---
FrankenPHP 是建立在 [Caddy](https://caddyserver.com/) Web 服务器之上的现代 PHP 应用程序服务器。

FrankenPHP 凭借其令人惊叹的功能为你的 PHP 应用程序提供了超能力：[早期提示](/zh/docs/early-hints)、[worker 模式](/zh/docs/worker)、[实时功能](/zh/docs/mercure)、自动 HTTPS、HTTP/2 和 HTTP/3 支持......

FrankenPHP 可与任何 PHP 应用程序一起使用，并且由于提供了与 worker 模式的集成，使你的 Symfony 和 Laravel 项目比以往任何时候都更快。

FrankenPHP 也可以用作独立的 Go 库，将 PHP 嵌入到任何使用 `net/http` 的应用程序中。

[**了解更多** _frankenphp.dev_](/) 以及查看此演示文稿：

<a href="https://dunglas.dev/2022/10/frankenphp-the-modern-php-app-server-written-in-go/"><img src="https://dunglas.dev/wp-content/uploads/2022/10/frankenphp.png" alt="Slides" width="600"></a>

## 开始

在 Windows 上，请使用 [WSL](https://learn.microsoft.com/windows/wsl/) 运行 FrankenPHP。

### 安装脚本

你可以将以下命令复制到终端中，自动安装适用于你平台的版本：

```console
curl https://frankenphp.dev/install.sh | sh
```

### 独立二进制

我们为 Linux 和 macOS 提供用于开发的 FrankenPHP 静态二进制文件，
包含 [PHP 8.4](https://www.php.net/releases/8.4/zh.php) 以及大多数常用 PHP 扩展。

[下载 FrankenPHP](https://github.com/dunglas/frankenphp/releases)

**安装扩展：** 常见扩展已内置，无法再安装更多扩展。

### rpm 软件包

我们的维护者为所有使用 `dnf` 的系统提供 rpm 包。安装方式：

```console
sudo dnf install https://rpm.henderkes.com/static-php-1-0.noarch.rpm
sudo dnf module enable php-zts:static-8.4 # 可用 8.2-8.5
sudo dnf install frankenphp
```

**安装扩展：** `sudo dnf install php-zts-<extension>`

对于默认不可用的扩展，请使用 [PIE](https://github.com/php/pie)：

```console
sudo dnf install pie-zts
sudo pie-zts install asgrim/example-pie-extension
```

### deb 软件包

我们的维护者为所有使用 `apt` 的系统提供 deb 包。安装方式：

```console
sudo curl -fsSL https://key.henderkes.com/static-php.gpg -o /usr/share/keyrings/static-php.gpg && \
echo "deb [signed-by=/usr/share/keyrings/static-php.gpg] https://deb.henderkes.com/ stable main" | sudo tee /etc/apt/sources.list.d/static-php.list && \
sudo apt update
sudo apt install frankenphp
```

**安装扩展：** `sudo apt install php-zts-<extension>`

对于默认不可用的扩展，请使用 [PIE](https://github.com/php/pie)：

```console
sudo apt install pie-zts
sudo pie-zts install asgrim/example-pie-extension
```

### Docker

此外，还可以使用 [Docker 镜像](/zh/docs/docker)：

```console
docker run -v .:/app/public \
    -p 80:80 -p 443:443 -p 443:443/udp \
    dunglas/frankenphp
```

访问 `https://localhost`, 并享受吧!

<div class="fp-callout" data-callout="tip">
<p class="fp-callout-title">提示</p>

不要尝试使用 `https://127.0.0.1`。使用 `https://localhost` 并接受自签名证书。
使用 [`SERVER_NAME` 环境变量](/zh/docs/config#environment-variables) 更改要使用的域。

</div>

### Homebrew

FrankenPHP 也作为 [Homebrew](https://brew.sh) 软件包提供，适用于 macOS 和 Linux 系统。

安装方法：

```console
brew install dunglas/frankenphp/frankenphp
```

**安装扩展：** 使用 [PIE](https://github.com/php/pie)。

### 用法

要提供当前目录的内容，请运行：

```console
frankenphp php-server
```

你还可以使用以下命令运行命令行脚本：

```console
frankenphp php-cli /path/to/your/script.php
```

对于 deb 和 rpm 软件包，还可以启动 systemd 服务：

```console
sudo systemctl start frankenphp
```

## 文档

- [Classic 模式](/zh/docs/classic)
- [worker 模式](/zh/docs/worker)
- [早期提示支持(103 HTTP status code)](/zh/docs/early-hints)
- [实时功能](/zh/docs/mercure)
- [高效地服务大型静态文件](/zh/docs/x-sendfile)
- [配置](/zh/docs/config)
- [用 Go 编写 PHP 扩展](/zh/docs/extensions)
- [Docker 镜像](/zh/docs/docker)
- [在生产环境中部署](/zh/docs/production)
- [性能优化](/zh/docs/performance)
- [创建独立、可自行执行的 PHP 应用程序](/zh/docs/embed)
- [创建静态二进制文件](/zh/docs/static)
- [从源代码编译](/zh/docs/compile)
- [Laravel 集成](/zh/docs/laravel)
- [已知问题](/zh/docs/known-issues)
- [演示应用程序 (Symfony) 和性能测试](https://github.com/dunglas/frankenphp-demo)
- [Go 库文档](https://pkg.go.dev/github.com/dunglas/frankenphp)
- [贡献和调试](/zh/docs/contributing)

## 示例和框架

- [Symfony](https://github.com/dunglas/symfony-docker)
- [API Platform](https://api-platform.com/docs/distribution/)
- [Laravel](/zh/docs/laravel)
- [Sulu](https://sulu.io/blog/running-sulu-with-frankenphp)
- [WordPress](https://github.com/StephenMiracle/frankenwp)
- [Drupal](https://github.com/dunglas/frankenphp-drupal)
- [Joomla](https://github.com/alexandreelise/frankenphp-joomla)
- [TYPO3](https://github.com/ochorocho/franken-typo3)
- [Magento2](https://github.com/ekino/frankenphp-magento2)