supercid/php-wake-on-lan

Wake on lan target enabled devices by sending magic packets to them from PHP

2.2.0 2024-08-14 11:11 UTC

This package is auto-updated.

Last update: 2024-11-14 11:36:17 UTC


README

Latest Version on Packagist

Wake on lan target enabled devices by sending magic packets to them from PHP.

Installation

Require the package using composer:

composer require supercid/php-wake-on-lan

Usage:

Normal PHP usage:

<?php

use \SuperCid\PHPWakeOnLan\PHPWakeOnLan;

$macAddress = '00:1B:2C:1C:DF:22';
$ipAddress = '192.168.0.1';

try {
    $wol = new PHPWakeOnLan();
    print_r($wol->wake($macAddress, $ipAddress));
} catch (Exception $e) {
    var_dump($e->getMessage());
}

Laravel facade usage:

<?php

use \SuperCid\PHPWakeOnLan\Facades\PHPWakeOnLan;

$macAddress = '00:1B:2C:1C:DF:22';
$ipAddress = '192.168.0.1';

try {
    print_r(PHPWakeOnLan::wake($macAddress, $ipAddress));
} catch (Exception $e) {
    var_dump($e->getMessage());
}

Example output:

Array
(
    [00:1B:2C:1C:DF:22] => Array
        (
            [result]     => OK
            [message]    => Magic packet sent to 00:1B:2C:1C:DF:22 through 255.255.255.255
            [bytes_sent] => 102
        )

    [01:1C:2C:1C:DF:13] => Array
        (
            [result]     => OK
            [message]    => Magic packet sent to 01:1C:2C:1C:DF:13 through 255.255.255.255
            [bytes_sent] => 102
        )
)

Laravel package config

You can publish laravel package configuration file running the command below:

php artisan vendor:publish --provider="SuperCid\PHPWakeOnLan\PHPWakeOnLanServiceProvider" --tag="config"

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

External links

Magic Packet Technology -

White paper describing the specification and implementation of Magic Packet™ technology from AMD, one of its two co-developers.

Credits

Original work from

Forked by

License

The MIT License (MIT). Please see license file for more information.