PHPackages                             joaofigueira/portugal-holidays - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. joaofigueira/portugal-holidays

ActiveLibrary[Utility & Helpers](/categories/utility)

joaofigueira/portugal-holidays
==============================

List of holidays of a given year or a series of years.

v1.1.0(5y ago)1103MITPHP

Since Apr 16Pushed 5y ago1 watchersCompare

[ Source](https://github.com/joaopfigueira/portugal-holidays)[ Packagist](https://packagist.org/packages/joaofigueira/portugal-holidays)[ RSS](/packages/joaofigueira-portugal-holidays/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (3)Used By (0)

Portugal Holidays
=================

[](#portugal-holidays)

Lists holidays of Portugal for a given year or a series of years.

Installation
------------

[](#installation)

Install using [Composer](https://getcomposer.org/)

```
$ composer require joaofigueira/portugal-holidays

```

Usage
-----

[](#usage)

### List using internal reference files:

[](#list-using-internal-reference-files)

```
use Holidays\Holidays;
use Holidays\Clients\Json;
use Holidays\Handlers\File;

$client  = new Json;
$handler = new File;

$holidays = new Holidays($client, $handler);

$result = $holidays->get($years)->asArray();
```

### List using external webservice call:

[](#list-using-external-webservice-call)

```
use Holidays\Holidays;
use Holidays\Clients\Http;
use Holidays\Handlers\Xml;

$client  = new Http;
$handler = new Xml;

$holidays = new Holidays($client, $handler);

$result = $holidays->get($years)->asArray();
```

Contribute
----------

[](#contribute)

You can clone and contribute to this project.

### Setup local environment:

[](#setup-local-environment)

- make sure you have docker installed in your machine.
- clone the project.
- run setup: `$ ./setup.sh`. You may have to `$ chmod +x setup.sh` to be able to run the script. This will create the docker container and run composer install for you.
- run tests: `$ ./run-tests.sh`.

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

2

Last Release

1849d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/07f0deaa03f529a3369db0b2c75d63c6db0c8d6bc7f6e07be7a67d248c7437ef?d=identicon)[joaopfigueira](/maintainers/joaopfigueira)

---

Top Contributors

[![joaopfigueira](https://avatars.githubusercontent.com/u/8125102?v=4)](https://github.com/joaopfigueira "joaopfigueira (7 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/joaofigueira-portugal-holidays/health.svg)

```
[![Health](https://phpackages.com/badges/joaofigueira-portugal-holidays/health.svg)](https://phpackages.com/packages/joaofigueira-portugal-holidays)
```

###  Alternatives

[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

4.8k4.3k](/packages/shlinkio-shlink)[ralphjsmit/laravel-helpers

A package containing handy helpers for your Laravel-application.

13704.6k2](/packages/ralphjsmit-laravel-helpers)[dhlparcel/magento2-plugin

DHL Parcel plugin for Magento 2

11180.5k2](/packages/dhlparcel-magento2-plugin)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)