Docs · Reference

Artisan commands

The artisan commands the package ships. Signatures, options, common invocations.

The package ships one artisan command. Earlier drafts of these docs listed opcua:ping, opcua:trust:*, opcua:discover, and opcua:cert:check — those are not registered by OpcuaServiceProvider. For trust-store inspection and endpoint discovery, use the companion opcua-cli package, or call the equivalent facade methods (Opcua::trustCertificate(), Opcua::untrustCertificate(), Opcua::getEndpoints()) from a custom command.

Command	Purpose
`opcua:session`	Run the OPC UA session daemon

opcua:session

Start the session-manager daemon. The command resolves the daemon's PSR-3 logger and PSR-16 cache from the Laravel container (using app('log')->channel(...) and app('cache')->store(...)) and runs the daemon in the foreground.

bash signature

php artisan opcua:session
    [--timeout=N]
    [--cleanup-interval=N]
    [--max-sessions=N]
    [--socket-mode=MODE]
    [--log-channel=NAME]
    [--cache-store=NAME]

Option	Description
`--timeout=N`	Session inactivity timeout in seconds (default: `config('opcua.session_manager.timeout')`)
`--cleanup-interval=N`	Cleanup-check interval in seconds
`--max-sessions=N`	Maximum concurrent sessions
`--socket-mode=MODE`	Unix-socket file permissions, in octal (e.g. `0600`)
`--log-channel=NAME`	Override the Laravel log channel used by the daemon
`--cache-store=NAME`	Override the Laravel cache store used by the daemon's client

All other daemon parameters — socket_path, auth_token, allowed_cert_dirs, auto_publish, the auto-connect connection list — come from config/opcua.php, not from CLI flags. There is no --socket-path, --auth-token, --allowed-cert-dirs, --auto-publish, or --no-auto-connect option.

When config('opcua.session_manager.auto_publish') is true and any connection has auto_connect => true plus a subscriptions array, the command calls Daemon::autoConnect(...) after the daemon is created — see Session manager · Auto-publish.

Detailed walkthrough: Starting the daemon.

Common invocations

Goal	Command
Start daemon in dev	`php artisan opcua:session`
Start daemon with a specific log channel	`php artisan opcua:session --log-channel=opcua`
Start daemon with a stricter session timeout	`php artisan opcua:session --timeout=120`

For health checks, write a small command in your application that calls Opcua::isSessionManagerRunning() (a socket-file existence check on Unix) plus an Opcua::connection()->read(...) round-trip against a known node.

Custom commands

The package leaves room for app-specific commands. Common ones:

Command (app-defined)	Purpose
`plc:discover`	Walk address space, populate `plc_tags`
`plc:sample`	One-shot read across all configured tags
`opcua:resubscribe`	Re-create subscriptions after daemon restart
`opcua:metrics`	Push metrics to Prometheus / Datadog

See Recipes for examples.

Where to read next

Exceptions — the exception hierarchy this command can throw.
Trust store — how to seed trusted server certificates programmatically.

Last updated · 2026-05-25

Edit on GitHub Report issue

← Previous

OpcuaManager API

Exceptions