Class RestServeur

Package: Framework
Copyright: Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
License: v3 <http://www.gnu.org/licenses/gpl.txt>
License: v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
Author: Jean-Pascal MILCENT <jpm@tela-botanica.org>
Located at RestServeur.php

Methods summary
`public`	# `__construct( )` Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse l'url appelée pour trouver le service demandé. Analyse les données envoyées au serveur, enregistre la méthode HTTP utilisée pour appeler le serveur et parse l'url appelée pour trouver le service demandé.
`public static`	# `chargerClasse( string $classe )` La méthode __autoload() charge dynamiquement les classes trouvées dans le code. Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code. La méthode __autoload() charge dynamiquement les classes trouvées dans le code. Cette fonction est appelée par php5 quand il trouve une instanciation de classe dans le code. Parameters `$classe` `string` le nom de la classe appelée. Returns le fichier contenant la classe doit être inclu par la fonction.
`public`	# `executer( )` Execute la requête. Execute la requête.
`public static`	# `envoyerEnteteStatutHttp( integer $code )` Envoyer un entête HTTP (version 1.0) de statut. Il remplacera systématiquement tout entête HTTP de statut précédement envoyé. Envoyer un entête HTTP (version 1.0) de statut. Il remplacera systématiquement tout entête HTTP de statut précédement envoyé. Parameters `$code` `integer` $code entier indiquant le code du statut de l'entête HTTP à envoyer.
`public static`	# `gererErreurs( )` Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode. Si nous avec des erreurs d'un type différent d'E_USER_NOTICE (réservé au débogage), elle sont renvoyées sur la sortie standard (via echo). Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de config "debogage_mode" : - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code. - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo). - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme. - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher). Si des exceptions ou des erreurs sont soulevées par le serveur ou les services, elles sont gérées par cette méthode. Si nous avec des erreurs d'un type différent d'E_USER_NOTICE (réservé au débogage), elle sont renvoyées sur la sortie standard (via echo). Si seulement des erreurs de type E_USER_NOTICE, sont présentes, elle sont envoyées en fonction du contenu du paramètre de config "debogage_mode" : - Debug::MODE_ECHO : les messages sont affichés en utilisant echo au moment où ils sont déclenchés dans le code. - Debug::MODE_NOTICE : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type E_USER_NOTICE et sont renvoyés sur la sortie standard à la fin de l'execution du programme (via echo). - Debug::MODE_ENTETE_HTTP : les message sont stockés par le gestionnaire d'exception sous forme d'erreur de type E_USER_NOTICE et sont renvoyés dans un entête HTTP (X_REST_DEBOGAGE_MESSAGES) à la fin de l'execution du programme. - Autre valeur : les messages sont formatés puis retournés par la fonction de débogage (à vous de les afficher).
`public static`	# `ajouterMessage( string $message )` Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client. Le message doit être au format texte et en UTF-8. Permet d'ajouter un message d'erreur ou d'avertissement qui sera envoyé au client. Le message doit être au format texte et en UTF-8. Parameters `$message` `string` $message le message à envoyer.

Constants summary
`string`	`METHODE_GET`	`'consulter'`	# Nom de la méthode appelée dans un service pour éxécuter une requête de type GET. Nom de la méthode appelée dans un service pour éxécuter une requête de type GET.
`string`	`METHODE_POST`	`'modifier'`	# Nom de la méthode appelée dans un service pour éxécuter une requête de type POST. Nom de la méthode appelée dans un service pour éxécuter une requête de type POST.
`string`	`METHODE_DELETE`	`'supprimer'`	# Nom de la méthode appelée dans un service pour éxécuter une requête de type DELETE. Nom de la méthode appelée dans un service pour éxécuter une requête de type DELETE.
`string`	`METHODE_PUT`	`'ajouter'`	# Nom de la méthode appelée dans un service pour éxécuter une requête de type PUT. Nom de la méthode appelée dans un service pour éxécuter une requête de type PUT.
`string`	`HTTP_CODE_OK`	`'200'`	# Code HTTP 200 : OK Indiquant le succès de l'accès à un service web par la méthode GET. L'utiliser lors d'une requète de type GET (consulter) pour indiquer le succès de l'opération. Sera renvoyée par défaut par PHP. Code HTTP 200 : OK Indiquant le succès de l'accès à un service web par la méthode GET. L'utiliser lors d'une requète de type GET (consulter) pour indiquer le succès de l'opération. Sera renvoyée par défaut par PHP. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.1
`string`	`HTTP_CODE_CREATION_OK`	`'201'`	# Code HTTP 201 : Created Indiquant que l'accès à un service web est un succès et que la ressource a été créée ou modifié. L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer le succès de l'opération. Code HTTP 201 : Created Indiquant que l'accès à un service web est un succès et que la ressource a été créée ou modifié. L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer le succès de l'opération. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.2
`string`	`HTTP_CODE_ACCEPTE_OK`	`'202'`	# Code HTTP 202 : Accepted Indiquant que la requête a été acceptée mais que son traitement n'est pas encore terminé. L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer que les données seront traitées ultérieurement. Code HTTP 202 : Accepted Indiquant que la requête a été acceptée mais que son traitement n'est pas encore terminé. L'utiliser lors d'une requète de type PUT (ajouter) ou POST (modifier) pour indiquer que les données seront traitées ultérieurement. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.3
`string`	`HTTP_CODE_SUPPRESSION_OK`	`'204'`	# Code HTTP 204 : No Content Indique que l'accès à un service web est un succès et qu'il n'y a pas de contenu à renvoyer. L'utiliser lors d'une requète de type DELETE (supprimer) pour indiquer le succès de l'opération si aucun contenu (status) ne doit être renvoyé, sinon utiliser 200 OK. Code HTTP 204 : No Content Indique que l'accès à un service web est un succès et qu'il n'y a pas de contenu à renvoyer. L'utiliser lors d'une requète de type DELETE (supprimer) pour indiquer le succès de l'opération si aucun contenu (status) ne doit être renvoyé, sinon utiliser 200 OK. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.2.5
`string`	`HTTP_CODE_MAUVAISE_REQUETE`	`'400'`	# Code HTTP 400 : Bad Request Indique que les paramètres envoyés au service contiennent des erreurs. L'utiliser pour indiquer l'échec de l'accès au service. La réponse pourra contenir un message expliquant la source de l'erreur. Code HTTP 400 : Bad Request Indique que les paramètres envoyés au service contiennent des erreurs. L'utiliser pour indiquer l'échec de l'accès au service. La réponse pourra contenir un message expliquant la source de l'erreur. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1
`string`	`HTTP_CODE_ACCES_NON_AUTORISE`	`'401'`	# Code HTTP 401 : Unauthorized Indiquant que l'accès à un service web est refusé car l'authentification (obligatoire) a échoué pour accéder à la ressource. Code HTTP 401 : Unauthorized Indiquant que l'accès à un service web est refusé car l'authentification (obligatoire) a échoué pour accéder à la ressource. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2
`string`	`HTTP_CODE_ACCES_INTERDIT`	`'403'`	# Code HTTP 403 : Forbidden Indiquant que le service a compris la requête mais refuse de la réaliser. Code HTTP 403 : Forbidden Indiquant que le service a compris la requête mais refuse de la réaliser. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4
`string`	`HTTP_CODE_RESSOURCE_INTROUVABLE`	`'404'`	# Code HTTP 404 : Not Found Indiquant que la ressource indiquée par l'url est introuvable. Code HTTP 404 : Not Found Indiquant que la ressource indiquée par l'url est introuvable. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5
`string`	`HTTP_CODE_METHODE_NON_AUTORISE`	`'405'`	# Code HTTP 405 : Method Not Allowed Indique soit : - que le service web ne possède pas d'accès la ressource correspondant à la méthode HTTP employée. - que la méthode HTTP enployée n'est pas en accord avec la ressource indiquée par l'url. Code HTTP 405 : Method Not Allowed Indique soit : - que le service web ne possède pas d'accès la ressource correspondant à la méthode HTTP employée. - que la méthode HTTP enployée n'est pas en accord avec la ressource indiquée par l'url. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6
`string`	`HTTP_CODE_CONFLIT`	`'409'`	# Code HTTP 409 : Conflict Indique qu'un conflit est survenu vis à vis de la ressource. Par exemple, essayer de créer deux fois la même ressource ou bien tenter de modifier une ressource qui a été modifiée par ailleurs. Code HTTP 409 : Conflict Indique qu'un conflit est survenu vis à vis de la ressource. Par exemple, essayer de créer deux fois la même ressource ou bien tenter de modifier une ressource qui a été modifiée par ailleurs. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.10
`string`	`HTTP_CODE_CONTENU_REQUIS`	`'411'`	# Code HTTP 411 : Length Required Indique que des paramètres passés dans le contenu de la requête sont nécessaires au service. Code HTTP 411 : Length Required Indique que des paramètres passés dans le contenu de la requête sont nécessaires au service. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.12
`string`	`HTTP_CODE_ECHEC_CONDITION`	`'411'`	# Code HTTP 412 : Precondition Failed Indique que des entêtes envoyés au serveur sont erronnés. À utiliser quand un service web reçoit de mauvais entêtes, paramètres et/ou ressources. Code HTTP 412 : Precondition Failed Indique que des entêtes envoyés au serveur sont erronnés. À utiliser quand un service web reçoit de mauvais entêtes, paramètres et/ou ressources. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.13
`string`	`HTTP_CODE_CONTENU_NON_SUPPORTE`	`'415'`	# Code HTTP 415 : Unsupported Media Type Indique que le type de média envoyé au serveur n'est pas accepté par la ressource. À utiliser quand un service web reçoit un mauvais type de contenu. Code HTTP 415 : Unsupported Media Type Indique que le type de média envoyé au serveur n'est pas accepté par la ressource. À utiliser quand un service web reçoit un mauvais type de contenu. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16
`string`	`HTTP_CODE_ERREUR`	`'500'`	# Code HTTP 500 : Internal Server Error. L'utiliser quand le serveur ou un service soulève une erreur ou une exception. Code HTTP 500 : Internal Server Error. L'utiliser quand le serveur ou un service soulève une erreur ou une exception. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1
`string`	`HTTP_CODE_SERVICE_INDISPONIBLE`	`'503'`	# Code HTTP 503 : Service Unavailable L'utiliser quand le web service est momentanément indisponible. Code HTTP 503 : Service Unavailable L'utiliser quand le web service est momentanément indisponible. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4
`string`	`HTTP_NON_IMPLEMENTE`	`'501'`	# Code HTTP 501 : Not Implemented Indique que le web service ne supporte pas la fonctionnalité demandée. Code HTTP 501 : Not Implemented Indique que le web service ne supporte pas la fonctionnalité demandée. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.2
`string`	`MOTIF_API_VERSION`	`'/^[0-9]+(?:[.][0-9]+)*$/'`	# Motif de l'epression régulière vérfiant la version de l'API. Motif de l'epression régulière vérfiant la version de l'API.
`string`	`MOTIF_SERVICE_NOM`	`'/^[a-z0-9]+(?:[-][a-z0-9]+)*$/'`	# Motif de l'epression régulière vérfiant le nom du service. Motif de l'epression régulière vérfiant le nom du service.

Packages

Classes

Class RestServeur

Parameters

Returns

Parameters

Parameters

See

See

See

See

See

See

See

See

See

See

See

See

See

See

See

See