Скачать porsi haji checker - porsi haji checker Скачать исходный код

porsi haji checker

Другие категории

1.0.0

Скачать

О

porsi haji checker — это простая библиотека, а также утилита на основе интерфейса командной строки (CLI) для проверки номеров порций хаджа. Результатом являются данные JSON. Эту утилиту можно считать CLI-версией страницы сайта https://haji.kemenag.go.id/v3/node/955358.

Вот как можно использовать porsi haji checker в качестве утилиты CLI.

$ php bin/porsi-haji-checker.php 3000837XXX
{
    " nomor_porsi " : " 3000837XXX " ,
    " nama " : " HAMBA ALLAH INDONESIA " ,
    " kabupaten_kota " : " KOTA SURABAYA " ,
    " provinsi " : " JAWA TIMUR " ,
    " kuota " : " 12345 " ,
    " posisi_porsi_kuota " : " 12233 " ,
    " perkiraan_tahun_berangkat_hijriah " : " 1444 " ,
    " perkiraan_tahun_berangkat_masehi " : " 2023 "
}

porsi haji checker использует стандартную библиотеку PHP (SPL), а именно DOMDocument и DOMXPath, для анализа HTML-страниц, полученных с веб-сайта haji.kemenag.go.id.

Демо-версия доступна по адресу https://porsihaji.riooastamal.net.

Установка

Чтобы установить porsi haji checker , вы можете использовать Composer или загрузить архив со страницы Github.

Композитор

Убедитесь, что в вашей системе установлен composer . Затем выполните следующую команду для установки.

 $ composer create-project -vvv rioastamal/porsi-haji-checker porsi-haji-checker
$ cd porsi-haji-checker

Если вы хотите использовать производственную версию, добавьте опцию --no-dev .

 $ composer create-project -vvv --no-dev rioastamal/porsi-haji-checker porsi-haji-checker

Руководства

Для ручной установки можно использовать Git или загрузить архив со страницы Github.

 $ git clone https://github.com/rioastamal/porsi-haji-checker.git
$ cd porsi-haji-checker

Использовать

porsi haji checker можно использовать как утилиту или библиотеку.

Как утилита CLI

Утилита porsi haji checker находится в каталоге bin/. Эта утилита требует аргумента в виде номера части хаджа. Вот пример.

 $ php bin/porsi-haji-checker.php 3000837XXX
{
    "nomor_porsi": "3000837XXX",
    "nama": "HAMBA ALLAH INDONESIA",
    "kabupaten_kota": "KOTA SURABAYA",
    "provinsi": "JAWA TIMUR",
    "kuota": "12345",
    "posisi_porsi_kuota": "12233",
    "perkiraan_tahun_berangkat_hijriah": "1444",
    "perkiraan_tahun_berangkat_masehi": "2023"
}

Помимо передачи аргументов, вы также можете указать номер части хаджа через поток STDIN. Вот пример.

 $ echo "3000837XXX" | php bin/porsi-haji-checker.php
{
    "nomor_porsi": "3000837XXX",
    "nama": "HAMBA ALLAH INDONESIA",
    "kabupaten_kota": "KOTA SURABAYA",
    "provinsi": "JAWA TIMUR",
    "kuota": "12345",
    "posisi_porsi_kuota": "12233",
    "perkiraan_tahun_berangkat_hijriah": "1444",
    "perkiraan_tahun_berangkat_masehi": "2023"
}

Как библиотека

Ниже приведен пример использования библиотеки porsi haji checker в скрипте PHP. Предполагая, что вы используете автозагрузчик Composer.

 <?php
require __DIR__ . ' /../vendor/autoload.php ' ;

// Jika tidak menggunakan autoload cukup require dua script berikut
// require __DIR__ . '/src/NomorHajiScraper.php
// require __DIR__ . '/src/NomorHajiParser.php

use RioAstamal  Kemenag  NomorHajiScraper ;
use RioAstamal  Kemenag  NomorHajiParser ;

$ nomorPorsi = ' 3000837XXX ' ;
$ scrapper = NomorHajiScraper:: create ( $ nomorPorsi );
$ parser = NomorHajiParser:: create ( $ scrapper );

$ jsonInfoPorsi = $ parser -> parse ();
print_r ( json_decode ( $ jsonInfoPorsi ), JSON_OBJECT_AS_ARRAY );

/* output
Array
(
    [nomor_porsi] => 3000837XXX
    [nama] => HAMBA ALLAH INDONESIA
    [kabupaten_kota] => KOTA SURABAYA
    [provinsi] => JAWA TIMUR
    [kuota] => 12345
    [posisi_porsi_kuota] => 12233
    [perkiraan_tahun_berangkat_hijriah] => 1444
    [perkiraan_tahun_berangkat_masehi] => 2023
)
*/

Запуск модульных тестов

Убедитесь, что компоненты для разработки установлены, выполнив следующую команду композитора.

 $ composer install -vvv

Эта команда установит компоненты, необходимые для разработки. Затем модульный тест можно запустить с помощью следующей команды.

 $ ./vendor/bin/phpunit --debug
PHPUnit 6.5.14 by Sebastian Bergmann and contributors.

Test 'RioAstamalKemenagTestNomorHajiParserTest::testReturnJsonSuccess' started
Test 'RioAstamalKemenagTestNomorHajiParserTest::testReturnJsonSuccess' ended
Test 'RioAstamalKemenagTestNomorHajiParserTest::testReturnJsonButEmpty' started
Test 'RioAstamalKemenagTestNomorHajiParserTest::testReturnJsonButEmpty' ended
Test 'RioAstamalKemenagTestNomorHajiParserTest::testScraperReturnError' started
Test 'RioAstamalKemenagTestNomorHajiParserTest::testScraperReturnError' ended


Time: 49 ms, Memory: 4.00MB

OK (3 tests, 15 assertions)