You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Noccy 116233d81a
6 years ago
bin Bugfixes 6 years ago
examples Initial commit 6 years ago
src Bugfixes 6 years ago
.gitignore Initial commit 6 years ago
LICENSE Initial commit 6 years ago Various improvements 6 years ago
composer.json Added upnp-discover cli tool 6 years ago

UPnP Library for PHP

This is a UPnP client implementation in native PHP. It currently supports basic discovery and device enumeration.

Implemented Features


The HTTPU implementation is used by UPnP to send HTTP-like messages over UDP. It consist of an Endpoint class that creates a listening socket and classes and subclasses for Request and Response.

Currently only MSearchRequest and MSearchResponse is implemented. These classes are used to send M-SEARCH messages for discovery, and to parse the response.


The SSDP (Simple Service Discovery Protocol) implementation is used to find devices on the local network, and to enumerate child devices and defined services.

To discover devices, use the Discovery class, and call discover() with the search target as the first parameter. The SearchTarget class contains constants and methods to help with resolving and constructing search types.

Once the discovery has completed, you can iterate over the Discovery object to get the devices.

use NoccyLabs\UPnP\SSDP\Discovery;
use NoccyLabs\UPnP\SSDP\SearchTarget;

$discovery = new Discovery();

foreach ($discovery as $device) {

Experimental Features


The DCPs (Device Control Protocol) are used to interact with services. This can be f.ex. managing UPnP portmapping in your router or controlling a media player.

Search targets

To find everything, use ALL:


Find all root devices:


Find Internet Gateway Devices (routers). This equates to the type string urn:schemas-upnp-org:device:InternetGatewayDevice:<version>. Version 1 of the IGD specification has been deprecated, so you probably want to use version 2 when discovering devices:


You can also find devices based on UUIDs:

    -> "uuid:<uuid>"

Or devices based on the core UPnP schemas or device classes:

SearchTarget::URN_SCHEMA_DEVICE(<type>, <version>)
    -> "urn:schemas-upnp-org:device:<type>:<version>"
SearchTarget::URN_SCHEMA_SERVICE(<type>, <version>)
    -> "urn:schemas-upnp-org:service:<type>:<version>"

For example, to find the devices returned by URN_SCHEMA_DEVICE_IGD_2 you could use:


Additionally, you can search for vendor specific services or device classes:

SearchTarget::URN_DEVICE(<domain>, <type>, <version>)
    -> "urn:<domain>:device:<type>:<version>"
SearchTarget::URN_SERVICE(<domain>, <type>, <version>)
    -> "urn:<domain>:service:<type>:<version>"

For example, to find DIAL devices (for "casting" Netflix, YouTube etc. on TV) you could use:

SearchTarget::URN_DEVICE('dial-multiscreen-org', 'dialreceiver', 1)