willdurand / nmap
nmap is a PHP wrapper for Nmap, a free security scanner for network exploration.
Installs: 9 188
Dependents: 0
Suggesters: 0
Security: 0
Stars: 149
Watchers: 17
Forks: 56
Open Issues: 12
Requires
- php: >=5.3.0
- symfony/process: ~2.0|~3.0
Requires (Dev)
- phpunit/phpunit: ~3.7
README
nmap is a PHP wrapper for Nmap, a free security scanner for network exploration.
Usage
use Nmap\Nmap;
$hosts = Nmap::create()->scan([ 'williamdurand.fr' ]); $ports = $hosts->getOpenPorts();
You can specify the ports you want to scan:
$nmap = new Nmap(); $nmap->scan([ 'williamdurand.fr' ], [ 21, 22, 80 ]);
OS detection and Service Info are disabled by default, if you want to
enable them, use the enableOsDetection()
and/or enableServiceInfo()
methods:
$nmap ->enableOsDetection() ->scan([ 'williamdurand.fr' ]); $nmap ->enableServiceInfo() ->scan([ 'williamdurand.fr' ]); // Fluent interface! $nmap ->enableOsDetection() ->enableServiceInfo() ->scan([ 'williamdurand.fr' ]);
Turn the verbose mode by using the enableVerbose()
method:
$nmap ->enableVerbose() ->scan([ 'williamdurand.fr' ]);
For some reasons, you might want to disable port scan, that is why nmap
provides a disablePortScan()
method:
$nmap ->disablePortScan() ->scan([ 'williamdurand.fr' ]);
You can also disable the reverse DNS resolution with disableReverseDNS()
:
$nmap ->disableReverseDNS() ->scan([ 'williamdurand.fr' ]);
You can define the process timeout (default to 60 seconds) with setTimeout()
:
$nmap ->setTimeout(120) ->scan([ 'williamdurand.fr' ]);
Installation
The recommended way to install nmap is through Composer:
{ "require": { "willdurand/nmap": "@stable" } }
Or:
composer require willdurand/nmap
Protip: you should browse the
willdurand/nmap
page to choose a stable version to use, avoid the @stable
meta constraint.
License
nmap is released under the MIT License. See the bundled LICENSE file for details.