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.
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
This extension has no configuration directives defined in php.ini.
This extension has no resource types defined.
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.
| 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. |
<?php
readfile("gopher://gopher.example.com/somedocument");
?>