
Prev		Next

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.

Requirements

Installation

Net_Gopher is installed through the usual PECL package installation process.

Prerequisite: PHP 4.3.0.
$ pear install Net_Gopher
Copy the resulting gopher.so to an appropriate location and add extension=gopher.so to your php.ini file or load it dynamically in your PHP script using dl("gopher.so");

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

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


&#60;?php
readfile("gopher://gopher.example.com/somedocument");
?&#62;

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

Prev	Home	Next
gnupg_verify	Up	gopher_parsedir