Go to file
R. Eric Wheeler f66809a46e Update dependencies 2023-06-14 10:23:39 -07:00
.github/workflows Update php.yml 2021-01-21 10:48:53 -08:00
bin Small fixes, added console info to readme 2018-11-29 14:47:06 -08:00
src/GenerateMac Full php 8 support 2021-01-20 15:50:48 -08:00
tests PHPUnit 9.x fix 2021-01-20 14:44:22 -08:00
.gitignore Small fixes, added console info to readme 2018-11-29 14:47:06 -08:00
.gitlab-ci.yml Add new file 2021-01-21 19:49:17 +00:00
.php_cs.dist Full php 8 support 2021-01-20 15:50:48 -08:00
LICENSE First commmit 2018-11-29 09:12:26 -08:00
README.md Update README.md 2021-01-21 19:52:05 +00:00
composer.json Update dependencies 2023-06-14 10:23:39 -07:00
header.txt First commmit 2018-11-29 09:12:26 -08:00
phpcs.xml First commmit 2018-11-29 09:12:26 -08:00
phpunit.xml.dist migrate phpunit config 2021-01-20 14:40:21 -08:00

README.md

sikofitt/generate-mac

Small library to generate unique private mac addresses

pipeline status coverage report

Install

Requires PHP v8.0, For versions compatible with PHP >= 7.3 use the 0.x branch.

composer

composer require sikofitt/generate-mac

Usage

use Sikofitt\GenerateMac\Mac;

$mac = new Mac(); // default separator is ':'
// or
$mac->setSeparator(Mac::SEPARATOR_COLON);
$address = $mac->getAddress(); // ab:cd:ef:01:23:45

$mac = new Mac(Mac::SEPARATOR_DASH);
// or
$mac->setSeparator(Mac::SEPARATOR_DASH);
$address = $mac->getAddress(); // ab-cd-ef-01-23-45

$mac = new Mac(Mac::SEPARATOR_NONE);
// or
$mac->setSeparator(Mac::SEPARATOR_NONE);
$address = $mac->getAddress(); // abcdef012345

If you don't care that it is unique you can remove the check for private mac prefixes.

$mac = new Mac(Mac::SEPARATOR_COLON, false);
// or
$mac->setUnique(false);

$address = $mac->getAddress();

// '52:54:00:ab:cd:ef',  QEMU virtual NIC prefix 52:54:00
// It's really not likely there will be a collision though.

Generate multiple mac addresses

$addresses = $mac->getAddresses(10);

var_dump($addresses);
/*
 *   array (
 *       0 => '8a:20:0b:b7:c4:62',
 *       1 => '56:7d:47:56:e8:bd',
 *       2 => '2a:ae:7b:44:6f:9d',
 *       3 => '6a:36:1a:7c:04:3a',
 *       4 => '3a:3d:93:f5:a6:12',
 *       5 => '8a:85:ce:11:2c:a2',
 *       6 => '06:54:6f:b1:11:48',
 *       7 => 'c6:fe:9d:86:38:dd',
 *       8 => 'ba:39:b3:a2:a1:fa',
 *       9 => '32:73:c0:b3:62:27',
 *   );
 */

// if you call this with 1 as the count it will still
// return an array [0 => '32:73:c0:b3:62:27']

Using the console component

The console script requires symfony/console

user@localhost:~/generate-mac$ bin/generate-mac --count (int) --output (json|plain|string) --separator (none|colon|dash)
  • --count Generate {count} mac addresses
  • --output Output in selected format
    • string: (default) Outputs the mac address(es) with formatting
    • plain: Outputs the mac address(es) with no formatting
    • json: Output the mac address(es) in json format
  • --separator Outputs with the selected operator
    • colon: ':' (default)
    • dash: '-'
    • none: ''

See bin/generate-mac --help

Test

user@localhost:~/generate-mac$ vendor/bin/phpunit

License

GPL-3.0