278 lines
7.3 KiB
PHP
Executable File
278 lines
7.3 KiB
PHP
Executable File
<?php
|
|
|
|
namespace manager;
|
|
|
|
// FORMAT:
|
|
//
|
|
// path: "nomModule/nomMethode"
|
|
// data1: {donnee1}
|
|
// data2: {donnee2}
|
|
// ...
|
|
//
|
|
//
|
|
//
|
|
//
|
|
|
|
class ModuleRequest{
|
|
|
|
// Constantes
|
|
public static $config_path = 'f/json/modules/conf';
|
|
|
|
|
|
// Attributs prives utiles (initialisation)
|
|
private $path;
|
|
private $data;
|
|
private $modules;
|
|
|
|
// Contiendra la reponse a la requete
|
|
public $answer;
|
|
|
|
// Contiendra l'etat de la requete
|
|
public $error;
|
|
|
|
|
|
|
|
|
|
|
|
/* CONSTRUCTEUR D'UNE REQUETE DE MODULE
|
|
*
|
|
* @path<String> Chemin de delegation ("module/methode")
|
|
* @data<Array> Tableau contenant les parametres utiles au traitement
|
|
*
|
|
* @return status<Boolean> Retourne si oui ou non tout s'est bien passe
|
|
*
|
|
*/
|
|
public function __construct($path=null, $data=null){
|
|
// Si pas parametre manquant, on quitte
|
|
if( $path == null ){
|
|
$this->error = ManagerError::MissingPath;
|
|
return false;
|
|
}
|
|
|
|
/* [0] On met a jour la configuration
|
|
=========================================================*/
|
|
// Modules specifies
|
|
$this->modules = json_decode( ResourceDispatcher::getResource(self::$config_path), true );
|
|
|
|
// Gestion de l'erreur de parsage
|
|
if( $this->modules == null ){
|
|
$this->error = ManagerError::ParsingFailed;
|
|
return false;
|
|
}
|
|
|
|
|
|
|
|
/* [1] Verification des types des parametres
|
|
=========================================================*/
|
|
// Type de @path
|
|
if( !is_string($path) ){ // Si le type est incorrect
|
|
$this->error = ManagerError::WrongPathModule;
|
|
return false; // On retourne FALSE, si erreur
|
|
}
|
|
|
|
// Type de @data (optionnel)
|
|
$data = (is_array($data)) ? $data : array();
|
|
|
|
|
|
/* [2] Verification du chemin (existence module+methode)
|
|
=========================================================*/
|
|
if( !$this->checkPath($path) ) // Verification de la coherence du chemin + attribution
|
|
return false;
|
|
// Gestion d'erreur interne
|
|
|
|
|
|
/* [3] Construction de l'objet
|
|
=========================================================*/
|
|
$this->data = $data;
|
|
$this->error = ManagerError::Success;
|
|
|
|
return true; // On retourne que tout s'est bien passe
|
|
|
|
}
|
|
|
|
|
|
|
|
/* EXECUTE LE TRAITEMENT ASSOCIE ET REMPLIE LA REPONSE
|
|
*
|
|
* @return answer<ModuleAnswer> Retourne une reponse de type <ModuleAnswer> si tout s'est bien passe
|
|
*
|
|
*/
|
|
public function dispatch(){
|
|
/* [1] On verifie qu'aucune erreur n'a ete signalee
|
|
=========================================================*/
|
|
if( $this->error != ManagerError::Success ) // si il y a une erreur
|
|
return new ModuleAnswer($this->error); // on la passe a la reponse
|
|
|
|
|
|
/* [2] On verifie que la methode est amorcable
|
|
=========================================================*/
|
|
if( !is_callable($this->getFunctionCaller()) ){
|
|
$this->error = ManagerError::UncallableMethod;
|
|
return new ModuleAnswer($this->error);
|
|
}
|
|
|
|
|
|
/* [3] On amorce la methode
|
|
=========================================================*/
|
|
$returned = call_user_func_array( $this->getFunctionCaller(), $this->data );
|
|
|
|
|
|
/* [4] Gestion de la reponse
|
|
=========================================================*/
|
|
$answer = new ModuleAnswer($this->error);
|
|
$answer->appendAll($returned);
|
|
|
|
return $answer;
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* DESERIALISATION ET CREATION D'UN OBJET
|
|
*
|
|
* @jsonString<String> Json au format string contenant les donnees
|
|
*
|
|
* @return instance<ModuleRequest> Retourne un objet de type <ModuleRequest>
|
|
*
|
|
*/
|
|
public static function fromString($jsonString){
|
|
$json = json_decode( $jsonString, true );
|
|
|
|
// Verification du parsage
|
|
if( $json == null )
|
|
return new ModuleRequest();
|
|
|
|
// Verification des parametres
|
|
if( !isset($json['path']) )
|
|
return new ModuleRequest();
|
|
|
|
// On definit $data au cas ou il soit vide
|
|
$data = (isset($json['data'])) ? $json['data'] : array();
|
|
|
|
return new ModuleRequest($json['path'], $data);
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* DESERIALISATION A PARTIR DES DONNEES POST
|
|
*
|
|
* @post<Array> Tableau des donnes $_POST => @path + @data (opt)
|
|
*
|
|
* @return instance<ModuleRequest> Retourne un objet de type <ModuleRequest>
|
|
*
|
|
*/
|
|
public static function fromPost($post){
|
|
/* [0] Verification de l'authentification
|
|
=========================================================*/
|
|
/* (1) Si le token n'est pas dans le header */
|
|
if( !isset($_SERVER['PHP_AUTH_DIGEST']) ){
|
|
$tmp = new ModuleRequest();
|
|
$tmp->error = ManagerError::TokenError;
|
|
return $tmp;
|
|
}
|
|
|
|
/* (2) Si le token n'est pas dans la BDD */
|
|
$checkToken = new Repo('token/check', array($_SERVER['PHP_AUTH_DIGEST']) );
|
|
$valid_token = $checkToken->answer();
|
|
|
|
if( !$valid_token ){
|
|
$tmp = new ModuleRequest();
|
|
$tmp->error = ManagerError::TokenError;
|
|
return $tmp;
|
|
}
|
|
|
|
/* [1] On verifie que le @path est renseigne
|
|
=========================================================*/
|
|
if( !isset($post['path']) )
|
|
return new ModuleRequest();
|
|
|
|
/* [2] On verifie que @data est renseigne
|
|
=========================================================*/
|
|
// Si variable n'existe pas, on cree un tableau vide
|
|
$data = (isset($post['data'])) ? $post['data'] : array();
|
|
|
|
// Si c'est toujours pas un tableau, on essaie de voir si c'est un json
|
|
$data = (!is_array($data)) ? json_decode($data, true) : $data;
|
|
|
|
// Si toujours pas de tableau, on cree un tableau vide
|
|
$data = (!is_array($data)) ? array() : $data;
|
|
|
|
|
|
/* [3] On retourne une instance de <ModuleRequest>
|
|
=========================================================*/
|
|
return new ModuleRequest($post['path'], $data);
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* VERIFICATION DU FORMAT ET DE LA COHERENCE DU CHEMIN SPECIFIE
|
|
*
|
|
* @path<String> String correspondant au chemin de delegation ("module/methode")
|
|
*
|
|
* @return validity<Boolean> Retourne si oui ou non l'objet est correct
|
|
*
|
|
*/
|
|
private function checkPath($path){
|
|
/* [1] Verification format general
|
|
=========================================================*/
|
|
if( !preg_match('#^([\w_-]+)/([\w_-]+)$#i', $path, $matches) ){ // Si mauvais format
|
|
$this->error = ManagerError::WrongPathModule;
|
|
return false;
|
|
}
|
|
|
|
// On recupere les donnes de la regex
|
|
$module = $matches[1];
|
|
$method = $matches[2];
|
|
|
|
/* [2] Verification de l'existence du module (conf)
|
|
=========================================================*/
|
|
if( !array_key_exists($module, $this->modules) ){ // Si le module n'est pas specifie dans la conf
|
|
$this->error = ManagerError::UnknownModule;
|
|
return false; // On retourne FALSE, si erreur
|
|
}
|
|
|
|
/* [3] Verification de l'existence de la methode (conf)
|
|
=========================================================*/
|
|
if( array_search($method, $this->modules[$module]) === false ){ // Si la methode n'est pas specifie dans la conf
|
|
$this->error = ManagerError::UnknownMethod;
|
|
return false; // On retourne FALSE, si erreur
|
|
}
|
|
|
|
|
|
|
|
/* [4] Enregistrement du chemin et renvoi de SUCCESS
|
|
=========================================================*/
|
|
$this->path = array(
|
|
'module' => $module,
|
|
'method' => $method
|
|
);
|
|
|
|
return true;
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
/* RENVOI LE CHEMIN D'AMORCAGE DE LA METHODE
|
|
*
|
|
* @return path<Array> Retourne le chemin d'amorcage de la requete
|
|
*
|
|
*/
|
|
private function getFunctionCaller(){
|
|
return array( '\\manager\\module\\'.$this->path['module'], $this->path['method'] );
|
|
}
|
|
|
|
|
|
}
|
|
|
|
?>
|