README

AlAdhan 祈祷时间 API 客户端 (PHP)

这是一个使用 aladhan.com 的 REST API 生成伊斯兰祈祷时间的 PHP API 客户端。

更多信息，请访问 http://aladhan.com/prayer-times-api。

该客户端用于构建 AlAdhan.com 的各个部分，包括应用程序 https://aladhan.com/ramadan-prayer-times/2017/London/UK 和 https://aladhan.com/ramadan-calendar。

安装

API 客户端是一个 composer 包。要使用它，您需要运行以下命令

composer require aladhan/api-client

用法

生成特定日期的祈祷时间

要获取特定日期的祈祷时间，请使用

$t = new \AlAdhanApi\Times($unix_timestamp , $timezone, $latitude, $longitude, $method);
$times = $t->get();

您也可以通过城市进行操作

$t = new \AlAdhanApi\TimesByCity('Dubai' , 'United Arab Emirates', $timestamp);
$times = $t->get();

$unix_timestamp 是您想要获取祈祷时间的日期的时间戳。有效的 $timezones 列表请参考 @ https://php.ac.cn/manual/en/timezones.php。有关获取 $latitude 和 $longitude 的说明，请参见下面的获取坐标部分。$method 选项可以在 Methods 类中查看。

这将返回如 @ http://aladhan.com/rest-api#endpointTimings 上所示的 JSON 输出。

生成特定月份的祈祷时间

要获取特定年份整月的祈祷时间列表，请使用

$c = new \AlAdhanApi\Calendar($month, $year, $timezone, $latitude, $longitude);
$calendar = $c->get();

您也可以通过城市进行操作

$c = new \AlAdhanApi\CalendarByCity('Dubai', 'United Arab Emirates', $month, $year);
$calendar = $c->get();

获取经纬度坐标

此 API 还包含一个 Location 类，该类使用 Google 的地理编码 API 将地址转换为坐标。Google 的 API 有一个免费限制（但您每天需要发出数千次请求才能触发此限制），然后他们会切断您的连接，除非您获得许可证。无论如何，这对大多数人来说应该是足够的。如果您将要发出数百万次请求，还有其他方法可以做到这一点。如果需要帮助，请与我们联系。

$l = new \AlAdhanApi\Location('Sultanahmet Mosque, Istanbul, Turkey'); // Use a location of your choice here.
$latitude = $l->latitude;
$longitude = $l->longitude;

现在您可以使用 Times 或 Calendar 类使用上述值来获取您的祈祷时间。

作者和贡献者

Meezaan-ud-Din Abdu Dhil-Jalali Wal-Ikram (@meezaan)。

支持或联系

有关支持，请访问 http://aladhan.com/prayer-times-api 或 http://aladhan.com/contact。