porsi haji checkerハッジ ポーション番号をチェックするための単純なライブラリであるだけでなく、コマンドライン インターフェイス (CLI) ベースのユーティリティでもあります。結果の出力は JSON データです。このユーティリティは、Web サイト ページ https://haji.kemenag.go.id/v3/node/955358 の CLI バージョンと考えることができます。
ここでは、 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 を使用して、haji.kemenag.go.id Web サイトから取得した HTML ページを解析します。
デモは https://porsihaji.rioastamal.net でご覧いただけます。
porsi haji checkerインストールするには、Composer を使用するか、Github ページで tarball をダウンロードできます。
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 ページから tarball をダウンロードできます。
$ git clone https://github.com/rioastamal/porsi-haji-checker.git
$ cd porsi-haji-checker
porsi haji checkerユーティリティまたはライブラリとして利用できます。
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"
}
以下は、PHP スクリプトでporsi haji checkerライブラリを使用する例です。 Composer の Autoloader を使用していると仮定します。
<?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コマンドを実行して、開発用のコンポーネントがインストールされていることを確認します。
$ 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)
Rio Astamal によって書かれたporsi haji checkerライブラリ [email protected]
このライブラリは、MIT ライセンス http://opensource.org/licenses/MIT を使用します。