# Net_Gopher

## Introduction

The gopher protocol, as defined by » RFC 1436, is generally considered the ancestor of the modern HTTP protocol. However, gopher was also intended to provide references to non-gopher resources including telnet, wais, nntp, and even http. This extension adds gopher support to PHP's URL Wrappers, and provides a helper function gopher_parsedir() to make sense of gopher formatted directory listings.

## Requirements

## Installation

Prerequisite: PHP 4.3.0 or higher.

Information for installing this PECL extension may be found in the manual chapter titled Installation of PECL extensions. Additional information such as new releases, downloads, source files, maintainer information, and a CHANGELOG, can be located here: » http://pecl.php.net/package/net_gopher

## Runtime Configuration

This extension has no configuration directives defined in php.ini.

## Resource Types

This extension has no resource types defined.

## Predefined Constants

The constants below are defined by this extension, and will only be available when the extension has either been compiled into PHP or dynamically loaded at runtime.

Net_Gopher constants
Constant | Value | Description
--- | --- | ---
`GOPHER_DOCUMENT` | 0 | Standard text/plain document.
`GOPHER_DIRECTORY` | 1 | A resource containing a gopher formatted directory listing.
`GOPHER_BINHEX` | 4 | A BinHex encoded binary file.
`GOPHER_DOSBINARY` | 5 | A DOS formatted binary archive.
`GOPHER_UUENCODED` | 6 | A UUEncoded file.
`GOPHER_BINARY` | 9 | A generic binary file.
`GOPHER_INFO` | 255 | An Informational entry
`GOPHER_HTTP` | 254 | A reference to an HTTP resource.
`GOPHER_UNKNOWN` | -1 | An unrecognized entry.

## Examples

`<?php
readfile("gopher://gopher.example.com/somedocument");
?>`