raakiiib / aladhan-api-client-php Goto Github PK

This is a PHP API client that uses the rest API at aladhan.com to generate prayer times for Islamic prayers.

For more information, please visit http://aladhan.com/prayer-times-api.

This client is used to build various parts of AlAdhan.com, including apps https://aladhan.com/ramadan-prayer-times/2017/London/UK and https://aladhan.com/ramadan-calendar.

The API Client is a composer package. To use it, you need to run the following:

composer require aladhan/api-client

To get prayer times for a given day, use:

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

You can also do this by city:

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

The $unix_timestamp is a timestamp from the day you want prayer times for. Valid $timezones are listed @ http://php.net/manual/en/timezones.php. See the Getting Co-ordinates below for getting $latitude and $longitude. The $method options can be seen in the Methods class.

This will return the JSON output as shown on @ http://aladhan.com/rest-api#endpointTimings.

To get a list of prayer times for an entire month in a given year, use:

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

You can also do this by city:

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

There's also a Location class included with this API that uses Google's geocoding API to convert an address into co-ordinates. Google's API has a free limit (but you need to be making thousands of requests a day for this to kick in), and then they'll cut you off unless you get a license. In any case, this should be sufficient for more people. If you will be making millions of requests, there are other ways to do this. Just get in touch if you need help.

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

You can now use the above values with the Times or Calendar class to get your prayer times.

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

For support, please visit http://aladhan.com/prayer-times-api or http://aladhan.com/contact.