wearedevtical/laravel-quran

Laravel Quran 静态 Eloquent 模型

v1.0.0 2021-07-25 21:35 UTC

This package is auto-updated.

Last update: 2024-09-04 16:40:56 UTC


README

بِسْمِ ٱللّٰهِ الرَّحْمٰنِ الرَّحِيْمِ

Laravel Quran 是用于 Quran 的静态 Eloquent 模型。

《古兰经》从未改变,也永远不会改变,因为真主在保护它。(15:9) إِنَّا نَحۡنُ نَزَّلۡنَا ٱلذِّكۡرَ وَإِنَّا لَهُۥ لَحَـٰفِظُونَ。所有数据都是从 API 获取的。变化仅发生在翻译和转写。

安装

通过 Composer

$ composer require wearedevtical/laravel-quran

使用方法

通过 ID 查找章节

$surah = Surah::find(36);
[
  "id" => 36
  "title" => "سُورَةُ يسٓ"
  "transliteration" => "Yaseen"
]

从章节获取所有节文

$surah->ayahs;
[
  0 => array:7 [
    "id" => 3706
    "surah_id" => "36"
    "content" => "بِسْمِ ٱللَّهِ ٱلرَّحْمَٰنِ ٱلرَّحِيمِ يسٓ"
    "translate_en" => "O THOU human being!"
    "translate_id" => "Yaa siin"
    "number" => "1"
    "juz" => "22"
  ]
  1 => array:7 [
    "id" => 3707
    "surah_id" => "36"
    "content" => "وَٱلْقُرْءَانِ ٱلْحَكِيمِ"
    "translate_en" => "Consider this Qur’an full of wisdom:"
    "translate_id" => "Demi Al Quran yang penuh hikmah,"
    "number" => "2"
    "juz" => "22"
  ]
  ...
]

通过 ID 查找节文

$ayah  = Ayah::find(3787);
[
  "id" => 3787
  "surah_id" => "36"
  "content" => "إِنَّمَآ أَمْرُهُۥٓ إِذَآ أَرَادَ شَيْـًٔا أَن يَقُولَ لَهُۥ كُن فَيَكُونُ"
  "translate_en" => "His Being alone is such that when He wills a thing to be, He but says unto it, “Be” — and it is."
  "translate_id" => "Sesungguhnya keadaan-Nya apabila Dia menghendaki sesuatu hanyalah berkata kepadanya: "Jadilah!" maka terjadilah ia."
  "number" => "82"
  "juz" => "23"
]

变更日志

请参阅 变更日志 以获取更多关于最近更改的信息。

测试

$ composer test

贡献

请参阅 CONTRIBUTING.md 以获取详细信息。

安全性

如果您发现任何与安全相关的问题,请通过电子邮件联系作者,而不是使用问题跟踪器。

致谢

许可

MIT 许可证 (MIT)。请参阅 许可文件 以获取更多信息。