Subversion Repositories Applications.wikini

Compare Revisions

Ignore whitespace Rev 48 → Rev 49

/trunk/api/rest/modules/0.5/Pages.php
13,52 → 13,52
* @version $Id$
*/
class Pages extends Service {
 
private $wiki = null;
private $pageNom = null;
private $section = null;
private $creerPage = false;
private $templateDefaut = null;
 
private $retour = null;
private $retour = 'txt';
private $formats_retour = array('text/plain','text/html');
private $format_texte;
 
const MIME_JSON = 'application/json';
const MIME_HTML = 'text/html';
const MIME_TEXT = 'text/plain';
 
public function consulter($ressources, $parametres) {
 
try {
$this->definirValeurParDefautDesParametres();
$this->verifierParametres($parametres);
$this->analyserParametres($ressources, $parametres);
 
$page = $this->consulterPage($this->pageNom, $this->section);
 
if($page == null && $this->creerPage) {
$this->creerPageAPartirTemplate($this->pageNom, $this->templateDefaut);
$page = $this->consulterPage($this->pageNom, $this->section);
}
 
$retour = $this->formaterRetour($page);
 
$this->envoyerContenuJson($retour);
} catch (Exception $e) {
$this->envoyerErreur($e);
}
}
 
private function definirValeurParDefautDesParametres() {
if (isset($this->parametres['txt_format']) == false) {
$this->parametres['txt_format'] = 'text/plain';
}
}
 
private function verifierParametres($parametres) {
$erreurs = array();
 
if (isset($parametres['txt_format'])) {
if(!in_array($parametres['txt_format'], $this->formats_retour)) {
$message = "La valeur du paramètre 'txt.format' peut seulement prendre les valeurs : text/plain et text/html.";
65,27 → 65,27
$erreurs[] = $message;
}
}
 
if (isset($parametres['txt_section_position']) && !is_numeric($parametres['txt_section_position'])) {
$message = "La valeur du paramètre 'txt.section.position' peut seulement prendre des valeurs numeriques";
$erreurs[] = $message;
}
 
if (isset($parametres['txt_section_titre']) && trim($parametres['txt_section_titre']) == '') {
$message = "La valeur du paramètre 'txt.section.titre' ne peut pas être vide si celui-ci est présent";
$erreurs[] = $message;
}
 
if (isset($parametres['txt_section_titre']) && trim($parametres['txt_section_titre']) == '') {
$message = "La valeur du paramètre 'txt.section.titre' ne peut pas être vide si celui-ci est présent";
$erreurs[] = $message;
}
 
if (isset($parametres['txt_template']) && trim($parametres['txt_template']) == '') {
$message = "La valeur du paramètre 'txt_template' ne peut pas être vide si celui-ci est présent";
$erreurs[] = $message;
}
 
if (count($erreurs) > 0) {
$message = implode('<br />', $erreurs);
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
92,8 → 92,8
throw new Exception($message, $code);
}
}
 
private function analyserParametres($ressources, $parametres) {
private function analyserParametres($ressources, $parametres) {
$this->pageNom = $ressources[0];
if (isset($parametres['txt_section_titre'])) {
$this->section = $parametres['txt_section_titre'];
109,9 → 109,9
$this->templateDefaut = $parametres['txt_template'];
}
}
 
private function consulterPage($page, $section = null) {
 
$this->wiki = Registre::get('wikiApi');
// La variable globale wiki est déclarée par les wiki et leurs plugins
// un bug lié à certains plugin impose de la redéclarer et la réaffecter
119,17 → 119,26
$wiki = $this->wiki;
$this->wiki->setPageCourante($this->pageNom);
$page = $this->wiki->LoadPage($page);
 
if ($page != null) {
// attention les wikis sont souvent en ISO !
$page["body"] = $this->convertirTexteWikiVersEncodageAppli($page['body']);
if($section != null) {
$page["body"] = $this->decouperPageSection($page["body"], $section);
$sections_tab = explode(',', $section);
if(count($sections_tab) > 1) {
foreach($sections_tab as $section_t) {
$page["sections"][$section_t] = $this->decouperPageSection($page["body"], $section_t);
}
} else {
$page["body"] = $this->decouperPageSection($page["body"], $section);
}
}
}
 
return $page;
}
 
private function decouperPageSection($contenu_page, $section) {
$section_retour = '';
if (is_numeric($section)) {
139,7 → 148,7
}
return $section_retour;
}
 
public function getSectionParNumero($page, $num) {
preg_match_all('/(=[=]+[ ]*)(.[.^=]*)+[ ]*=[=]+[.]*/i', $page, $sections, PREG_OFFSET_CAPTURE);
$sectionTxt = '';
146,13 → 155,13
$debut_section = 0;
$lg_page = strlen($page);
$fin_section = $lg_page;
 
if ($num <= count($sections[1]) && $num > 0) {
 
if ($num <= count($sections[1]) && $num > 0) {
$debut_section = $sections[1][$num - 1][1];
$separateur = trim($sections[1][$num - 1][0]);
$separateur_trouve = false;
 
for ($i = $num; $i < count($sections[1]); $i++) {
$fin_section = $sections[1][$i][1];
if($separateur == trim($sections[1][$i][0])) {
160,10 → 169,10
break;
}
}
 
$fin_section = $separateur_trouve ? $fin_section : $lg_page;
$sectionTxt = substr($page, $debut_section, $fin_section - $debut_section);
 
} else {
$sectionTxt = '';
}
170,7 → 179,7
 
return $sectionTxt;
}
 
public function getSectionParTitre($page, $titre, $inclure_titre = false) {
$section = '';
$reg_exp = '/((=[=]+)[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+)[.]*/i';
186,18 → 195,23
} else {
$section = "";
}
 
return $section;
}
 
private function formaterRetour($page) {
 
$mime = null;
$texte = '';
 
switch ($this->retour) {
case self::MIME_HTML:
$texte = $this->wiki->Format($page["body"], "wakka");
if(!empty($page["sections"])) {
foreach($page["sections"] as &$page_section) {
$page_section = $this->wiki->Format($page_section, "wakka");
}
}
$mime = self::MIME_HTML;
break;
default:
204,31 → 218,32
$texte = $page["body"];
$mime = self::MIME_TEXT;
}
 
$url = $this->wiki->Href("", $this->pageNom);
 
$retour = array('id' => $this->pageNom,
'titre' => $this->pageNom,
'mime' => $mime,
'texte' => $texte,
'sections' => $page["sections"],
'href' => $url);
 
return $retour;
}
 
private function creerPageAPartirTemplate($tag_page_a_creer, $tag_template) {
$page_template = $this->consulterPage($tag_template);
$corps_nouvelle_page = ($page_template != null) ? $page_template['body'] : '';
// si le template n'existe pas, la page créée sera vide
$ecriture = $this->ecrirePage($tag_page_a_creer, $corps_nouvelle_page);
 
$ecriture = $this->ecrirePage($tag_page_a_creer, $corps_nouvelle_page);
return $ecriture;
}
 
public function ajouter($ressources, $requeteDonnees) {
return $this->modifier($ressources, $requeteDonnees);
}
 
public function modifier($ressources, $requeteDonnees) {
 
$requeteDonnees['pageTag'] = $ressources[0];
236,18 → 251,18
$this->analyserParametresEcriture($requeteDonnees);
$this->wiki = Registre::get('wikiApi');
$this->wiki->setPageCourante($this->pageNom);
 
$texte = $requeteDonnees['pageContenu'];
$page = $this->consulterPage($this->pageNom);
 
if ($page != null) {
$corps = ($this->section != null) ? $this->remplacerSection($this->section, $texte, $page['body']) : $texte;
$corps = ($this->section != null) ? $this->remplacerSection($this->section, $texte, $page['body']) : $texte;
} else {
$corps = $texte;
}
 
}
$ecriture = $this->ecrirePage($this->pageNom, $corps);
 
if ($ecriture) {
$this->envoyerCreationEffectuee();
} else {
255,13 → 270,13
$code = RestServeur::HTTP_CODE_ERREUR;
throw new Exception($message, $code);
}
 
return $ecriture;
}
 
/**
*
* Si la section demandée existe dans la page, renvoie un tableau contenant le numéro de caractère de
*
* Si la section demandée existe dans la page, renvoie un tableau contenant le numéro de caractère de
* début de la section, après son titre, ainsi que la longeur du titre
* @param string $titre de la section
* @param string $page contenu de la page wiki
268,26 → 283,26
* @return tableau associatif tel que décrit ici
*/
private function getInformationsPositionSection($titre, $page) {
 
preg_match_all('/(=[=]+[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+[.]*)/i', $page, $sections, PREG_OFFSET_CAPTURE);
$longueur_titre = 0;
$debut_section_apres_titre = 0;
 
if (count($sections) > 0 && is_array($sections[0]) && count($sections[0][0]) >= 2) {
$longueur_titre = mb_strlen($sections[0][0][0]);
$debut_section_apres_titre = $sections[0][0][1] + $longueur_titre;
}
 
// ATTENTION : début contient le numéro du caractere de début de la section, après le titre
$infos = array('debut' => $debut_section_apres_titre,
'longueur_titre' => $longueur_titre
);
 
return $infos;
}
 
private function remplacerSection($titre_section, $section_remplacement, $corps) {
 
// insertion d'un saut de ligne pour empêcher de casser le titre, lorsque le titre
// suivant vient directement après la section, sans saut de ligne ni espace
$section_remplacement = "\n".$section_remplacement."\n";
294,44 → 309,44
$section_page_originale = $this->getSectionParTitre($corps, $titre_section, true);
$infos_section = $this->getInformationsPositionSection($titre_section, $corps);
$nb_caracteres_a_remplacer = mb_strlen($section_page_originale) - $infos_section['longueur_titre'];
 
$nouveau_contenu = substr_replace($corps, $section_remplacement, $infos_section['debut'], $nb_caracteres_a_remplacer);
 
return $nouveau_contenu;
}
 
private function ecrirePage($nom_page, $contenu) {
 
$texte_encode = $this->convertirTexteAppliVersEncodageWiki($contenu);
$ecriture = $this->wiki->SavePage($nom_page, $texte_encode, "", true);
 
return $ecriture;
}
 
private function analyserParametresEcriture($parametres) {
$this->pageNom = $parametres['pageTag'];
$this->section = isset($parametres['pageSectionTitre']) ? $parametres['pageSectionTitre'] : null;
}
 
private function verifierParametresEcriture($parametres) {
 
$erreurs = array();
 
if (!isset($parametres['pageContenu'])) {
$message = "Le paramètre pageContenu est obligatoire";
$erreurs[] = $message;
}
 
if (!isset($parametres['pageTag']) || trim($parametres['pageTag']) == '') {
$message = "Le paramètre pageTag est obligatoire";
$erreurs[] = $message;
}
 
if (isset($parametres['pageSectionTitre']) && $parametres['pageSectionTitre'] == '') {
$message = "Le paramètre pageSectionTitre ne doit pas être vide s'il est présent";
$erreurs[] = $message;
}
 
if (count($erreurs) > 0) {
$message = implode('<br />', $erreurs);
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
338,7 → 353,7
throw new Exception($message, $code);
}
}
 
private function convertirTexteWikiVersEncodageAppli($texte) {
if (Config::get('encodage_appli') != Config::get('encodage_wiki')) {
$texte = mb_convert_encoding($texte,Config::get('encodage_appli'),Config::get('encodage_wiki'));
345,7 → 360,7
}
return $texte;
}
 
private function convertirTexteAppliVersEncodageWiki($texte) {
if (Config::get('encodage_appli') != Config::get('encodage_wiki')) {
$texte = mb_convert_encoding($texte,Config::get('encodage_wiki'),Config::get('encodage_appli'));
352,5 → 367,5
}
return $texte;
}
}
}
?>