aloskutov/php-fishtext

从 https://fish-text.ru/ 获取鱼文本

v1.2.1 2023-01-11 18:35 UTC

This package is auto-updated.

Last update: 2024-09-11 22:03:45 UTC


README

通过API从FishText网站(https://fish-text.ru/get)获取数据,该网站生成三种类型的测试内容:标题、句子和段落。

要求

  • PHP 7.4或更高版本
  • 对于PHP 7.4,需要 mbstring 扩展

安装

composer require aloskutov/php-fishtext

适配器

可以使用两个适配器之一来获取在线数据(来自网站 https://fish-text.ru/)或生成本地文本。

默认连接到在线适配器。本地生成器提供数据速度更快,但生成的标题与文本相似度较低。

使用本地生成器

use ALoskutov\FishText\FishText;
use ALoskutov\FishText\FishTextAdaptorLocal;

$fishtext = new FishText(new FishTextAdaptorLocal());

数据

支持三种类型的数据

  • 标题(1至500个标题,默认:1个)
  • 句子(1至500个句子,默认:3个)
  • 段落(1至100个段落,默认:3个)

格式

可以以 texhtml 格式返回数据。格式通过 setFormat() 方法设置,默认为 text 格式。

text

使用示例

use ALoskutov\FishText\FishText;

$fishtext = new FishText();
$fishtext->setFormat('text');
echo $fishtext->title();

输出为字符串。请求多个段落时,段落由 \n\n 符号分隔。

html

使用示例

use ALoskutov\FishText\FishText;

$fishtext = new FishText();
$fishtext->setFormat('html');
echo $fishtext->paragraph(5);

数据被html标签包裹。

  • 句子(使用 sentence() 方法)被 <h1> 标签包裹。
  • 标题(使用 title() 方法)被 <p> 标签包裹。
  • 段落(使用 paragraph() 方法)每个段落被 <p> 标签包裹。

示例

<?php

declare(strict_types=1);

require_once("vendor/autoload.php");

use ALoskutov\FishText\FishText;

$fishtext = new FishText();

// Запрашиваем данные типа Заголовок, одно предложение (по-умолчанию)
var_dump($fishtext->title());

// Устанавливаем формат возвращаемых данных: HTML
$fishtext->setFormat('html');

// Запрашиваем данные типа Предложение, три предложения (по-умолчанию)
var_dump($fishtext->sentence());

// Запрашиваем данные типа Абзац, по умолчанию три абзаца (по-умолчанию)
var_dump($fishtext->paragraph());

TODO

  • 添加本地生成器适配器
  • 添加本地标题生成器