PEAR Manual
Prev |  | Next

# Net_Portscan::checkPort()

Net_Portscan::checkPort() -- check for available service

## Synopsis

    require_once 'Net/Portscan.php';

``boolean Net_Portscan::checkPort` (string $host, integer $port [, integer $timeout = 30])`

## Description

This function checks if there is a service available at the specified port on the specified machine.

## Parameter

- `string $host` - address of the host to check

- `string $port` - port to check

- `string $timeout` - time in seconds to wait for response from host

  > Important: If you run into timeout problems despite setting this parameter to a reasonably high value, you need to make sure that the configuration directive `default_socket_timeout` in the `php.ini` configuration file does not force the maximum timeout down to a lower value.

## Return value

`boolean` - Returns `TRUE` on success, `FALSE` on failure.

## Note

This function can be called statically.

## Example

Example 48-1. Using checkPort
    require_once "Net_Portscan/Portscan.php";

    if (Net_Portscan::checkPort("localhost", 80) == NET_PORTSCAN_SERVICE_FOUND) {
        echo "There is a service on localhost on port 80 (" . Net_Portscan::getService(80) . ").\n";
    }

Prev | Home | Next
Net_Portscan | Up | Net_Portscan::checkPortRange()