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
?>