porsi haji checker是一个简单的库以及基于命令行界面 (CLI) 的实用程序,用于检查 Hajj 部分编号。结果输出是 JSON 数据。该实用程序可以被视为网站页面 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 网站获取的 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)
porsi haji checker库由 Rio Astamal 编写 [email protected]
该库使用 MIT 许可证 http://opensource.org/licenses/MIT。