Subversion Repositories Applications.wikini

Rev

Rev 35 | Rev 37 | 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);
36 aurelien 37 
			if ($page == null) {
38 
				$message = 'La page demandée n\'existe pas';
39 
				$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
40 
				throw new Exception($message, $code);
41 
			}
33 aurelien 42 
			$retour = $this->formaterRetour($page);
43 
 
44 
			$this->envoyerContenuJson($retour);
45 
		} catch (Exception $e) {
46 
			$this->envoyerErreur($e);
30 aurelien 47 
		}
48 
	}
49 
 
31 aurelien 50 
	private function definirValeurParDefautDesParametres() {
51 
		if (isset($this->parametres['txt_format']) == false) {
36 aurelien 52 
			$this->parametres['txt_format'] = 'text/plain';
31 aurelien 53 
		}
54 
	}
55 
 
30 aurelien 56 
	private function verifierParametres($parametres) {
33 aurelien 57 
		$erreurs = array();
58 
 
31 aurelien 59 
		if (isset($parametres['txt_format'])) {
60 
			if(!in_array($parametres['txt_format'], $this->formats_retour)) {
35 aurelien 61 
				$message = "La valeur du paramètre 'txt.format' peut seulement prendre les valeurs : text/plain et text/html.";
33 aurelien 62 
				$erreurs[] = $message;
30 aurelien 63 
			}
64 
		}
31 aurelien 65 
 
33 aurelien 66 
		if(isset($parametres['txt_section_position']) && !is_numeric($parametres['txt_section_position'])) {
67 
			$message = "La valeur du paramètre 'txt.section.position' peut seulement prendre des valeurs numeriques";
68 
			$erreurs[] = $message;
31 aurelien 69 
		}
70 
 
33 aurelien 71 
		if(isset($parametres['txt_section_titre']) && trim($parametres['txt_section_titre']) == '') {
72 
			$message = "La valeur du paramètre 'txt.section.titre' ne peut pas être vide si celui-ci est présent";
73 
			$erreurs[] = $message;
74 
		}
75 
 
76 
		if (count($erreurs) > 0) {
77 
			$message = implode('<br />', $erreurs);
78 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
79 
			throw new Exception($message, $code);
80 
		}
81 
	}
82 
 
83 
	private function analyserParametres($ressources, $parametres) {
84 
		$this->pageNom = $ressources[0];
31 aurelien 85 
		if(isset($parametres['txt_section_titre'])) {
86 
			$this->section = $parametres['txt_section_titre'];
87 
		}
33 aurelien 88 
		if(isset($parametres['txt_section_position'])) {
89 
			$this->section = $parametres['txt_section_position'];
90 
		}
91 
		if (isset($parametres['txt_format'])) {
92 
			$this->retour = $parametres['txt_format'];
93 
		}
30 aurelien 94 
	}
31 aurelien 95 
 
35 aurelien 96 
	private function consulterPage($page, $section = null) {
36 aurelien 97 
 
31 aurelien 98 
		$this->wiki = Registre::get('wikiApi');
99 
		$this->wiki->setPageCourante($this->pageNom);
100 
		$page = $this->wiki->LoadPage($page);
36 aurelien 101 
 
102 
		if($page != null) {
103 
			// attention les wikis sont souvent en ISO !
104 
			$page["body"] = $this->convertirTexteWikiVersEncodageAppli($page['body']);
105 
 
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 = '';
117 
 
118 
		if(is_numeric($section)) {
119 
			$section_retour =  $this->getSectionParNumero($contenu_page, $section);
120 
		} else {
121 
			$section_retour =  $this->getSectionParTitre($contenu_page, $section);
122 
		}
123 
 
124 
		return $section_retour;
125 
	}
126 
 
127 
	public function getSectionParNumero($page, $num) {
128 
		preg_match_all('/(=[=]+[ ]*)(.[.^=]*)+[ ]*=[=]+[.]*/i', $page, $sections, PREG_OFFSET_CAPTURE);
129 
		$sectionTxt = '';
130 
		$debut_section = 0;
131 
		$lg_page = strlen($page);
132 
		$fin_section = $lg_page;
133 
 
134 
		if($num <= count($sections[1]) && $num > 0) {
135 
 
136 
			$debut_section = $sections[1][$num - 1][1];
137 
			$separateur = trim($sections[1][$num - 1][0]);
138 
			$separateur_trouve = false;
139 
 
140 
			for($i = $num; $i < count($sections[1]); $i++) {
141 
				$fin_section = $sections[1][$i][1];
142 
				if($separateur == trim($sections[1][$i][0])) {
143 
					$separateur_trouve = true;
144 
					break;
145 
				}
146 
			}
147 
 
148 
			$fin_section = $separateur_trouve ? $fin_section : $lg_page;
149 
			$sectionTxt = substr($page, $debut_section, $fin_section - $debut_section);
150 
		} else {
151 
			$sectionTxt = '';
152 
		}
153 
 
154 
		return $sectionTxt;
155 
	}
156 
 
157 
	public function getSectionParTitre($page, $titre) {
158 
		$section = '';
159 
		$reg_exp = '/((=[=]+)[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+)[.]*/i';
160 
		$match = preg_split($reg_exp, $page, 2, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY);
161 
 
162 
		if(count($match) > 3) {
163 
			$section = explode(trim($match[2]), $match[3], 2);
35 aurelien 164 
			$section = $match[1].$section[0];
31 aurelien 165 
		} elseif(count($match) == 2) {
166 
			$section = explode(trim($match[1]), $match[2], 2);
35 aurelien 167 
			$section = $match[0].$section[0];
31 aurelien 168 
		} else {
169 
			$section = "";
170 
		}
171 
 
172 
		return $section;
173 
	}
174 
 
175 
	private function formaterRetour($page) {
176 
 
33 aurelien 177 
		$mime = null;
178 
		$texte = '';
179 
 
31 aurelien 180 
		switch($this->retour) {
35 aurelien 181 
			case self::MIME_HTML:
33 aurelien 182 
				$texte = $this->wiki->Format($page["body"], "wakka");
183 
				$mime = self::MIME_HTML;
31 aurelien 184 
				break;
185 
			default:
33 aurelien 186 
				$texte = $page["body"];
187 
				$mime = self::MIME_TEXT;
31 aurelien 188 
		}
33 aurelien 189 
 
35 aurelien 190 
		$url = $this->wiki->Href("", $this->pageNom);
191 
 
33 aurelien 192 
		$retour = array('id' => $this->pageNom,
193 
				'titre' => $this->pageNom,
194 
				'mime' => $mime,
195 
				'texte' => $texte,
35 aurelien 196 
				'href' => $url);
33 aurelien 197 
 
31 aurelien 198 
		return $retour;
199 
	}
35 aurelien 200 
 
201 
	public function ajouter($ressources, $requeteDonnees) {
202 
		return $this->modifier($ressources, $requeteDonnees);
203 
	}
204 
 
205 
	public function modifier($ressources, $requeteDonnees) {
36 aurelien 206 
 
207 
		$this->verifierParametresEcriture($requeteDonnees);
208 
		$this->analyserParametresEcriture($requeteDonnees);
209 
 
35 aurelien 210 
		$this->wiki = Registre::get('wikiApi');
211 
		$this->wiki->setPageCourante($this->pageNom);
212 
 
213 
		$texte = $requeteDonnees['texte'];
214 
		$page = $this->consulterPage($this->pageNom);
36 aurelien 215 
 
216 
		if($page != null) {
217 
			$corps = ($this->section != null) ? $this->remplacerSection($this->section, $texte, $page['body']) : $texte;
218 
		} else {
219 
			$corps = $texte;
35 aurelien 220 
		}
36 aurelien 221 
		$ecriture = $this->ecrirePage($this->pageNom, $corps);
35 aurelien 222 
		if($ecriture) {
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) {
234 
		$section_page_originale = $this->decouperPageSection($corps, $titre_ou_numero_section);
235 
		$contenu = str_replace($section_page_originale, $texte, $corps);
236 
 
237 
		return $contenu;
238 
	}
239 
 
240 
	private function ecrirePage($nom_page, $contenu) {
241 
 
242 
		$texte_encode = $this->convertirTexteAppliVersEncodageWiki($contenu);
243 
		$ecriture = $this->wiki->SavePage($nom_page, $texte_encode, "", true);
244 
 
245 
		return $ecriture;
246 
	}
247 
 
248 
	private function analyserParametresEcriture($parametres) {
249 
		$this->pageNom = $parametres['wiki'];
250 
		$this->section = isset($parametres['section']) ? $parametres['section'] : null;
251 
	}
252 
 
253 
	private function verifierParametresEcriture($parametres) {
254 
 
255 
		$erreurs = array();
256 
 
257 
		if(!isset($parametres['texte'])) {
258 
			$message = "Le paramètre texte est obligatoire";
259 
			$erreurs[] = $message;
260 
		}
261 
 
262 
		if(!isset($parametres['wiki']) || trim($parametres['wiki']) == '') {
263 
			$message = "Le paramètre wiki est obligatoire";
264 
			$erreurs[] = $message;
265 
		}
266 
 
267 
		if (count($erreurs) > 0) {
268 
			$message = implode('<br />', $erreurs);
269 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
270 
			throw new Exception($message, $code);
271 
		}
272 
	}
273 
 
35 aurelien 274 
	private function convertirTexteWikiVersEncodageAppli($texte) {
275 
		if(Config::get('encodage_appli') != Config::get('encodage_wiki')) {
276 
			$texte = mb_convert_encoding($texte,Config::get('encodage_appli'),Config::get('encodage_wiki'));
277 
		}
278 
		return $texte;
279 
	}
280 
 
281 
	private function convertirTexteAppliVersEncodageWiki($texte) {
282 
		if(Config::get('encodage_appli') != Config::get('encodage_wiki')) {
283 
			$texte = mb_convert_encoding($texte,Config::get('encodage_wiki'),Config::get('encodage_appli'));
284 
		}
285 
		return $texte;
286 
	}
30 aurelien 287 
}
288 
?>