Introduction

Laravel integration for OPC UA built on php-opcua/opcua-client and php-opcua/opcua-session-manager.

This package wraps the full OPC UA client API with Laravel conventions: a Facade, .env-based configuration, named connections, service container integration, and an Artisan command for the optional session manager daemon.

Requirements

Quick Start

composer require php-opcua/laravel-opcua

Add your endpoint to .env:

OPCUA_ENDPOINT=opc.tcp://192.168.1.100:4840

Use the Facade:

use PhpOpcua\LaravelOpcua\Facades\Opcua;

$client = Opcua::connect();
$value = $client->read('i=2259');
echo $value->getValue(); // 0 = Running
$client->disconnect();

Features

• Facade with full IDE autocompletion
• Named connections — define multiple OPC UA servers in config/opcua.php
• Ad-hoc connections — Opcua::connectTo() for runtime endpoints
• Transparent session management — daemon-based persistence, automatic fallback to direct connections
• String NodeIds — 'i=2259', 'ns=2;s=MyNode' everywhere
• Fluent Builder API — readMulti(), writeMulti(), createMonitoredItems(), translateBrowsePaths()
• PSR-3 Logging — Laravel log channel injected automatically
• PSR-16 Caching — Laravel cache store injected automatically, per-call useCache control
• PSR-14 Events — 47 lifecycle and operation events dispatched through Laravel's event system
• Trust Store — FileTrustStore with configurable TrustPolicy for certificate trust management
• Write Auto-Detection — write() infers the OPC UA type automatically when the type parameter is omitted
• Read Metadata Cache — cached node metadata avoids redundant server round-trips on repeated reads
• Type Discovery — discoverDataTypes() for server-defined structured types
• Subscription Transfer — transferSubscriptions() / republish() for session recovery
• Advanced Subscriptions — modifyMonitoredItems(), setTriggering() for fine-grained monitoring control
• Certificate Trust Management — trustCertificate() / untrustCertificate() for runtime certificate handling
• MockClient — test without a server
• All OPC UA operations — browse, read, write, call, subscriptions, events, history

Architecture

HTTP Request
    │
    ▼
Opcua::connect()
    │
    ├── socket exists? ──► YES ──► ManagedClient (Unix socket IPC to daemon)
    │                                     │
    ├── socket missing? ─► NO  ──► ClientBuilder::create()->...->connect($url)
                                          │
                                          ▼
                                  OPC UA Server

The OpcuaManager checks for the session manager daemon's Unix socket at connection time. If the socket exists, traffic routes through the daemon for session persistence. If not, a ClientBuilder constructs and connects a direct client. No code changes needed to switch between modes.

Documentation Index

Ecosystem