README

This repository contains PHP clients for Property Management Systems (PMS).

Supported Property Management Systems

Installation

composer require shelfwood/php-pms-clients

Debugging

A CLI tool is included to help debug the BookingManager API integration using a production key. It runs a sequence of non-destructive read calls to verify data is being returned and mapped correctly.

The sequence is:

Fetch all properties.
Fetch details for a specific property (either the first one found or one you specify).
Fetch calendar changes for the past week.
Fetch the calendar/availability for that property for the next 30 days.
Fetch a sample rate for a future stay at that property.

Usage:

Make the script executable:

chmod +x bin/debug-bookingmanager

Run the script with your API key:

./bin/debug-bookingmanager YOUR_API_KEY_HERE

Optionally, you can specify a property ID to test:

./bin/debug-bookingmanager YOUR_API_KEY_HERE 21663

The script will output the parsed XML data and the final mapped PHP object for each step, which is useful for verifying that all data fields are correctly set up in the PMS.

Testing

The test suite uses Pest and employs a comprehensive Golden Master testing approach. For each API endpoint, we validate the entire response object against a canonical "golden" version, ensuring 100% of fields are mapped correctly for both rich and edge-case responses.

The testing strategy includes:

Golden Master Validation: Each endpoint test validates every field in the response against expected data
Edge Case Coverage: Tests for minimal properties, inactive properties, empty responses, and comprehensive data
485+ Assertions: Comprehensive validation covering all response object properties
Curated Mock Data: Real-world XML responses extracted from production data for accurate testing

Test Structure:

tests/Endpoint/BookingManager/ — Endpoint-level integration tests for BookingManager API
tests/Helpers/ — Reusable assertion helpers and test data
mocks/bookingmanager/ — Comprehensive mock XML responses including edge cases

Running Tests:

# Run all tests
vendor/bin/pest

# Run tests for a specific endpoint
vendor/bin/pest --filter="PropertyEndpointTest"

# Discover property variance in mock data
./bin/discover-property-variance

Project Structure

src/ — Library source code, organized by PMS and concern.
tests/Endpoint/BookingManager/ — Endpoint-level integration tests for BookingManager API.
mocks/ — Mock XML responses for deterministic test scenarios.
bin/ — Executable CLI tools for debugging and other tasks.

shelfwood / php-pms-clients

Maintainers

Details