LII. 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.

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.

Table 1. Net_Gopher constants

ConstantValueDescription
GOPHER_DOCUMENT0Standard text/plain document.
GOPHER_DIRECTORY1A resource containing a gopher formatted directory listing.
GOPHER_BINHEX4A BinHex encoded binary file.
GOPHER_DOSBINARY5A DOS formatted binary archive.
GOPHER_UUENCODED6A UUEncoded file.
GOPHER_BINARY9A generic binary file.
GOPHER_INFO255An Informational entry
GOPHER_HTTP254A reference to an HTTP resource.
GOPHER_UNKNOWN-1 An unrecognized entry.

Examples

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

Table of Contents
gopher_parsedir -- Translate a gopher formatted directory entry into an associative array.