PHPackages                             redadevcraft/quran-hizb-data - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. redadevcraft/quran-hizb-data

ActiveLibrary[Utility & Helpers](/categories/utility)

redadevcraft/quran-hizb-data
============================

A lightweight dataset of the Qur'an Hizb divisions, available in multiple formats (JSON, XML, CSV, and SQL). This package provides the 60 hizbs of the Qur'an with both top-down and bottom-up numbering, making it easy to integrate into Islamic apps, educational platforms, or research projects.

2962PHP

Since Oct 4Pushed 7mo agoCompare

[ Source](https://github.com/redaDevCraft/hizbs-warsh-dataset)[ Packagist](https://packagist.org/packages/redadevcraft/quran-hizb-data)[ RSS](/packages/redadevcraft-quran-hizb-data/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Hizbs Warsh Dataset
===================

[](#hizbs-warsh-dataset)

[![License: MIT](https://camo.githubusercontent.com/b8cadaa967891081f8f165695470689986c028821dd8a040132f6e661795dc0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c7565)](https://camo.githubusercontent.com/b8cadaa967891081f8f165695470689986c028821dd8a040132f6e661795dc0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c7565)

Important Disclaimer
--------------------

[](#important-disclaimer)

- This project does **not** provide tafsir (interpretation) or religious rulings of the Qur'an. The dataset is intended strictly as a technical resource.
- The author is **not** a religious scholar; the author is a computer science specialist.
- Use this dataset as a data/tooling resource for software development, research, and educational applications; do not rely on it as a religious or jurisprudential reference.

Overview
--------

[](#overview)

Hizbs Warsh Dataset is a structured dataset of the 60 hizb divisions of the Qur'an. It is provided in multiple export formats and includes metadata designed to make integration into applications, research pipelines, and educational tools straightforward.

Features
--------

[](#features)

- Complete dataset of all 60 hizbs.
- Multiple formats: JSON, XML, SQL.
- Dual numbering support: up-to-down and down-to-top.
- Implementations / helper APIs for JavaScript/Node.js and PHP.
- Rich metadata per hizb: name, start/end surah, ayah indices, descriptions.
- Utility scripts for export generation and data validation.

Installation
------------

[](#installation)

### Node.js / JavaScript (npm)

[](#nodejs--javascript-npm)

```
npm install hizbs-warsh-dataset
```

### PHP (Composer)

[](#php-composer)

```
composer require redadevcraft/quran-hizb-data
```

Usage
-----

[](#usage)

### JavaScript / Node.js

[](#javascript--nodejs)

```
const {
  getAllHizbs,
  getHizbById,
  getHizbByOrderUp,
  getHizbByOrderDown,
} = require("hizbs-warsh-dataset");

// Get all hizbs
const allHizbs = getAllHizbs();

// Get specific hizb by ID (1-60)
const hizb = getHizbById(1);

// Get hizb by order (up-to-down)
const hizbByOrder = getHizbByOrderUp(30);

// Get hizb by order (down-to-top)
const hizbByOrderDown = getHizbByOrderDown(15);
```

### PHP

[](#php)

```