examinecom/php-sip2-plus

PHP class library to facilitate communication with Integrated Library System (ILS) servers via 3M's SIP2.

v1.0.0 2025-11-05 09:22 UTC

Requires

• php: ^8.2.0

Requires (Dev)

• laravel/pint: ^1.24.0
• peckphp/peck: ^0.1.3
• pestphp/pest: ^4.1.0
• pestphp/pest-plugin-type-coverage: ^4.0.2
• phpstan/phpstan: ^2.1.26
• rector/rector: ^2.1.7
• symfony/var-dumper: ^7.3.3

GPL-3.0

• Paul Iway

README

📚 PHP SIP2 Plus

Overview

PHP SIP2 Plus is a maintained and improved implementation of the SIP2 protocol used by Integrated Library Systems (ILS) for communication with self-check machines, circulation systems, and other library services.

This library builds on the original php-sip2 project by John Wohlers, extending it with:

• ✅ TLS support — works with both raw sockets and TLS/SSL
• ✅ Extensible transport layer — easily integrate new connection types
• ✅ Clean, object-oriented API for sending and parsing SIP2 messages
• ✅ Composer support and PSR-compliant structure
• ✅ Actively maintained by Examine.com

Why this library?

Many existing SIP2 PHP clients are outdated, limited to plain socket connections, or hard to extend.
This version offers a modern architecture that makes it easy to adapt to different network environments, integrate with secure servers, and extend protocol behavior as needed.

Installation

You can install the package via Composer:

composer require examinecom/php-sip2-plus

Example

$sip2 = new Sip2Wrapper(
    array(
        'hostname' => 'sip-demo.evergreen-ils.org',
        'port' => 6443,
        'location' => 'CONS',
        'institutionId' => 'sample',
        'useTls' => true,
    )
);
$sip2->connect();
$sip2->login('admin', 'demo123');
$sip2->startPatronSession('88882000000028', 'demo123');

Credits

• Original implementation by John Wohlers
• Sip2Wrapper by Nathan Johnson