Manuel PHP
Précédent |  | Suivant

# gopher_parsedir

(PECL)

gopher_parsedir -- Transpose une entrÃ©e d'un dossier formatÃ© gopher dans un tableau associatif

## Description

array gopher_parsedir ( string dirent )

gopher_parsedir() transpose une entrÃ©e d'un dossier formatÃ© gopher dans un tableau associatif.

Gopher retourne des documents `text/plain` pour les documents demandÃ©s. Une requÃªte vers un dossier (comme /) retournera des sÃ©ries de lignes encodÃ©es oÃ¹ chaque ligne est une entrÃ©e du dossier ou une ligne d'informations.

## Liste de paramètres

`dirent`

  L'entrÃ©e du dossier.

## Valeurs de retour

Retourne un tableau associatif dont les composants sont :

- `type` - Une constante `GOPHER_XXX`.

- `title` - Le nom de la ressource.

- `path` - Le chemin vers la ressource.

- `host` - Le nom du domaine de l'hÃ´te qui possÃ¨de ce document (ou dossier).

- `port` - Le port de connexion sur l'hÃ´te `host`.

En cas d'Ã©chec, l'entrÃ©e additionnelle `data` du tableau retournÃ©e contiendra la ligne analysÃ©e.

## Exemples

Exemple 1. Affichage hypothÃ©tique depuis `gopher://gopher.example.com/`

    0All about my gopher site.	/allabout.txt	gopher.example.com	70
    9A picture of my cat.	/pics/cat.png	gopher.example.com	70
    1A collection of my writings.	/stories	gopher.example.com	70
    hThe HTTP version of this site.	URL:http://www.example.com	gopher.example.com	70
    1Mirror of this site in Spain.	/	gopher.ejemplo.co.es	70
    iWelcome to my gopher site.		error.host	1
    iPlease select one of the options above		error.host	1
    iSend complaints to /dev/null		error.host	1
    iLong live gopher!		error.host	1

Dans l'exemple prÃ©cÃ©dent, le dossier racine de gopher.example.com reconnaÃ®t un `DOCUMENT` identifiÃ© par `0` et se trouvant Ã l'adresse `gopher://gopher.example.com:70/allabout.txt`. Il reconnaÃ®t Ã©galement deux autres dossiers (qui ont leur propre liste de fichiers) Ã l'adresse `gopher://gopher.exmaple.com:70/stories` et Ã l'adresse `gopher://gopher.ejemplo.co.es:70/`. Il y a Ã©galement un fichier binaire, un lien vers une url HTTP et plusieurs lignes d'informations.

En passant chaque ligne du listing de ce dossier Ã la fonction gopher_parsedir(), un tableau associatif est formÃ© contenant une version analysÃ©e des donnÃ©es.

Exemple 2. Exemple avec gopher_parsedir()

`<?php $directory = file("gopher://gopher.example.com"); foreach($directory as $dirent) { print_r(gopher_parsedir($dirent)); } ?>`

L'exemple ci-dessus va afficher :

    Array (
      [type] => 0
      [title] => All about my gopher site.
      [path] => /allabout.txt
      [host] => gopher.example.com
      [port] => 70
    )
    Array (
      [type] => 9
      [title] => A picture of my cat.
      [path] => /pics/cat.png
      [host] => gopher.example.com
      [port] => 70
    )
    Array (
      [type] => 1
      [title] => A collection of my writings.
      [path] => /stories
      [host] => gopher.example.com
      [port] => 70
    )
    Array (
      [type] => 254
      [title] => The HTTP version of this site.
      [path] => URL:http://www.example.com
      [host] => gopher.example.com
      [port] => 70
    )
    Array (
      [type] => 1
      [title] => Mirror of this site in Spain.
      [path] => /
      [host] => gopher.ejemplo.co.es
      [port] => 70
    )
    Array (
      [type] => 255
      [title] => Welcome to my gopher site.
      [path] =>
      [host] => error.host
      [port] => 1
    )
    Array (
      [type] => 255
      [title] => Please select one of the options above.
      [path] =>
      [host] => error.host
      [port] => 1
    )
    Array (
      [type] => 255
      [title] => Send complaints to /dev/null
      [path] =>
      [host] => error.host
      [port] => 1
    )
    Array (
      [type] => 255
      [title] => Long live gopher!
      [path] =>
      [host] => error.host
      [port] => 1
    )

Précédent | Sommaire | Suivant
Net_Gopher | Niveau supérieur | Fonctions hash