aloskutov / php-fishtext
从 https://fish-text.ru/ 获取鱼文本
v1.2.1
2023-01-11 18:35 UTC
Requires
- php: ^7.4 || ^8.1
- ext-json: *
Requires (Dev)
- phpunit/phpunit: ^9.5
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个)
格式
可以以 tex
或 html
格式返回数据。格式通过 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
- 添加本地生成器适配器
- 添加本地标题生成器