---
title: "Laravel"
sidebar:
  label: "Laravel 集成"
  order: 0
seo:
  description: "使用 FrankenPHP 为 Laravel Web 应用程序提供服务就像将项目挂载到官方 Docker 镜像的 /app 目录中一样简单。"
---
## Docker

使用 FrankenPHP 为 [Laravel](https://laravel.com) Web 应用程序提供服务就像将项目挂载到官方 Docker 镜像的 `/app` 目录中一样简单。

从 Laravel 应用程序的主目录运行以下命令：

```console
docker run -p 80:80 -p 443:443 -p 443:443/udp -v $PWD:/app dunglas/frankenphp
```

尽情享受吧！

## 本地安装

或者，你可以从本地机器上使用 FrankenPHP 运行 Laravel 项目：

1. [下载与你的系统相对应的二进制文件](https://github.com/php/frankenphp/releases)
2. 将以下配置添加到 Laravel 项目根目录中名为 `Caddyfile` 的文件中：

   ```caddyfile
   {
   	frankenphp
   }

   # 服务器的域名
   localhost {
   	# 将 webroot 设置为 public/ 目录
   	root public/
   	# 启用压缩(可选)
   	encode zstd br gzip
   	# 执行当前目录中的 PHP 文件并提供资源
   	php_server {
   	    try_files {path} index.php
       }
   }
   ```

3. 从 Laravel 项目的根目录启动 FrankenPHP：`frankenphp run`

## Laravel Octane

Octane 可以通过 Composer 包管理器安装：

```console
composer require laravel/octane
```

安装 Octane 后，你可以执行 `octane:install` Artisan 命令，该命令会将 Octane 的配置文件安装到你的应用程序中：

```console
php artisan octane:install --server=frankenphp
```

Octane 服务可以通过 `octane:frankenphp` Artisan 命令启动。

```console
php artisan octane:frankenphp
```

`octane:frankenphp` 命令可以采用以下选项：

- `--host`: 服务器应绑定到的 IP 地址（默认值: `127.0.0.1`）
- `--port`: 服务器应可用的端口（默认值: `8000`）
- `--admin-port`: 管理服务器应可用的端口（默认值: `2019`）
- `--workers`: 应可用于处理请求的 worker 数（默认值: `auto`）
- `--max-requests`: 在 worker 重启之前要处理的请求数（默认值: `500`）
- `--caddyfile`：FrankenPHP `Caddyfile` 文件的路径（默认： [Laravel Octane 中的存根 `Caddyfile`](https://github.com/laravel/octane/blob/2.x/src/Commands/stubs/Caddyfile)）
- `--https`: 开启 HTTPS、HTTP/2 和 HTTP/3，自动生成和延长证书
- `--http-redirect`: 启用 HTTP 到 HTTPS 重定向（仅在使用 `--https` 时启用）
- `--watch`: 修改应用程序时自动重新加载服务器
- `--poll`: 在监视时使用文件系统轮询，以便通过网络监视文件
- `--log-level`: 在指定日志级别或高于指定日志级别的日志消息

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

要获取结构化的 JSON 日志（在使用日志分析解决方案时非常有用），请明确传递 `--log-level` 选项。

</div>

你可以了解更多关于 [Laravel Octane 官方文档](https://laravel.com/docs/octane)。

## Laravel 应用程序作为独立的可执行文件

使用[FrankenPHP 的应用嵌入功能](/zh/docs/embed)，可以将 Laravel 应用程序作为
独立的二进制文件分发。

按照以下步骤将您的Laravel应用程序打包为Linux的独立二进制文件：

1. 在您的应用程序的存储库中创建一个名为 `static-build.Dockerfile` 的文件:

   ```dockerfile
   FROM --platform=linux/amd64 dunglas/frankenphp:static-builder-gnu
   # 如果你打算在 musl-libc 系统上运行该二进制文件，请使用 static-builder-musl

   # 复制你的应用
   WORKDIR /go/src/app/dist/app
   COPY . .

   # 删除测试和其他不必要的文件以节省空间
   # 或者，将这些文件添加到 .dockerignore 文件中
   RUN rm -Rf tests/

   # 复制 .env 文件
   RUN cp .env.example .env
   # 将 APP_ENV 和 APP_DEBUG 更改为适合生产环境
   RUN sed -i'' -e 's/^APP_ENV=.*/APP_ENV=production/' -e 's/^APP_DEBUG=.*/APP_DEBUG=false/' .env

   # 根据需要对您的 .env 文件进行其他更改

   # 安装依赖项
   RUN composer install --ignore-platform-reqs --no-dev -a

   # 构建静态二进制文件
   WORKDIR /go/src/app/
   RUN EMBED=dist/app/ ./build-static.sh
   ```

   <div class="fp-callout" data-callout="caution">
   <p class="fp-callout-title">小心</p>

   一些 `.dockerignore` 文件
   将忽略 `vendor/` 目录和 `.env` 文件。在构建之前，请确保调整或删除 `.dockerignore` 文件。

   </div>

2. 构建:

   ```console
   docker build -t static-laravel-app -f static-build.Dockerfile .
   ```

3. 提取二进制:

   ```console
   docker cp $(docker create --name static-laravel-app-tmp static-laravel-app):/go/src/app/dist/frankenphp-linux-x86_64 frankenphp ; docker rm static-laravel-app-tmp
   ```

4. 填充缓存：

   ```console
   frankenphp php-cli artisan optimize
   ```

5. 运行数据库迁移（如果有的话）：

   ```console
   frankenphp php-cli artisan migrate
   ```

6. 生成应用程序的密钥：

   ```console
   frankenphp php-cli artisan key:generate
   ```

7. 启动服务器：

   ```console
   frankenphp php-server
   ```

您的应用程序现在准备好了！

了解有关可用选项的更多信息，以及如何为其他操作系统构建二进制文件，请参见 [应用程序嵌入](/zh/docs/embed)
文档。

### 更改存储路径

默认情况下，Laravel 将上传的文件、缓存、日志等存储在应用程序的 `storage/` 目录中。
这不适合嵌入式应用，因为每个新版本将被提取到不同的临时目录中。

设置 `LARAVEL_STORAGE_PATH` 环境变量（例如，在 `.env` 文件中）或调用 `Illuminate\Foundation\Application::useStoragePath()` 方法以使用临时目录之外的目录。

### 使用独立二进制文件运行 Octane

甚至可以将 Laravel Octane 应用打包为独立的二进制文件！

为此，[正确安装 Octane](#laravel-octane) 并遵循 [前一部分](#laravel-应用程序作为独立的可执行文件) 中描述的步骤。

然后，通过 Octane 在工作模式下启动 FrankenPHP，运行：

```console
PATH="$PWD:$PATH" frankenphp php-cli artisan octane:frankenphp
```

<div class="fp-callout" data-callout="caution">
<p class="fp-callout-title">小心</p>

为了使命令有效，独立二进制文件**必须**命名为 `frankenphp`
因为 Octane 需要一个名为 `frankenphp` 的程序在路径中可用。

</div>