Official International Name days API library

VojtaN

Last update: Feb 25, 2022

Related tags

Third Party APIs nameday-api

Overview

Official International Name days API library

Name day API library for nameday.abalin.net

This library makes it easy to send requests towards nameday.abalin.net API. API provides name days for various countries.

Installation

The recommended way to install package is through Composer.

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version of package:

composer require xnekv03/nameday-api

After installing, you need to require Composer's autoloader:

require 'vendor/autoload.php';

You can then later update package using composer:

composer update

List of supported countries

Constantly adding new Country codes, please check nameday.abalin.net for updated list.

When using country codes in the library you can use either country names or country codes.

Country names
- United States
- Czech Republic
- Slovakia
- Poland
- France
- Hungary
- Croatia
- Sweden
- Austria
- Italy
- Germany
- Spain
Country codes
- us
- cz
- sk
- pl
- fr
- hu
- hr
- se
- at
- it
- de
- es

Usage

create an instance of the class

$nameday = new Nameday();
$nameday = new Nameday('America/Vancouver'); # time zone specification, other then system default (see below)

Request name days for today / tomorrow / yesterday

tomorrow(); # {"data":{"day":28,"month":8,"name_us":"Agustin, August, Augusta ... }} echo $nameday->yesterday(); # {"data":{"day":26,"month":8,"name_us":"Percival, Percy ... }}">

echo $nameday->today(); # {"data":{"day":27,"month":8,"name_us":"Caesar, Cesar ... }}
echo $nameday->tomorrow(); # {"data":{"day":28,"month":8,"name_us":"Agustin, August, Augusta ... }}
echo $nameday->yesterday(); # {"data":{"day":26,"month":8,"name_us":"Percival, Percy ... }}

Request name days for today / tomorrow / yesterday for specific country only

today('Slovakia'); # {"data":{"day":27,"month":8,"name_sk":"Silvia"}} echo $nameday->tomorrow('at'); # {"data":{"day":28,"month":8,"name_at":"Adelinde, Aline, Augustin"}} echo $nameday->tomorrow('Austria'); # {"data":{"day":28,"month":8,"name_at":"Adelinde, Aline, Augustin"}} echo $nameday->yesterday('de'); # {"data":{"day":26,"month":8,"name_de":"Margarita, Miriam, Patricia, Teresa"}} echo $nameday->yesterday('Germany'); # {"data":{"day":26,"month":8,"name_de":"Margarita, Miriam, Patricia, Teresa"}}">

echo $nameday->today('sk'); # {"data":{"day":27,"month":8,"name_sk":"Silvia"}}
echo $nameday->today('Slovakia'); # {"data":{"day":27,"month":8,"name_sk":"Silvia"}}

echo $nameday->tomorrow('at'); # {"data":{"day":28,"month":8,"name_at":"Adelinde, Aline, Augustin"}}
echo $nameday->tomorrow('Austria'); # {"data":{"day":28,"month":8,"name_at":"Adelinde, Aline, Augustin"}}

echo $nameday->yesterday('de'); # {"data":{"day":26,"month":8,"name_de":"Margarita, Miriam, Patricia, Teresa"}}
echo $nameday->yesterday('Germany'); # {"data":{"day":26,"month":8,"name_de":"Margarita, Miriam, Patricia, Teresa"}}

Request name days for specific date

specificDay(int $day, int $month, string $countryCode)

echo $nameday->specificDay(21,10); # {"data":{"day":21,"month":10,"name_us":"Celina, Celine, Nobel" ... }}

Request name days for specific date and for specific country only

simply add optional third string parameter $countryCode, which must be one of the supported country codes

specificDay(29,3,'Spain'); # {"data":{"day":29,"month":3,"name_es":"Jonas, Segundo"}} echo $nameday->specificDay(2,12,'de'); # {"data":{"day":2,"month":12,"name_de":"Bibiana, Jan, Lucius"}} echo $nameday->specificDay(2,12,'Germany'); # {"data":{"day":2,"month":12,"name_de":"Bibiana, Jan, Lucius"}} echo $nameday->specificDay(12,1,'pl'); # {"data":{"day":22,"month":1,"name_pl":"Anastazy, Dobromysł, Dorian, Marta, Wincenty"}} echo $nameday->specificDay(12,1,'Poland'); # {"data":{"day":22,"month":1,"name_pl":"Anastazy, Dobromysł, Dorian, Marta, Wincenty"}} echo $nameday->specificDay(2,2,'hr'); # {"data":{"day":2,"month":2,"name_hr":"Marijan"}} echo $nameday->specificDay(2,2,'Croatia'); # {"data":{"day":2,"month":2,"name_hr":"Marijan"}}">

echo $nameday->specificDay(29,3,'es'); # {"data":{"day":29,"month":3,"name_es":"Jonas, Segundo"}}
echo $nameday->specificDay(29,3,'Spain'); # {"data":{"day":29,"month":3,"name_es":"Jonas, Segundo"}}

echo $nameday->specificDay(2,12,'de'); # {"data":{"day":2,"month":12,"name_de":"Bibiana, Jan, Lucius"}}
echo $nameday->specificDay(2,12,'Germany'); # {"data":{"day":2,"month":12,"name_de":"Bibiana, Jan, Lucius"}}

echo $nameday->specificDay(12,1,'pl'); # {"data":{"day":22,"month":1,"name_pl":"Anastazy, Dobromysł, Dorian, Marta, Wincenty"}}
echo $nameday->specificDay(12,1,'Poland'); # {"data":{"day":22,"month":1,"name_pl":"Anastazy, Dobromysł, Dorian, Marta, Wincenty"}}

echo $nameday->specificDay(2,2,'hr'); # {"data":{"day":2,"month":2,"name_hr":"Marijan"}}
echo $nameday->specificDay(2,2,'Croatia'); # {"data":{"day":2,"month":2,"name_hr":"Marijan"}}

Request name day in country calendar

Will return all days in given calendar which contains the name.

searchByName(string $day, string $countryCode)

Both parameters are required. Parameter $countryCode must be one of the supported country codes

searchByName('Jan','Czech Republic'); # {"calendar":"cz","results":[{"day":24,"month":5,"name":"Jana"},{"day":24,"month":6,"name":"Jan"} ... }}">

echo $nameday->searchByName('Jan','cz'); # {"calendar":"cz","results":[{"day":24,"month":5,"name":"Jana"},{"day":24,"month":6,"name":"Jan"} ... }}
echo $nameday->searchByName('Jan','Czech Republic'); # {"calendar":"cz","results":[{"day":24,"month":5,"name":"Jana"},{"day":24,"month":6,"name":"Jan"} ... }}

Specification of time zone

Time zone is set by local php.ini settings. Therefore $nameday->today() will return result according to that. If you need to specify different time zone you can do so by adding optional parameter $timeZone to the constructor. $timeZone must be PHP time zones string or integer offset to GMT.

$nameday = new Nameday('Pacific/Honolulu');
echo $nameday->today(); # will return today name days according to Pacific/Honolulu time zone

$nameday = new Nameday('+13:30');
echo $nameday->tomorrow(); # will return today name days according to given UTC offset

Certificate

Make sure you have proper certificates stored on your local machine as Name day API uses HTTPS only.

If you run into problems with server certificate try downloading the The Mozilla CA certificate store, save it on your system and configure php.ini

[curl]
; A default value for the CURLOPT_CAINFO option. This is required to be an
; absolute path.
curl.cainfo ="C:\...\cacert.pem"

You might also like...

The official Previewify.app PHP Client

Previewify for PHP This is the official Previewify client for PHP. Support us Like our work? You can support us by purchasing one of our products. Ins

6 Jan 19, 2022

OpenAI API Client is a component-oriented, extensible client library for the OpenAI API. It's designed to be faster and more memory efficient than traditional PHP libraries.

OpenAI API Client in PHP (community-maintained) This library is a component-oriented, extensible client library for the OpenAI API. It's designed to b

6 Jun 14, 2023

BeckhoffPLCSoapClient - SoapClient to communicate with BeckHoff PLC. Library made in PHP based on TcAdsWebService JavaScript Library.

3 May 18, 2022

Comments

Update guzzlehttp/guzzle to 7v

Cannot install via composer when using the 7v of the guzzlehttp/guzzle

Problem 1 - Root composer.json requires xnekv03/nameday-api ^2.0 -> satisfiable by xnekv03/nameday-api[v2.0.0]. - xnekv03/nameday-api v2.0.0 requires guzzlehttp/guzzle ^6.5 -> found guzzlehttp/guzzle[6.5.0, ..., 6.5.x-dev] but it conflicts with your root composer.json require (^7.0.1).

opened by jadamec 1
Inluding data problem

Hello, including data file file_get_contents('src/nameday/data/countryList.json') depends on working directory, better will be use something like file_get_contents(__DIR__ . '/data/countryList.json')

opened by leninzprahy 1
Folder name case problem

Hello, i found problem on linux system, in composer.json in autoload section is src/Nameday/ but the folder name is src/nameday/ (lowercase "n") and php can't found the class.

opened by leninzprahy 1