该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。

该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。

该页面已由社区翻译,可能不是最新的。参见参考版本(英文)。

由...提供支持
Yii3

Yii3

# 使用 FrankenPHP Docker 镜像运行 Yii3

使用 FrankenPHP 提供 Yii Web 应用程序就像将项目挂载到官方 Docker 镜像的 /app 目录一样简单。

在您的 Yii 应用程序的主目录中运行此命令:

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

尽情享受吧!

# 本地安装 FrankenPHP 运行 Yii3

或者,您可以在本地机器上使用 FrankenPHP 运行 Yii 项目:

  1. 下载与您的系统对应的二进制文件

  2. 将以下配置添加到您的 Yii 项目根目录中名为 Caddyfile 的文件中:

    {
    	frankenphp
    }
    
    # 您服务器的域名
    localhost {
    	# 启用压缩(可选)
    	encode zstd br gzip
    	# 从 public/ 目录执行 PHP 文件并提供静态资源
    	php_server {
    		root public/
    		try_files {path} index.php
    	}
    }
    
  3. 从您的 Yii 项目的根目录启动 FrankenPHP:frankenphp run

# Yii3 worker 模式

要在 worker 模式下运行您的 Yii 应用程序,请安装 Yii FrankenPHP runner:

composer require yiisoft/yii-runner-frankenphp

然后,在您的应用程序的根目录中创建一个名为 worker.php 的文件:

<?php

declare(strict_types=1);

use Yiisoft\Yii\Runner\FrankenPHP\FrankenPHPApplicationRunner;

require_once __DIR__ . '/vendor/autoload.php';

(new FrankenPHPApplicationRunner(rootPath: __DIR__))->run();

更新您的 Caddyfile 以在 worker 模式下启动应用程序:

{
	frankenphp
}

localhost {
	encode zstd br gzip
	php_server {
		root public/
		worker ./worker.php {
			# 将所有请求发送到 worker
			match *
			# 当 PHP 文件发生变化时重新加载 worker(仅限开发环境)
			watch ./**/*.php
		}
	}
}

如果您的应用程序基于 官方 Yii 应用程序模板,请参阅包的 README 以获取包含调试、环境和错误处理程序配置的完整 worker.php 示例。

要限制 worker 在重启前处理的请求数量(有助于缓解内存泄漏),请设置 MAX_REQUESTS 环境变量。默认情况下,worker 无限期地处理请求。

使用 worker 模式时,请确保有状态服务在每次请求后都会重置。有关详细信息,请参阅 worker 模式文档 和 Yii DI StateResetter 文档。

编辑此页面