LII. Net_Gopher

Introduction

Le protocole gopher, comme définie par la RFC 1436, est généralement considéré comme l'ancêtre du protocole moderne HTTP. Cependant, gopher a été également conçu pour fournir des références à des ressources non-gopher comme telnet, wais, nntp et, toujours, http. Cette extension ajoute le support gopher aux gestionnaires d'URL, et fournit une fonction utile gopher_parsedir() pour lister les dossiers formattés gopher.

Installation

Net_Gopher est installé en utilisant le processus d'installation de paquet PECL.

  • Prérequis : PHP 4.3.0.

  • $ pear install Net_Gopher

  • Copiez le fichier résultant gopher.so dans un dossier approprié et ajoutez extension=gopher.so à votre php.ini ou chargez-le dynamiquement dans votre script PHP en utilisant dl("gopher.so");

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Cette extension ne définit aucune ressource.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Tableau 1. Constantes Net_Gopher

ConstanteValeurDescription
GOPHER_DOCUMENT0Document standart text/plain.
GOPHER_DIRECTORY1Une ressource contenant une liste de dossiers formatée gopher.
GOPHER_BINHEX4Un fichier binaire encodé BinHex.
GOPHER_DOSBINARY5Une archive binaire formaté DOS.
GOPHER_UUENCODED6Un fichier UUEncoded.
GOPHER_BINARY9Un fichier binaire générique.
GOPHER_INFO255Une entrée informative.
GOPHER_HTTP254Une référence vers une ressource HTTP.
GOPHER_UNKNOWN-1 Une entrée non reconnue.

Exemples

<?php

readfile
("gopher://gopher.example.com/quelques_documents");
?>

Table des matières
gopher_parsedir -- Transpose une entrée d'un dossier formaté gopher dans un tableau associatif