Subversion Repositories Applications.wikini

Rev

Rev 37 | Rev 39 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
30 aurelien 1 
<?php
2 
// declare(encoding='UTF-8');
3 
/**
31 aurelien 4 
 * Web service de consultation d'un page wiki
30 aurelien 5 
 *
6 
 * @category	php 5.2
31 aurelien 7 
 * @package		wapi
8 
 * @author		Aurélien Peronnet < aurelien@tela-botanica.org>
9 
 * @author		Jean-Pascal Milcent < jpm@tela-botanica.org>
30 aurelien 10 
 * @copyright	Copyright (c) 2011, Tela Botanica (accueil@tela-botanica.org)
11 
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
12 
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
13 
 * @version		$Id$
14 
 */
15 
class Pages extends Service {
16 
 
31 aurelien 17 
	private $wiki = null;
30 aurelien 18 
	private $pageNom = null;
31 aurelien 19 
	private $section = null;
30 aurelien 20 
 
31 aurelien 21 
	private $retour = 'txt';
35 aurelien 22 
	private $formats_retour = array('text/plain','text/html');
33 aurelien 23 
	private $format_texte;
31 aurelien 24 
 
33 aurelien 25 
	const MIME_JSON = 'application/json';
26 
	const MIME_HTML = 'text/html';
27 
	const MIME_TEXT = 'text/plain';
28 
 
30 aurelien 29 
	public function consulter($ressources, $parametres) {
33 aurelien 30 
 
31 
		try {
32 
			$this->definirValeurParDefautDesParametres();
33 
			$this->verifierParametres($parametres);
34 
			$this->analyserParametres($ressources, $parametres);
35 
 
35 aurelien 36 
			$page = $this->consulterPage($this->pageNom, $this->section);
37 aurelien 37 
 
36 aurelien 38 
			if ($page == null) {
39 
				$message = 'La page demandée n\'existe pas';
40 
				$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
41 
				throw new Exception($message, $code);
42 
			}
33 aurelien 43 
			$retour = $this->formaterRetour($page);
44 
 
45 
			$this->envoyerContenuJson($retour);
46 
		} catch (Exception $e) {
47 
			$this->envoyerErreur($e);
30 aurelien 48 
		}
49 
	}
50 
 
31 aurelien 51 
	private function definirValeurParDefautDesParametres() {
52 
		if (isset($this->parametres['txt_format']) == false) {
36 aurelien 53 
			$this->parametres['txt_format'] = 'text/plain';
31 aurelien 54 
		}
55 
	}
56 
 
30 aurelien 57 
	private function verifierParametres($parametres) {
33 aurelien 58 
		$erreurs = array();
59 
 
31 aurelien 60 
		if (isset($parametres['txt_format'])) {
61 
			if(!in_array($parametres['txt_format'], $this->formats_retour)) {
35 aurelien 62 
				$message = "La valeur du paramètre 'txt.format' peut seulement prendre les valeurs : text/plain et text/html.";
33 aurelien 63 
				$erreurs[] = $message;
30 aurelien 64 
			}
65 
		}
31 aurelien 66 
 
37 aurelien 67 
		if (isset($parametres['txt_section_position']) && !is_numeric($parametres['txt_section_position'])) {
33 aurelien 68 
			$message = "La valeur du paramètre 'txt.section.position' peut seulement prendre des valeurs numeriques";
69 
			$erreurs[] = $message;
31 aurelien 70 
		}
71 
 
37 aurelien 72 
		if (isset($parametres['txt_section_titre']) && trim($parametres['txt_section_titre']) == '') {
33 aurelien 73 
			$message = "La valeur du paramètre 'txt.section.titre' ne peut pas être vide si celui-ci est présent";
74 
			$erreurs[] = $message;
75 
		}
76 
 
77 
		if (count($erreurs) > 0) {
78 
			$message = implode('<br />', $erreurs);
79 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
80 
			throw new Exception($message, $code);
81 
		}
82 
	}
83 
 
84 
	private function analyserParametres($ressources, $parametres) {
85 
		$this->pageNom = $ressources[0];
37 aurelien 86 
		if (isset($parametres['txt_section_titre'])) {
31 aurelien 87 
			$this->section = $parametres['txt_section_titre'];
88 
		}
37 aurelien 89 
		if (isset($parametres['txt_section_position'])) {
33 aurelien 90 
			$this->section = $parametres['txt_section_position'];
91 
		}
92 
		if (isset($parametres['txt_format'])) {
93 
			$this->retour = $parametres['txt_format'];
94 
		}
30 aurelien 95 
	}
31 aurelien 96 
 
35 aurelien 97 
	private function consulterPage($page, $section = null) {
36 aurelien 98 
 
31 aurelien 99 
		$this->wiki = Registre::get('wikiApi');
100 
		$this->wiki->setPageCourante($this->pageNom);
101 
		$page = $this->wiki->LoadPage($page);
37 aurelien 102 
 
103 
		if ($page != null) {
36 aurelien 104 
			// attention les wikis sont souvent en ISO !
105 
			$page["body"] = $this->convertirTexteWikiVersEncodageAppli($page['body']);
106 
			if($section != null) {
107 
				$page["body"] = $this->decouperPageSection($page["body"], $section);
108 
			}
31 aurelien 109 
		}
110 
 
111 
		return $page;
112 
	}
113 
 
35 aurelien 114 
	private function decouperPageSection($contenu_page, $section) {
31 aurelien 115 
 
116 
		$section_retour = '';
37 aurelien 117 
		if (is_numeric($section)) {
31 aurelien 118 
			$section_retour =  $this->getSectionParNumero($contenu_page, $section);
119 
		} else {
120 
			$section_retour =  $this->getSectionParTitre($contenu_page, $section);
121 
		}
122 
		return $section_retour;
123 
	}
124 
 
125 
	public function getSectionParNumero($page, $num) {
126 
		preg_match_all('/(=[=]+[ ]*)(.[.^=]*)+[ ]*=[=]+[.]*/i', $page, $sections, PREG_OFFSET_CAPTURE);
127 
		$sectionTxt = '';
128 
		$debut_section = 0;
129 
		$lg_page = strlen($page);
130 
		$fin_section = $lg_page;
131 
 
37 aurelien 132 
		if ($num <= count($sections[1]) && $num > 0) {
31 aurelien 133 
 
134 
			$debut_section = $sections[1][$num - 1][1];
135 
			$separateur = trim($sections[1][$num - 1][0]);
136 
			$separateur_trouve = false;
137 
 
37 aurelien 138 
			for ($i = $num; $i < count($sections[1]); $i++) {
31 aurelien 139 
				$fin_section = $sections[1][$i][1];
140 
				if($separateur == trim($sections[1][$i][0])) {
141 
					$separateur_trouve = true;
142 
					break;
143 
				}
144 
			}
145 
 
146 
			$fin_section = $separateur_trouve ? $fin_section : $lg_page;
147 
			$sectionTxt = substr($page, $debut_section, $fin_section - $debut_section);
37 aurelien 148 
 
31 aurelien 149 
		} else {
150 
			$sectionTxt = '';
37 aurelien 151 
		}
31 aurelien 152 
 
153 
		return $sectionTxt;
154 
	}
155 
 
156 
	public function getSectionParTitre($page, $titre) {
157 
		$section = '';
158 
		$reg_exp = '/((=[=]+)[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+)[.]*/i';
159 
		$match = preg_split($reg_exp, $page, 2, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
37 aurelien 160 
		if (count($match) > 3) {
31 aurelien 161 
			$section = explode(trim($match[2]), $match[3], 2);
35 aurelien 162 
			$section = $match[1].$section[0];
37 aurelien 163 
		} elseif (count($match) == 3) {
31 aurelien 164 
			$section = explode(trim($match[1]), $match[2], 2);
35 aurelien 165 
			$section = $match[0].$section[0];
31 aurelien 166 
		} else {
167 
			$section = "";
168 
		}
169 
 
170 
		return $section;
171 
	}
172 
 
173 
	private function formaterRetour($page) {
174 
 
33 aurelien 175 
		$mime = null;
176 
		$texte = '';
177 
 
37 aurelien 178 
		switch ($this->retour) {
35 aurelien 179 
			case self::MIME_HTML:
33 aurelien 180 
				$texte = $this->wiki->Format($page["body"], "wakka");
181 
				$mime = self::MIME_HTML;
31 aurelien 182 
				break;
183 
			default:
33 aurelien 184 
				$texte = $page["body"];
185 
				$mime = self::MIME_TEXT;
31 aurelien 186 
		}
33 aurelien 187 
 
35 aurelien 188 
		$url = $this->wiki->Href("", $this->pageNom);
189 
 
33 aurelien 190 
		$retour = array('id' => $this->pageNom,
191 
				'titre' => $this->pageNom,
192 
				'mime' => $mime,
193 
				'texte' => $texte,
35 aurelien 194 
				'href' => $url);
33 aurelien 195 
 
31 aurelien 196 
		return $retour;
197 
	}
35 aurelien 198 
 
199 
	public function ajouter($ressources, $requeteDonnees) {
200 
		return $this->modifier($ressources, $requeteDonnees);
201 
	}
202 
 
203 
	public function modifier($ressources, $requeteDonnees) {
37 aurelien 204 
 
205 
		$requeteDonnees['pageTag'] = $ressources[0];
36 aurelien 206 
		$this->verifierParametresEcriture($requeteDonnees);
207 
		$this->analyserParametresEcriture($requeteDonnees);
35 aurelien 208 
		$this->wiki = Registre::get('wikiApi');
209 
		$this->wiki->setPageCourante($this->pageNom);
210 
 
37 aurelien 211 
		$texte = $requeteDonnees['pageContenu'];
35 aurelien 212 
		$page = $this->consulterPage($this->pageNom);
36 aurelien 213 
 
37 aurelien 214 
		if ($page != null) {
36 aurelien 215 
			$corps = ($this->section != null) ? $this->remplacerSection($this->section, $texte, $page['body']) : $texte;
216 
		} else {
217 
			$corps = $texte;
35 aurelien 218 
		}
37 aurelien 219 
 
36 aurelien 220 
		$ecriture = $this->ecrirePage($this->pageNom, $corps);
37 aurelien 221 
 
222 
		if ($ecriture) {
35 aurelien 223 
			$this->envoyerCreationEffectuee();
224 
		} else {
36 aurelien 225 
			$message = 'Impossible de créer ou modifier la page';
226 
			$code = RestServeur::HTTP_CODE_ERREUR;
227 
			throw new Exception($message, $code);
35 aurelien 228 
		}
229 
 
230 
		return $ecriture;
231 
	}
232 
 
36 aurelien 233 
	private function remplacerSection($titre_ou_numero_section, $section_remplacement, $corps) {
38 aurelien 234 
 
235 
		//TODO: empecher l'insertion de section de niveau supérieur (avec plus de =)
236 
		// en les réduisant pour que le niveau de la section soit toujours inférieur à celui
237 
		// de la section éditée ? voir avec le PO !
238 
 
239 
		//TODO: insérer un espace ou un saut de ligne à la fin du texte si celui-ci n'en contient pas
240 
		// à la fin, ceci pour éviter que le formatage saute lors de l'édition du wiki
36 aurelien 241 
		$section_page_originale = $this->decouperPageSection($corps, $titre_ou_numero_section);
37 aurelien 242 
		$contenu = str_replace($section_page_originale, $section_remplacement, $corps);
38 aurelien 243 
 
36 aurelien 244 
		return $contenu;
245 
	}
246 
 
247 
	private function ecrirePage($nom_page, $contenu) {
248 
 
249 
		$texte_encode = $this->convertirTexteAppliVersEncodageWiki($contenu);
250 
		$ecriture = $this->wiki->SavePage($nom_page, $texte_encode, "", true);
251 
 
252 
		return $ecriture;
253 
	}
254 
 
255 
	private function analyserParametresEcriture($parametres) {
37 aurelien 256 
		$this->pageNom = $parametres['pageTag'];
257 
		$this->section = isset($parametres['pageSection']) ? $parametres['pageSection'] : null;
36 aurelien 258 
	}
259 
 
260 
	private function verifierParametresEcriture($parametres) {
261 
 
262 
		$erreurs = array();
263 
 
37 aurelien 264 
		if(!isset($parametres['pageContenu'])) {
265 
			$message = "Le paramètre pageContenu est obligatoire";
36 aurelien 266 
			$erreurs[] = $message;
267 
		}
268 
 
37 aurelien 269 
		if(!isset($parametres['pageTag']) || trim($parametres['pageTag']) == '') {
270 
			$message = "Le paramètre pageTag est obligatoire";
36 aurelien 271 
			$erreurs[] = $message;
272 
		}
273 
 
274 
		if (count($erreurs) > 0) {
275 
			$message = implode('<br />', $erreurs);
276 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
277 
			throw new Exception($message, $code);
278 
		}
279 
	}
280 
 
35 aurelien 281 
	private function convertirTexteWikiVersEncodageAppli($texte) {
282 
		if(Config::get('encodage_appli') != Config::get('encodage_wiki')) {
283 
			$texte = mb_convert_encoding($texte,Config::get('encodage_appli'),Config::get('encodage_wiki'));
284 
		}
285 
		return $texte;
286 
	}
287 
 
288 
	private function convertirTexteAppliVersEncodageWiki($texte) {
289 
		if(Config::get('encodage_appli') != Config::get('encodage_wiki')) {
290 
			$texte = mb_convert_encoding($texte,Config::get('encodage_wiki'),Config::get('encodage_appli'));
291 
		}
292 
		return $texte;
293 
	}
30 aurelien 294 
}
295 
?>