mor/farsi-poem

V0.1.0 2022-04-22 18:20 UTC

This package is auto-updated.

Last update: 2024-09-22 23:05:15 UTC


README

使用API获取随机波斯诗。

FarsiPoem与https://api.ganjoor.net/ api协同工作。

设置

使用composer安装包

composer require mor/farsi-poem

使用方法

use FarsiPoem\FarsiPoem;

$poem = new FarsiPoem();

获取随机诗

echo $poem->random()->plainText;

按诗人获取随机诗

甘조우诗人列表:哈菲兹(2),内扎米(3),阿布·萨伊德·阿布·阿尔-卡希尔(26),萨义德(22),萨迪(7),巴图塔赫拉(28),莫拉维(5),欧赫迪(19),霍贾(20),沙里亚尔(35),伊拉克伊(21),弗鲁吉·巴斯坦米(32),萨勒曼·萨乌吉(40),玛赫什·卡什阿尼(29),阿米尔·喀什罗·德赫勒维(34),西夫·弗尔加尼(31),阿维德·扎卡尼(33),哈泰夫·伊斯法罕尼(25)或雷希·梅里里(41)

$poet_id = 2; // default = 0 : random poem from random poet

$poem->random($poet_id);

echo $poem->plainText;

历史模式

此功能与php会话一起工作,当使用save()方法时,诗歌将保存在用户会话中,并在页面刷新和不同页面上向用户显示相同的诗歌。

$poem->save()->random();

echo $poem->plainText;

其他

$poem->save()->random();

echo $poem->plainText; // show plain text of poem.

echo $poem->verses; // show object of verses (by ganjoor api).

echo $poem->verses(Int $count = 0); // only get $count verses: 0 means all verses.

echo $poem->versesAsPlain(Int $count = 0, String $seperator = ' / '):

echo $poem->poet;