supercid / php-wake-on-lan
Wake on lan target enabled devices by sending magic packets to them from PHP
Requires
- php: ^8.0
- ext-ctype: *
- ext-sockets: *
Requires (Dev)
- orchestra/testbench: ^3.8|^7.0
- phpunit/phpunit: ^7.0|^8.0
This package is auto-updated.
Last update: 2024-11-14 11:36:17 UTC
README
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
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.