PHPackages                             simondavies/veezi-api-wrapper - 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. [API Development](/categories/api)
4. /
5. simondavies/veezi-api-wrapper

ActiveLibrary[API Development](/categories/api)

simondavies/veezi-api-wrapper
=============================

A simple PHP website wrapper for the Veezi API.

0.1(10y ago)3423MITPHPPHP &gt;=5.4.0CI failing

Since Nov 17Pushed 6y ago7 watchersCompare

[ Source](https://github.com/simondavies/Veezi-API-Wrapper)[ Packagist](https://packagist.org/packages/simondavies/veezi-api-wrapper)[ RSS](/packages/simondavies-veezi-api-wrapper/feed)WikiDiscussions master Synced today

READMEChangelog (3)Dependencies (2)Versions (3)Used By (0)

Veezi-API-Wrapper
=================

[](#veezi-api-wrapper)

A basic PHP wrapper for the [Veezi API](http://api.us.veezi.com/Help).

**THIS IS STILL IN DEVELOPEMENT AND CAN CHANGE**

While being asked to look into the Veezi API, to enable a website to display its relevant film data onto the site, so not to duplicate work etc. I would need to do a bit of work to manipulate the current data returned, to be used on a website, so not being able to find any current PHP code for use with the Veezi API, thought be nice to build this and thne make it available to Veezi as well as others.

Official Documentation
----------------------

[](#official-documentation)

Offical documentation on the Veezi API can be found [Veezi API](http://api.us.veezi.com/Help)

- [Requirements](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#requiremnents)
- [Installation](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#installation)
- [Examples](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#code-examples)
- [To Do's](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#to-do)
- [License](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#license)

Code Examples
-------------

[](#code-examples)

Included within the repo is an examples folder, here you can find a few working examples of the various options.

- [Film Listing](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#film-listings)
- [Selected Film](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#selected-film)
- [FIlm Roles/People](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#film-roles)
- [Film Dates/Times &amp; Ticket Links](https://github.com/simondavies/Veezi-API-Wrapper/tree/develop#film-datestimes--ticket-links)

### Film Listings

[](#film-listings)

Get and display a list of films [![Veezi Film Dates/Times listings](/Examples/screenshots/Veezi-screenshot-FilmListings.png)](/Examples/screenshots/Veezi-screenshot-FilmListings.png)

```
//-- get the autoload page
require_once __DIR__ . '../../vendor/autoload.php';

//-- load in a some settings/configuration file.
require_once __DIR__ . '/config.php';

use VeeziAPI\VeeziAPIWrapper as VeeziAPI;
$Veezi = new VeeziAPI(VEEZI_API_TOKEN);

//--get a list of all films
$films = $Veezi->films();
//--loop throught the result and list by film title
foreach ($films as $film) {
    echo '' . $film->getTitle() . '';
}
```

### Selected Film

[](#selected-film)

```
//-- get the autoload page
require_once __DIR__ . '../../vendor/autoload.php';

//-- load in a some settings/configuration file.
require_once __DIR__ . '/config.php';

use VeeziAPI\VeeziAPIWrapper as VeeziAPI;
$Veezi = new VeeziAPI(VEEZI_API_TOKEN);

//--get a selected film
$film = $Veezi->selectedFilm($film_id);

//-- film title
$film_title = $film->getTitle();

//-- film synopsis
$film_synopsis = $film->getSynopsis();

//--film people Actor, Director, Producer
$film_people = $film->getPeople();
```

There are also other options available to a film instance, some more below.

- `$film->getGenre()`
- `$film->getFormat()`
- `$film->getLanguage()`
- `$film->getDatesAndTimes()`
- `$film->getRoles()`

There are also some that are returned as Arrays and other objects, take the `$film->getStartDate()`, what is returned is a [Carbon](https://github.com/briannesbitt/Carbon) instance, so it can be converted using any of the methods available through Carbon,

```
//-- set date as a readable date
$film->getStartDate()->format('l jS \\of F Y');
```

### Selected Film Poster

[](#selected-film-poster)

Currently it is **NOT** possible to gain access to the actual poster. As the posters are currently stored within the protected area of their severs, and in order gain access via a URL you will need to be signed in to the Veezi system.

So adding the url to the posters will fail for now. Veezi are looking into switchign this, so that they can also be referenced. in the mean time, in order to display posters, you will need to work on your own version/method.

If you need any ideas or solutions please feel free to contact me, on how i get around this.

### Film Roles

[](#film-roles)

Sort people and prepare a list of roles. (Actor/Director/Producer)

```
//-- return a list of roles and the people for each role
$roles = $film->getRoles();

        Actors

        Directors

        Producers

```

The output would be somethig like:

ActorsDirectorsProducersActor NameDirectors NameProducers Name### Film Dates/Times &amp; Ticket Links

[](#film-datestimes--ticket-links)

List the selected films Dates and times, with booking links on the times.

You can also get a list of dates and times for the selected film to display as clickable links to book tickets.

[![Veezi Film Dates/Times listings](/Examples/screenshots/Veezi-screenshot-DateAndTimes.png)](/Examples/screenshots/Veezi-screenshot-DateAndTimes.png)

```
//-- Get the films dates and times
$film_start_dates = $film->getDatesAndTimes();

//-- Out put the Dates and times
foreach ($film_start_dates as $date => $times) {
    echo '' . $date . '';
    echo '';
    foreach ($times as $time) {
        echo '' . $time['time'] . '';
    }
    echo '';
}
```

Requiremnents
-------------

[](#requiremnents)

- PHP &gt;= 5.4.0
- [Veezi](http://www.veezi.com/) Active Account
- Veezi API Token
- [guzzlehttp/guzzle](https://github.com/guzzle/guzzle)
- [nesbot/Carbon](https://github.com/briannesbitt/Carbon)

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

[](#installation)

The recommended way to install this repo is through [Composer](http://getcomposer.org/)

#### Install Through Composer

[](#install-through-composer)

If your using thsi as the initial project then you can install via:

```
composer create-project simondavies/veezi-api-wrapper

```

Else to include within in a current project run

```
composer.phar require simondavies/veezi-api-wrapper

```

#### Install Via Github/Without Composer

[](#install-via-githubwithout-composer)

**Via SSH**

```
git clone git@github.com:simondavies/Veezi-API-Wrapper.git target-directory

```

**Via HTTPS**

```
git clone https://github.com/simondavies/Veezi-API-Wrapper.git target-directory

```

#### Set Up

[](#set-up)

Once the project has been downloaded we need to continue the initial set up.

```
cd target-directory
composer update

```

Add a config file.

```
cd App
cp config.example.php config.php

```

Update the following details with your Veezi API and Site Tokens.

```
define('VEEZI_API_TOKEN', '?????????');
define('VEEZI_SITE_TOKEN', '??????????');

```

Once thats been done, you can check that all is OK by visiting the Examples folder within a Browser.

***Please view the other required repos' install guidelines, if not installing from composer.***

To Do
-----

[](#to-do)

As this is currently on going I have a list of to do's below:

- Build the Film Classes
- Build the Cinema classe(s)
- Build the Screen classe(s)
- Add examples
- Create booking links for films
- Create film dates for each film
- More in-depth read me file or wiki

### License

[](#license)

The Veezi-API-Wrapper is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT)

###  Health Score

25

—

LowBetter than 35% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity49

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

Unknown

Total

1

Last Release

3881d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/23d45c0c797dea2a8238ce1c04d3ee509698c439ab3da3166ec1ae0cfb0e913e?d=identicon)[simondavies](/maintainers/simondavies)

---

Top Contributors

[![simondavies](https://avatars.githubusercontent.com/u/689184?v=4)](https://github.com/simondavies "simondavies (77 commits)")

---

Tags

apiveezifilm listing

### Embed Badge

![Health badge](/badges/simondavies-veezi-api-wrapper/health.svg)

```
[![Health](https://phpackages.com/badges/simondavies-veezi-api-wrapper/health.svg)](https://phpackages.com/packages/simondavies-veezi-api-wrapper)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.8k543.8M20.1k](/packages/laravel-framework)[statamic/cms

The Statamic CMS Core Package

4.8k3.6M985](/packages/statamic-cms)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3741.3M46](/packages/tencentcloud-tencentcloud-sdk-php)[smodav/mpesa

M-Pesa API implementation

16467.9k1](/packages/smodav-mpesa)[eslazarev/wildberries-sdk

Wildberries OpenAPI clients (generated).

273.0k](/packages/eslazarev-wildberries-sdk)[files.com/files-php-sdk

Files.com PHP SDK

2481.1k](/packages/filescom-files-php-sdk)

PHPackages © 2026

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