porsi haji checker é uma biblioteca simples, bem como um utilitário baseado em interface de linha de comando (CLI) para verificar os números das porções do Hajj. A saída resultante são dados JSON. Este utilitário pode ser considerado a versão CLI da página do site https://haji.kemenag.go.id/v3/node/955358.
Veja como usar porsi haji checker como um utilitário 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 usa a Biblioteca PHP Padrão (SPL), ou seja, DOMDocument e DOMXPath para analisar páginas HTML obtidas no site haji.kemenag.go.id.
A demonstração está disponível em https://porsihaji.rioastamal.net.
Para instalar porsi haji checker , você pode usar o Composer ou baixar o tarball na página do Github.
Certifique-se de que composer
esteja instalado em seu sistema. Em seguida, execute o seguinte comando para instalar.
$ composer create-project -vvv rioastamal/porsi-haji-checker porsi-haji-checker
$ cd porsi-haji-checker
Se você quiser usar a versão de produção, adicione a opção --no-dev
.
$ composer create-project -vvv --no-dev rioastamal/porsi-haji-checker porsi-haji-checker
A instalação manual pode usar o Git ou baixar o tarball da página do Github.
$ git clone https://github.com/rioastamal/porsi-haji-checker.git
$ cd porsi-haji-checker
porsi haji checker pode ser usada como um utilitário ou uma biblioteca.
A localização do utilitário porsi haji checker está no diretório bin/. Este utilitário requer um argumento na forma do número da porção do Hajj. Aqui está um exemplo.
$ 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"
}
Além de passar argumentos, você também pode fornecer o número da porção do Hajj via fluxo STDIN. Aqui está um exemplo.
$ 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"
}
A seguir está um exemplo de uso da biblioteca porsi haji checker em um script PHP. Supondo que você esteja usando o Autoloader do 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
)
*/
Certifique-se de que os componentes para desenvolvimento estejam instalados executando o seguinte comando do compositor.
$ composer install -vvv
Este comando instalará os componentes necessários para o desenvolvimento. Então o teste de unidade pode ser executado com o seguinte comando.
$ ./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)
Biblioteca porsi haji checker escrita por Rio Astamal [email protected]
Esta biblioteca usa a licença MIT http://opensource.org/licenses/MIT.