PHP Mac Address Lookup: Look up a hardware vendor for a device Mac address

Recommend this page to a friend!

Download .zip

Info

Documentation

View files (36)

Download .zip

Reputation

Support forum

Blog

Links

Last Updated		Ratings				Unique User Downloads		Download Rankings
2021-07-06 (2 months ago)		Not yet rated by the users				Total: 42		All time: 10,166 This week: 197

Version		License		PHP version		Categories
`mac-vendor-lookup` 1.0		MIT/X Consortium ...		5		PHP 5, Web services, Hardware

Description Author

This package can look up a hardware vendor for a device Mac address.

It provides classes that can access the IEEE and OUI Web services to query the vendor and other technical details for a given Mac address.

The package provides the script files that perform queries about the Mac address from the command line console using the Laravel Artisan tool.

Angel Campos

Name:	Angel Campos `<contact>`
Classes:	5 packages by Angel Campos
Country:	Spain

Innovation award

Nominee: 2x

Details

mac-vendor-lookup

This PHP package allows you to get the information related to an <abbr title="Institute of Electrical and Electronics Engineers">IEEE</abbr> <abbr title="Organizationally Unique Identifier">OUI</abbr> assignment from a Laravel application.

The mac-vendor-lookup package downloads the OUI mapping information in <abbr title="Comma Separated Values">CSV</abbr> format from the IEEE website. Then it processes the CSV files and later stores the OUI assignment details in tables in the database.

Install

You can install the package via composer:

composer require acamposm/mac-vendor-lookup

Then publish the assets with this command:

php artisan mac:install

After publishing the assets (config & migrations), run artisan migrate:

php artisan migrate

Usage

Get MAC Address details

You can use "php artisan mac: details <mac-address>" in the console to get the vendor details as well as the OUI assignment details.

php artisan mac:details  <mac-address>

php artisan mac:details  00-15-5D-81-E0-B0

 Vendor details
 ------------- ---------------------------------------------
  OUI           00155D
  MAC Address   00-15-5D-81-E0-B0
  Vendor        Microsoft Corporation
  Address       One Microsoft Way Redmond WA US 98052-8300
  Is Private    false
 ------------- ---------------------------------------------

 Block details
 ------------------- -------------------
  Registry            MA-L
  Assignment bits     2^24
  Block Size          16,777,216
  Lower MAC Address   00:15:5D:00:00:00
  Upper MAC Address   00:15:5D:FF:FF:FF
  Last Update         Unknown
 ------------------- -------------------

 MAC Address details
 --------------------- ----------------------------------------
  MAC Address           00-15-5D-81-E0-B0
  Administration byte   UAA (Universally Administered Address)
  Group byte            Individual address
  Virtual Machine       true
  Is Multicast          false
  Is Unicast            false
  Is Valid              true
 --------------------- ----------------------------------------

Get vendor details

You can use "php artisan mac:vendor <mac-address>" in the console to get the vendor details associated with the OUI assignment.

php artisan mac:vendor <mac-address>

php artisan mac:vendor 00-15-5D-81-E0-B0

 ------------- -----------------------
  OUI           00155D
  MAC Address   00-15-5D-81-E0-B0
  Vendor        Microsoft Corporation
  Registry      MA-L
 ------------- -----------------------

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Thank you for considering contributing to the improvement of the package. Please see CONTRIBUTING for details.

Security Vulnerabilities

If you discover any security related issues, please send an e-mail to Angel Campos via angel.campos.m@outlook.com instead of using the issue tracker. All security vulnerabilities will be promptly addressed.

Credits

Angel Campos

License

The package Ping is open-source package and is licensed under The MIT License (MIT). Please see License File for more information.

Files

File	Role	Description
`.github` (4 files)
`config` (1 file)
`database` (1 directory)
`src` (3 files, 4 directories)
`storage` (1 directory)
`tests` (1 file, 1 directory)
`.phpunit.result.cache`	Data	Auxiliary data
`.styleci.yml`	Data	Auxiliary data
`composer.json`	Data	Auxiliary data
`composer.lock`	Data	Auxiliary data
`phpunit.xml`	Data	Auxiliary data
`README.md`	Doc.	Documentation

Files

.github

File	Role	Description
`CODE_OF_CONDUCT.md`	Data	Auxiliary data
`CONTRIBUTING.md`	Data	Auxiliary data
`dependabot.yml`	Data	Auxiliary data
`FUNDING.yml`	Data	Auxiliary data

Files

config

File	Role	Description
`ieee.php`	Aux.	Auxiliary script

Files

database

File	Role	Description
`migrations` (4 files)

Files

database

migrations

File	Role	Description
`2020_08_27_171403_...signments_table.php`	Class	Class source
`2020_08_27_173200_...oui_files_table.php`	Class	Class source
`2020_08_29_171728_...tatistics_table.php`	Class	Class source
`2020_08_29_171942_...i_updates_table.php`	Class	Class source

Files

src

File	Role	Description
`Console` (1 directory)
`Exceptions` (2 files)
`Models` (1 file)
`Providers` (1 file)
`MacAddress.php`	Class	Class source
`OuiFile.php`	Class	Class source
`OuiFileProcessor.php`	Class	Class source

Files

src

Console

File	Role	Description
`Commands` (7 files)

Files

src

Console

Commands

File	Role	Description
`DeleteOlderFilesCommand.php`	Class	Class source
`DownloadOuiFileFromIeeeWebPage.php`	Class	Class source
`GetMacAddressDetailsCommand.php`	Class	Class source
`GetVendorDetailsCommand.php`	Class	Class source
`InstallPackageCommand.php`	Class	Class source
`SeedTableFromOuiFile.php`	Class	Class source
`UpdateTableFromOuiFile.php`	Class	Class source

Files

src

Exceptions

File	Role	Description
`InvalidMacAddressFormatException.php`	Class	Class source
`OuiFileNotFoundException.php`	Class	Class source

Files

src

Models

File	Role	Description
`OuiAssignment.php`	Class	Class source

Files

src

Providers

File	Role	Description
`MacVendorLookupServiceProvider.php`	Class	Class source

Files

storage

File	Role	Description
`ieee` (5 files)

Files

storage

ieee

File	Role	Description
`oui_cid_20200830.csv`	Data	Auxiliary data
`oui_iab_20200830.csv`	Data	Auxiliary data
`oui_mal_20200830.csv`	Data	Auxiliary data
`oui_mam_20200830.csv`	Data	Auxiliary data
`oui_mas_20200830.csv`	Data	Auxiliary data

Files

tests

File	Role	Description
`Unit` (1 file)
`Pest.php`	Test	Test script

Files

tests

Unit

File	Role	Description
`ExampleTest.php`	Test	Test script

	mac-vendor-lookup-2021-07-06.zip 1372KB
	mac-vendor-lookup-2021-07-06.tar.gz 1359KB
	Install with Composer

Version Control

Unique User Downloads

Download Rankings

100%

Total:	42
This week:	0

All time:	10,166
This week:	197

Applications that use this package

No pages of applications that use this class were specified.

If you know an application of this package, send a message to the author to add a link here.

Advertise on this site

For more information send a message to info at phpclasses dot org.