Introduction

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

This bundle wraps the full OPC UA client API with Symfony conventions: YAML-based semantic configuration, dependency injection, autowiring, and a console command for the optional session manager daemon.

Requirements

Quick Start

composer require php-opcua/symfony-opcua

Add the bundle to config/bundles.php (auto-registered with Symfony Flex):

return [
    // ...
    PhpOpcua\SymfonyOpcua\PhpOpcuaSymfonyOpcuaBundle::class => ['all' => true],
];

Create config/packages/php_opcua_symfony_opcua.yaml:

php_opcua_symfony_opcua:
    connections:
        default:
            endpoint: '%env(OPCUA_ENDPOINT)%'

Inject and use:

use PhpOpcua\SymfonyOpcua\OpcuaManager;

class PlcController
{
    public function index(OpcuaManager $opcua): Response
    {
        $client = $opcua->connect();
        $value = $client->read('i=2259');
        echo $value->getValue(); // 0 = Running
        $client->disconnect();
    }
}

Features

• Dependency injection with autowiring for OpcuaManager and OpcUaClientInterface
• Named connections — define multiple OPC UA servers in YAML config
• Ad-hoc connections — 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 — Symfony Monolog logger injected automatically
• PSR-16 Caching — Symfony cache pool wrapped as PSR-16 and injected automatically
• PSR-14 Events — 47 lifecycle and operation events dispatched through Symfony'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
    |
    v
$opcuaManager->connect()
    |
    +-- socket exists? --> YES --> ManagedClient (Unix socket IPC to daemon)
    |                                     |
    +-- socket missing? -> NO  --> ClientBuilder::create()->...->connect($url)
                                          |
                                          v
                                  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