| /branches/v1.0-pithivier/api/rest/modules/0.5/Pages.php |
|---|
| New file |
| 0,0 → 1,371 |
| <?php |
| // declare(encoding='UTF-8'); |
| /** |
| * Web service de consultation d'un page wiki |
| * |
| * @category php 5.2 |
| * @package wapi |
| * @author Aurélien Peronnet < aurelien@tela-botanica.org> |
| * @author Jean-Pascal Milcent < jpm@tela-botanica.org> |
| * @copyright Copyright (c) 2011, Tela Botanica (accueil@tela-botanica.org) |
| * @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
| * @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
| * @version $Id$ |
| */ |
| class Pages extends Service { |
| private $wiki = null; |
| private $pageNom = null; |
| private $section = null; |
| private $creerPage = false; |
| private $templateDefaut = 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."; |
| $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; |
| throw new Exception($message, $code); |
| } |
| } |
| private function analyserParametres($ressources, $parametres) { |
| $this->pageNom = $ressources[0]; |
| if (isset($parametres['txt_section_titre'])) { |
| $this->section = $parametres['txt_section_titre']; |
| } |
| if (isset($parametres['txt_section_position'])) { |
| $this->section = $parametres['txt_section_position']; |
| } |
| if (isset($parametres['txt_format'])) { |
| $this->retour = $parametres['txt_format']; |
| } |
| if (isset($parametres['txt_template'])) { |
| $this->creerPage = true; |
| $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 |
| global $wiki; |
| $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) { |
| $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)) { |
| $section_retour = $this->getSectionParNumero($contenu_page, $section); |
| } else { |
| $section_retour = $this->getSectionParTitre($contenu_page, $section, false); |
| } |
| return $section_retour; |
| } |
| public function getSectionParNumero($page, $num) { |
| preg_match_all('/(=[=]+[ ]*)(.[.^=]*)+[ ]*=[=]+[.]*/i', $page, $sections, PREG_OFFSET_CAPTURE); |
| $sectionTxt = ''; |
| $debut_section = 0; |
| $lg_page = strlen($page); |
| $fin_section = $lg_page; |
| 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])) { |
| $separateur_trouve = true; |
| break; |
| } |
| } |
| $fin_section = $separateur_trouve ? $fin_section : $lg_page; |
| $sectionTxt = substr($page, $debut_section, $fin_section - $debut_section); |
| } else { |
| $sectionTxt = ''; |
| } |
| return $sectionTxt; |
| } |
| public function getSectionParTitre($page, $titre, $inclure_titre = false) { |
| $section = ''; |
| $reg_exp = '/((=[=]+)[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+)[.]*/i'; |
| $match = preg_split($reg_exp, $page, 2, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY); |
| if (count($match) > 3) { |
| $section = explode(trim($match[2]), $match[3], 2); |
| $section = $section[0]; |
| $section = ($inclure_titre) ? $match[1].$section : $section; |
| } elseif (count($match) == 3) { |
| $section = explode(trim($match[1]), $match[2], 2); |
| $section = $section[0]; |
| $section = ($inclure_titre) ? $match[0].$section : $section; |
| } 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: |
| $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); |
| return $ecriture; |
| } |
| public function ajouter($ressources, $requeteDonnees) { |
| return $this->modifier($ressources, $requeteDonnees); |
| } |
| public function modifier($ressources, $requeteDonnees) { |
| $requeteDonnees['pageTag'] = $ressources[0]; |
| $this->verifierParametresEcriture($requeteDonnees); |
| $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; |
| } else { |
| $corps = $texte; |
| } |
| $ecriture = $this->ecrirePage($this->pageNom, $corps); |
| if ($ecriture) { |
| $this->envoyerCreationEffectuee(); |
| } else { |
| $message = 'Impossible de créer ou modifier la page'; |
| $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 |
| * 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 |
| * @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"; |
| $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; |
| 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')); |
| } |
| 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')); |
| } |
| return $texte; |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/rest/modules/0.5/Service.php |
|---|
| New file |
| 0,0 → 1,45 |
| <?php |
| abstract class Service extends RestService { |
| //+----------------------------------------------------------------------------------------------------------------+ |
| // GESTION de l'ENVOIE au NAVIGATEUR |
| protected function formaterEnJsonp($donnees = null, $encodage = 'utf-8') { |
| $contenu = $_GET['callback'].'('.json_encode($donnees).');'; |
| return $contenu; |
| } |
| private function envoyerEnteteContenu($encodage, $mime) { |
| if (!is_null($mime) && !is_null($encodage)) { |
| header("Content-Type: $mime; charset=$encodage"); |
| } else if (!is_null($mime) && is_null($encodage)) { |
| header("Content-Type: $mime"); |
| } |
| } |
| public function envoyerContenuJson($donnees = null, $encodage = 'utf-8') { |
| $contenu = json_encode($donnees); |
| $this->envoyerEnteteContenu($encodage, 'application/json'); |
| echo $contenu; |
| exit; |
| } |
| protected function envoyerAuth($message_accueil, $message_echec) { |
| header('HTTP/1.0 401 Unauthorized'); |
| header('WWW-Authenticate: Basic realm="'.mb_convert_encoding($message_accueil, 'ISO-8859-1', 'UTF-8').'"'); |
| header('Content-type: text/plain; charset=UTF-8'); |
| print $message_echec; |
| exit(0); |
| } |
| protected function envoyerErreur($e) { |
| RestServeur::envoyerEnteteStatutHttp($e->getCode()); |
| echo $e->getMessage(); |
| } |
| protected function envoyerCreationEffectuee() { |
| header('HTTP/1.1 201 Created'); |
| echo "OK"; |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/rest/configurations/config.defaut.ini |
|---|
| New file |
| 0,0 → 1,36 |
| ; Encodage : UTF-8 |
| ; +------------------------------------------------------------------------------------------------------+ |
| ; URLs |
| ; Le séparateur utilisé par le framework lorsqu'il génère des URL pour séparer les arguments. |
| ; Pour remettre les valeurs par défaut, utitliser : "php:ini_get('arg_separator.output')" |
| url_arg_separateur_sortie = "&" |
| ; +------------------------------------------------------------------------------------------------------+ |
| ; Info sur l'application |
| info.nom = "Services web de WIKINI (Tela Botanica)" |
| ; Abréviation de l'application |
| info.abr = "WS-WIKINI" |
| ; Version du Framework nécessaire au fonctionnement de cette application |
| info.framework.version = 0.3 |
| ;Encodage de l'application |
| encodage_appli = "UTF-8" |
| encodage_wiki = "ISO-8859-15" |
| ; +------------------------------------------------------------------------------------------------------+ |
| ; Débogage |
| ; Indique si oui ou non on veut afficher le débogage. |
| debogage = true |
| ; Indique sous quelle forme les méssages de débogage doivent s'afficher : |
| ; - "php:Debug::MODE_ECHO" : le message est affiché en utilisant echo |
| ; - "php:Debug::MODE_NOTICE" : le message est affiché en utilisant une erreur de type notice |
| ; - "php:Debug::MODE_ENTETE_HTTP" : les messages sont envoyés dans un entête HTTP "X_REST_DEBOGAGE". |
| ; - "Autre valeur" : les messages sont formatés puis retournés par la méthode de débogage utilisée. |
| debogage_mode = "php:Debug::MODE_ENTETE_HTTP" |
| ; Indique si oui ou non on veut lancer le chronométrage |
| chronometrage = false |
| ; +------------------------------------------------------------------------------------------------------+ |
| ; Spécifique aux services |
| serveur.baseURL = "/yeswiki/api/rest/" |
| serveur.baseAlternativeURL = "/yeswiki/api/rest/" |
| /branches/v1.0-pithivier/api/rest/configurations |
|---|
| New file |
| Property changes: |
| Added: svn:ignore |
| +config.ini |
| /branches/v1.0-pithivier/api/rest/framework.defaut.php |
|---|
| New file |
| 0,0 → 1,7 |
| <?php |
| // Inclusion du Framework |
| // Renomer ce fichier en "framework.php" |
| // Indiquer ci-dessous le chemin absolu vers le fichier Framework.php de la bonne version du Framework |
| $chemin = '/home/'.$_ENV['USER'].'/www/commun/tbframework/0.3/Framework.php'; |
| require_once $chemin; |
| ?> |
| /branches/v1.0-pithivier/api/rest/.htaccess |
|---|
| New file |
| 0,0 → 1,9 |
| <files *.ini> |
| order deny,allow |
| deny from all |
| </files> |
| RewriteEngine On |
| RewriteCond %{REQUEST_FILENAME} !-d |
| RewriteCond %{REQUEST_FILENAME} !-f |
| RewriteRule ^.*$ index.php/ |
| /branches/v1.0-pithivier/api/rest/bibliotheque/WikiApi.php |
|---|
| New file |
| 0,0 → 1,41 |
| <?php |
| class WikiApi { |
| private $page = null; |
| private $wikiObjet = null; |
| private $cheminWiki = null; |
| private $cheminApi = null; |
| public function __construct($cheminWiki, $cheminApi) { |
| $this->cheminWiki = $cheminWiki; |
| $this->cheminApi = $cheminApi; |
| } |
| private function initialiser() { |
| if ($this->page != null) { |
| $_REQUEST['wiki'] = $this->page; |
| } |
| ini_set('include_path',ini_get('include_path').':'.$this->cheminWiki.':'); |
| chdir($this->cheminWiki); |
| include 'api.php'; |
| $this->wikiObjet = $wiki; |
| chdir($this->cheminApi); |
| } |
| public function setPageCourante($page) { |
| $this->page = $page; |
| } |
| public function __call($methodeNom, $arguments) { |
| if ($this->wikiObjet == null) { |
| $this->initialiser(); |
| } |
| chdir($this->cheminWiki); |
| $retour = call_user_func_array(array($this->wikiObjet, $methodeNom), $arguments); |
| chdir($this->cheminApi); |
| return $retour; |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/rest/index.php |
|---|
| New file |
| 0,0 → 1,52 |
| <?php |
| // Permet d'afficher le temps d'execution du service |
| $temps_debut = (isset($_GET['chrono']) && $_GET['chrono'] == 1) ? microtime(true) : ''; |
| // +-------------------------------------------------------------------------------------------------------------------+ |
| /** |
| * Serveur REST Wikini |
| * |
| * Initialise le chargement et l'exécution des services web. |
| * Encodage : UTF-8 |
| * @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
| * @copyright Tela-Botanica 1999-2008 |
| * @licence GPL v3 & CeCILL v2 |
| */ |
| // Le fichier autoload.inc.php du Framework de Tela Botanica doit être appelée avant tout autre chose dans l'application. |
| // Sinon, rien ne sera chargé. |
| // Chemin du fichier chargeant le framework requis |
| $framework = dirname(__FILE__).DIRECTORY_SEPARATOR.'framework.php'; |
| if (!file_exists($framework)) { |
| $e = "Veuillez paramétrer l'emplacement et la version du Framework dans le fichier $framework"; |
| trigger_error($e, E_USER_ERROR); |
| } else { |
| // Inclusion du Framework |
| require_once $framework; |
| // Ajout d'information concernant cette application |
| Framework::setCheminAppli(__FILE__);// Obligatoire |
| Framework::setInfoAppli(Config::get('info')); |
| // Transformation de l'url du handler wikini en url pour le serveur REST |
| // TODO : améliorer la gestion de l'url entre le wikini et le serveur REST |
| //$_SERVER['REQUEST_URI'] = Config::get('serveur.baseURL').$_GET['api']; |
| //$_SERVER['QUERY_STRING'] = $_GET['params'] ? $_GET['params'] : ''; |
| // Création de l'objet Wiki qui sera transmis au service via le Registre |
| Registre::set('cheminApi', getcwd()); |
| Registre::set('cheminWiki', realpath(dirname(__FILE__).DS.'..'.DS.'..'.DS).DS); |
| $wikiApi = new WikiApi(Registre::get('cheminWiki'), Registre::get('cheminApi')); |
| Registre::set('wikiApi', $wikiApi); |
| // Initialisation et lancement du serveur |
| $Serveur = new RestServeur(); |
| $Serveur->executer(); |
| // Affiche le temps d'execution du service |
| if (isset($_GET['chrono']) && $_GET['chrono'] == 1) { |
| $temps_fin = microtime(true); |
| echo 'Temps d\'execution : '.round($temps_fin - $temps_debut, 4); |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/rest |
|---|
| New file |
| Property changes: |
| Added: svn:ignore |
| +framework.php |
| /branches/v1.0-pithivier/api/scripts/configurations/config.defaut.ini |
|---|
| New file |
| 0,0 → 1,2 |
| encodage_appli = "UTF-8" |
| encodage_wiki = "ISO-8859-15" |
| /branches/v1.0-pithivier/api/scripts/configurations |
|---|
| New file |
| Property changes: |
| Added: svn:ignore |
| +config.ini |
| /branches/v1.0-pithivier/api/scripts/framework.defaut.php |
|---|
| New file |
| 0,0 → 1,6 |
| <?php |
| // Inclusion du Framework |
| // Renomer ce fichier en "framework.php" |
| // Indiquer ci-dessous le chemin absolu vers le fichier autoload.inc.php de la bonne version du Framework |
| require_once '/home/www/commun/framework/0.3/Framework.php'; |
| ?> |
| /branches/v1.0-pithivier/api/scripts/bibliotheque/ManipulationPage.php |
|---|
| New file |
| 0,0 → 1,191 |
| <?php |
| // declare(encoding='UTF-8'); |
| /** |
| * Librairie de consultation d'une page wiki |
| * |
| * @category php 5.2 |
| * @package wapi |
| * @author Aurélien Peronnet < aurelien@tela-botanica.org> |
| * @copyright Copyright (c) 2015, Tela Botanica (accueil@tela-botanica.org) |
| * @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
| * @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
| * @version $Id$ |
| */ |
| class ManipulationPage { |
| // C'est dommage cette classe fait doublon avec la classe contenue dans le dossier rest |
| // il faudrait faire une factorisation de tout ça |
| private $wiki = null; |
| private $pageNom = null; |
| private $section = null; |
| private $creerPage = false; |
| private $templateDefaut = null; |
| public function __construct($wiki, $pageNom) { |
| // Cette construction bizarre sert à éviter des bugs issus du comportement de wikini |
| $this->wiki = $wiki; |
| global $wiki; |
| $wiki = $this->wiki; |
| $this->pageNom = $pageNom; |
| $this->wiki->setPageCourante($this->pageNom); |
| } |
| public function consulterPage($page, $section = null) { |
| $page = $this->wiki->LoadPage($page); |
| if ($page != null) { |
| $this->consulterPageSectionsFormatees($page, $section); |
| } |
| return $page; |
| } |
| public function consulterPageSectionsFormatees(&$page, $section) { |
| // attention les wikis sont souvent en ISO ! |
| $page["body"] = $this->convertirTexteWikiVersEncodageAppli($page['body']); |
| if($section != null) { |
| $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); |
| } |
| } |
| } |
| public function decouperPageSection($contenu_page, $section) { |
| $section_retour = ''; |
| if (is_numeric($section)) { |
| $section_retour = $this->getSectionParNumero($contenu_page, $section); |
| } else { |
| $section_retour = $this->getSectionParTitre($contenu_page, $section, false); |
| } |
| return $section_retour; |
| } |
| public function getSectionParNumero($page, $num) { |
| preg_match_all('/(=[=]+[ ]*)(.[.^=]*)+[ ]*=[=]+[.]*/i', $page, $sections, PREG_OFFSET_CAPTURE); |
| $sectionTxt = ''; |
| $debut_section = 0; |
| $lg_page = strlen($page); |
| $fin_section = $lg_page; |
| 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])) { |
| $separateur_trouve = true; |
| break; |
| } |
| } |
| $fin_section = $separateur_trouve ? $fin_section : $lg_page; |
| $sectionTxt = substr($page, $debut_section, $fin_section - $debut_section); |
| } else { |
| $sectionTxt = ''; |
| } |
| return $sectionTxt; |
| } |
| public function getSectionParTitre($page, $titre, $inclure_titre = false) { |
| $section = ''; |
| $reg_exp = '/((=[=]+)[ ]*'.preg_quote(trim($titre), '/').'[ ]*=[=]+)[.]*/i'; |
| $match = preg_split($reg_exp, $page, 2, PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY); |
| if (count($match) > 3) { |
| $section = explode(trim($match[2]), $match[3], 2); |
| $section = $section[0]; |
| $section = ($inclure_titre) ? $match[1].$section : $section; |
| } elseif (count($match) == 3) { |
| $section = explode(trim($match[1]), $match[2], 2); |
| $section = $section[0]; |
| $section = ($inclure_titre) ? $match[0].$section : $section; |
| } else { |
| $section = ""; |
| } |
| return $section; |
| } |
| 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); |
| return $ecriture; |
| } |
| /** |
| * |
| * 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 |
| * @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"; |
| $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; |
| } |
| public function ecrirePage($nom_page, $contenu) { |
| $texte_encode = $this->convertirTexteAppliVersEncodageWiki($contenu); |
| $ecriture = $this->wiki->SavePage($nom_page, $texte_encode, "", true); |
| return $ecriture; |
| } |
| public static 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')); |
| } |
| return $texte; |
| } |
| public static 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')); |
| } |
| return $texte; |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/scripts/bibliotheque/WikiApi.php |
|---|
| New file |
| 0,0 → 1,54 |
| <?php |
| class WikiApi { |
| private $page = null; |
| private $wikiObjet = null; |
| private $cheminWiki = null; |
| private $cheminApi = null; |
| public function __construct($cheminWiki, $cheminApi) { |
| $this->cheminWiki = $cheminWiki; |
| $this->cheminApi = $cheminApi; |
| $this->initialiser(); |
| } |
| private function initialiser() { |
| if ($this->page != null) { |
| $_REQUEST['wiki'] = $this->page; |
| } |
| ini_set('include_path',ini_get('include_path').':'.$this->cheminWiki.':'); |
| chdir($this->cheminWiki); |
| include 'api.php'; |
| $this->wikiObjet = $wiki; |
| chdir($this->cheminApi); |
| } |
| public function setPageCourante($page) { |
| $this->page = $page; |
| } |
| public function chargerClasseWiki($classe) { |
| $chemins = array($this->cheminWiki.'/tools/', $this->cheminWiki.'/formatters/'); |
| foreach ($chemins as $chemin) { |
| $chemin = $chemin.$classe.'.php'; |
| if (file_exists($chemin)) { |
| require_once $chemin; |
| $classeTrouvee = true; |
| } |
| } |
| } |
| public function __call($methodeNom, $arguments) { |
| if ($this->wikiObjet == null) { |
| $this->initialiser(); |
| } |
| chdir($this->cheminWiki); |
| $retour = call_user_func_array(array($this->wikiObjet, $methodeNom), $arguments); |
| chdir($this->cheminApi); |
| return $retour; |
| } |
| } |
| ?> |
| /branches/v1.0-pithivier/api/scripts/cli.php |
|---|
| New file |
| 0,0 → 1,44 |
| <?php |
| // Encodage : UTF-8 |
| // +-------------------------------------------------------------------------------------------------------------------+ |
| /** |
| * Initialise le chargement et l'exécution des scripts |
| * |
| * Lancer ce fichier en ligne de commande avec : |
| * <code>/opt/lampp/bin/php cli.php mon_script -a test</code> |
| * |
| * @category CEL |
| * @package Scripts |
| * @author Mathias CHOUET <mathias@tela-botanica.org> |
| * @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
| * @author Aurelien PERONNET <aurelien@tela-botanica.org> |
| * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt> |
| * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt> |
| * @copyright 1999-2014 Tela Botanica <accueil@tela-botanica.org> |
| */ |
| // Le fichier Framework.php du Framework de Tela Botanica doit être appelée avant tout autre chose dans l'application. |
| // Sinon, rien ne sera chargé. |
| // Chemin du fichier chargeant le framework requis |
| $framework = dirname(__FILE__).DIRECTORY_SEPARATOR.'framework.php'; |
| if (!file_exists($framework)) { |
| $e = "Veuillez paramétrer l'emplacement et la version du Framework dans le fichier $framework"; |
| trigger_error($e, E_USER_ERROR); |
| } else { |
| // Inclusion du Framework |
| require_once $framework; |
| // Ajout d'information concernant cette application |
| Framework::setCheminAppli(__FILE__);// Obligatoire |
| Framework::setInfoAppli(Config::get('info')); |
| // Création de l'objet Wiki qui sera transmis au service via le Registre |
| Registre::set('cheminApi', getcwd()); |
| Registre::set('cheminWiki', realpath(dirname(__FILE__).DS.'..'.DS.'..'.DS).DS); |
| //require_once(getcwd().DS.'bibliotheque'.DS.'WikiApi.php'); |
| $wikiApi = new WikiApi(Registre::get('cheminWiki'), Registre::get('cheminApi')); |
| Registre::set('wikiApi', $wikiApi); |
| // Initialisation et lancement du script appelé en ligne de commande |
| Cli::executer(); |
| } |
| /branches/v1.0-pithivier/api/scripts/modules/migration_smart_flore/MigrationSmartFlore.php |
|---|
| New file |
| 0,0 → 1,109 |
| <?php |
| // declare(encoding='UTF-8'); |
| /** |
| * |
| * @category wiki/smart'Flore |
| * @package Scripts |
| * @author Aurelien PERONNET <aurelien@tela-botanica.org> |
| * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt> |
| * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt> |
| * @copyright 1999-2015 Tela Botanica <accueil@tela-botanica.org> |
| */ |
| class MigrationSmartFlore extends Script { |
| protected $mode_verbeux = false; |
| // Paramêtres autorisées lors de l'appel au script en ligne de commande |
| protected $parametres_autorises = array( |
| '-n' => array(true, true, 'Nom du fichier ou du dossier à traiter')); |
| public function executer() { |
| // L'obligation de mettre un paramètre -a donnée par le framework |
| // n'a pas de sens, ça ne doit pas être obligatoire !!! |
| $cmd = $this->getParametre('a'); |
| $this->mode_verbeux = $this->getParametre('v'); |
| switch($cmd) { |
| case 'tous' : |
| $this->migrerFormatSmartFlore(); |
| break; |
| default: |
| } |
| } |
| protected function migrerFormatSmartFlore() { |
| $sections = array("Fiche simplifiée Smart'flore", "Introduction","Comment la reconnaître ?","Son histoire","Ses usages","Écologie & habitat","Ce qu'il faut savoir...","Sources"); |
| $nouvelles_sections = array( |
| "Description" => array("Introduction","Comment la reconnaître ?","Son histoire"), |
| "Usages" => array("Ses usages", "Ce qu'il faut savoir..."), |
| "Écologie & habitat" => array("Écologie & habitat"), |
| "Sources" => array("Sources") |
| ); |
| $where_section = 'body NOT LIKE "'; |
| $nouvelles_sections_k = array_keys($nouvelles_sections); |
| foreach($nouvelles_sections_k as $nouvelle_section_k) { |
| // Encore et toujours de l'iso (d'ailleurs si on ne fait pas de conversion la requete se comporte |
| // très bizarrement et renvoie des résultats en trop une fois le script déjà exécuté) |
| $where_section .= '%'.addslashes(ManipulationPage::convertirTexteAppliVersEncodageWiki($nouvelle_section_k)).'%'; |
| } |
| $where_section = $where_section.'"'; |
| $this->wiki = Registre::get('wikiApi'); |
| $requete = 'SELECT * FROM '.$this->wiki->GetConfigValue('table_prefix').'pages WHERE latest = "Y" '. |
| 'AND tag LIKE "SmartFlore%nt%" '. |
| 'AND '.$where_section; |
| $pages = $this->wiki->LoadAll($requete); |
| $pages_fmt = array(); |
| echo "Nombre de pages à migrer : ".count($pages)."\n"; |
| if(!empty($pages)) { |
| $manipulation = new ManipulationPage($this->wiki, $pages[0]); |
| echo "Migration en cours... \n"; |
| foreach($pages as &$page) { |
| $page_fmt = array(); |
| // On capte l'entête de la page situé avant la première section pour le recopier |
| // dans les nouvelles pages (il contient les backlinks et les noms) |
| $delim_entete = strpos($page["body"], "==== Introduction ===="); |
| if($delim_entete === false) { |
| $delim_entete = strpos($page["body"], "====Introduction===="); |
| } |
| // Attention l'entete est en iso, il faut le convertir manuellement |
| $entete = $manipulation->convertirTexteWikiVersEncodageAppli(substr($page["body"], 0, $delim_entete)); |
| // Par contre ici consulterPageSectionsFormatees est gentil et fait la conversion vers l'encodage de l'appli pour nous |
| $manipulation->consulterPageSectionsFormatees($page, implode(',', $sections)); |
| // Fusion des anciennes sections dans les nouvelles |
| foreach($nouvelles_sections as $nom_nouvelle_section => $sections_a_fusionner) { |
| $page_fmt[$nom_nouvelle_section] = '===='.$nom_nouvelle_section.'===='; |
| foreach($sections_a_fusionner as $section_a_fusionner) { |
| if(isset($page['sections'][$section_a_fusionner])) { |
| $page_fmt[$nom_nouvelle_section] .= $page['sections'][$section_a_fusionner]; |
| } |
| } |
| } |
| $corps = $entete."\n".implode("\n", $page_fmt); |
| $manipulation->ecrirePage($page["tag"], $corps); |
| } |
| } |
| echo "Migration effectuée \n"; |
| // Le exit est là pour empecher l'affichage d'être pollué par les erreurs |
| // dûes à certaines antédiluviennités de wikini |
| exit; |
| } |
| // http://stackoverflow.com/questions/834303/startswith-and-endswith-functions-in-php |
| protected function endsWith($haystack, $needle) { |
| // search forward starting from end minus needle length characters |
| return $needle === "" || (($temp = strlen($haystack) - strlen($needle)) >= 0 && strpos($haystack, $needle, $temp) !== FALSE); |
| } |
| } |
| /branches/v1.0-pithivier/api/scripts |
|---|
| New file |
| Property changes: |
| Added: svn:ignore |
| +framework.php |