Whisper.php 安装与配置指南

Whisper.php 安装与配置指南

whisper.php Local Speech to Text in PHP made easy thanks to Whisper.cpp and OpenAI 项目地址: https://gitcode.com/gh_mirrors/wh/whisper.php

1. 项目基础介绍

Whisper.php 是一个 PHP 绑定库，用于 whisper.cpp，这是一个自动语音识别和转录的库。通过 Whisper.php，开发者可以在 PHP 环境中利用 whisper.cpp 的功能，实现对音频文件的转录。

主要的编程语言：PHP

2. 项目使用的关键技术和框架

• whisper.cpp: Whisper.cpp 是一个基于深度学习的自动语音识别（ASR）库，它使用神经网络对音频进行转录。
• FFI (Foreign Function Interface): PHP 的 FFI 扩展允许 PHP 代码调用其他语言编写的函数，如 C 语言。
• libsndfile: 用于读取和写入多种音频文件格式的库。
• libsamplerate: 用于音频重采样的库。

3. 项目安装和配置的准备工作

在开始安装 Whisper.php 前，请确保您的环境满足以下要求：

• PHP 版本 8.1 或以上
• 已经启用 PHP 的 FFI 扩展

安装步骤

1. 安装 PHP FFI 扩展

首先，确保您的 PHP 环境中已经安装了 FFI 扩展。如果没有安装，您可以通过以下命令安装：

sudo apt-get install php-ffi

如果您使用的是其他操作系统，请根据相应的包管理器进行安装。

2. 使用 Composer 安装 Whisper.php

使用 Composer 安装 Whisper.php，Composer 是 PHP 的依赖管理工具。在您的项目根目录下执行以下命令：

composer require codewithkyrian/whisper.php

这将自动下载 Whisper.php 库及其依赖项。

3. 下载和配置音频模型

Whisper.php 需要下载 whisper.cpp 的音频模型文件。在库的文档中有说明如何自动下载模型，以下是一个示例：

$modelPath = ModelLoader::loadModel('tiny.en', __DIR__ . '/models');

上述代码会检查 __DIR__/models 目录下是否存在 ggml-tiny.en.bin 模型文件，如果不存在，则会自动从 whisper.cpp 的官方 huggingface 仓库下载。

4. 测试安装

安装完成后，您可以通过以下简单的 PHP 脚本来测试是否安装成功：

<?php

require 'vendor/autoload.php';

use CodeWithKyrian\Whisper\Whisper;

$whisper = Whisper::fromPretrained('tiny.en', baseDir: __DIR__ . '/models');
$audio = readAudio(__DIR__ . '/path/to/your/audio/file.wav');
$segments = $whisper->transcribe($audio, 4);

foreach ($segments as $segment) {
    echo $segment->text . PHP_EOL;
}

?>

请确保替换 __DIR__ . '/path/to/your/audio/file.wav' 为您的音频文件路径。

以上步骤应该能够帮助您成功安装和配置 Whisper.php。如果您在安装过程中遇到任何问题，请参考项目的官方文档或向维护者寻求帮助。

whisper.php Local Speech to Text in PHP made easy thanks to Whisper.cpp and OpenAI 项目地址: https://gitcode.com/gh_mirrors/wh/whisper.php