PHPackages                             degordian/roomfinder - 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. degordian/roomfinder

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

degordian/roomfinder
====================

Finding available meeting rooms, and reserving them

v1.0.8(8y ago)431[1 issues](https://github.com/degordian/roomfinder/issues)[1 PRs](https://github.com/degordian/roomfinder/pulls)MITPHPPHP >=7.0.0

Since Nov 9Pushed 5y ago5 watchersCompare

[ Source](https://github.com/degordian/roomfinder)[ Packagist](https://packagist.org/packages/degordian/roomfinder)[ RSS](/packages/degordian-roomfinder/feed)WikiDiscussions master Synced today

READMEChangelog (9)Dependencies (1)Versions (12)Used By (0)

Room resource managment, finding and reserving available meeting rooms
======================================================================

[](#room-resource-managment-finding-and-reserving-available-meeting-rooms)

A php wrapper around something that can handle rooms and their availability(google calendar for instance)
How to install (Composer)
=========================

[](#how-to-install-composer)

```
composer require degordian/roomfinder

```

or add to your project's composer.json

```
"require": {
    "degordian/roomfinder": "*"
}

```

How to use
==========

[](#how-to-use)

First you have to atuthenticate yourself for using google calendar for instance
A google calendar example is in examples/auth
You can add new adapters for room resourcing, currently only Google Calendar is supported

Create a google app here:

Export the client\_secret.json file
Save it to disk, and paste the path to the file into `$clientSecretPath`
For `$credentialsPath`, use the location on your disk where you want the auth.php script to create your auth file
Through the command line, call

```
   php examples/auth.php

```

This will serve you a google link to authenticate yourself and create a credential file you can then use in your project

Using that file you can now you can initialize an adapter for those rooms

```
$roomResourceAdapter = new RoomResourceGoogleCalendar();
$roomResourceAdapter->setConfig([
    'applicationName' => 'FindARoom',
    'credentialsPath' => '/Users/tonymrakovcic/credentials/calendar-findaroom.json',
    'clientSecretPath' => '/Users/tonymrakovcic/credentials/client_secret.json',
    'scopes' => [\Google_Service_Calendar::CALENDAR],
    'accessType' => 'offline',
])->init();
```

Initialize a room handler, and register the adapter ```
$roomHandler = new RoomHandler();
$roomHandler->setRoomResourceAdapter($roomResourceAdapter);
```

Create a room from some data ```
$rooms  = [
    [
        'name' => 'Meeting room one',
        'id' => 'YOUR_CALENDAR_ID_1@group.calendar.google.com',
        'size' => Room::SIZE_BIG,
        'resourceClass' => RoomResourceGoogleCalendar::class,
    ],
    [
        'name' => 'Meeting room two',
        'id' => 'YOUR_CALENDAR_ID_2@group.calendar.google.com',
        'size' => Room::SIZE_MEDIUM,
        'resourceClass' => RoomResourceGoogleCalendar::class,
    ]
];
```

Add the rooms to the room handler ```
$roomHandler->addRooms($rooms);
```

Find the availability of all rooms ```
$roomsAvailable = $roomHandler->getAllRoomsAvailability();
```

Find an availble room, that wont be occupied in the next x minutes ```
$availableRoomNow = $roomHandler->findAvailableRoom(RoomHandler::HOUR);
```

Find an available room, that wont be occupied in the next x minutes, and filter by size ```
$roomsAvailable = $roomHandler->findAvailableBigRoom();
```

Reserve a room in the calendar

```
$reservation = $roomHandler->reserveRoom($roomsAvailable[0]);
```

Contribute
==========

[](#contribute)

Contributions and comments are more than welcome :)

Questions, problems?
====================

[](#questions-problems)

We will do our best to answer all issues

License
=======

[](#license)

[MIT License](LICENSE)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance15

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community5

Small or concentrated contributor base

Maturity65

Established project with proven stability

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

7

Last Release

3087d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/82d5eb84ce1c2561ee26fba2f6954d6f8686cc5fec19809222e8b35d9ae85774?d=identicon)[Degordian](/maintainers/Degordian)

---

Tags

bornfightcalendarreservationsroomsMeetings

### Embed Badge

![Health badge](/badges/degordian-roomfinder/health.svg)

```
[![Health](https://phpackages.com/badges/degordian-roomfinder/health.svg)](https://phpackages.com/packages/degordian-roomfinder)
```

###  Alternatives

[spatie/laravel-google-calendar

Manage events on a Google Calendar

1.4k1.5M21](/packages/spatie-laravel-google-calendar)[spatie/icalendar-generator

Build calendars in the iCalendar format

6787.4M9](/packages/spatie-icalendar-generator)[moe/full-calendar

A lightweight calendar module for Silverstripe. Implements the popular javascript http://fullcalendar.io/ library.

121.5k](/packages/moe-full-calendar)

PHPackages © 2026

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