====== Dokuwiki chez free ======

DokuWiki fraichement déployé chez free donne l'**illusion** qu'il fonctionne bien. Et puis, au fur et à mesure qu'on s'en sert, on tombe sur plein de problèmes bizarres et étranges qui font renoncer et passer à un autre produit. **NON**, c'est pas la faute à DokuWiki, et **OUI** on peut **facilement** rendre [[doku>dokuwiki|DokuWiki]] compatible avec les spécificités de PHP chez free grâce à [[:schplurtziel:liberatator|liberatator]].

<note importante>
[[:schplurtziel:liberatator|Liberatator]] rend [[doku>dokuwiki|DokuWiki]] //freeproof// en quelques minutes. Ceci est valable pour toutes les versions de DokuWiki, y compris les versions à venir...

Allez voir la page [[:schplurtziel:liberatator]] et le [[:schplurtziel:liberatator-vidtuto|tuto vidéo]]
</note>

Voici les impacts des problèmes relevés dans [[php-chez-free|cette page]], les solutions trouvées pour réussir à faire fonctionner [[doku>dokuwiki]] chez free. et d'autres trucs et astuces. Je le répète : **Pour appliquer tous ces changements de manière automatique à toutes les versions de dokuwiki, même les versions futures, utiliser le script [[:schplurtziel:liberatator|liberatator]]**. Si vous voulez faire les modifications manuellement, lisez le reste de cette page.

Il est fréquemment fait référence à un fichier ''preload.php'' dans cette documentation. Vous en trouverez une copie ici même.

++++inc/preload.php|
<code php inc/preload.php>
<?php
$freefrdirtrash=$_SERVER['DOCUMENT_ROOT'].'/poubelle';

function myglob( $patt, $drp=0 ) {
	$dir=dirname( $patt );
	$pat=basename( $patt );
	$md=($drp & GLOB_MARK)==GLOB_MARK;
	$reponse=array();
	if (is_dir($dir) && ($d = @opendir($dir))) {
		$gl = array( ',/,', '/\./', '/\*/', '/\?/', '/^/', '/$/', ',/\.\*,', ',^/\^\.\*,'  );
		$re = array( '\\/', '\.',   '.*',   '.',    '/^',  '\$/', '/[^.].*', '/^[^.].*' );
		$newpat=preg_replace( $gl, $re, $pat );
			while (($filename = @readdir($d)) !== false) {
				if( $filename == '.' || $filename == '..' )
					continue;
				if( preg_match( $newpat, $filename )) {
					$reponse[]= $dir . '/' . $filename . (($md && is_dir($dir.'/'.$filename)) ? '/' : '');
				}
		}
	}
	if(($drp & GLOB_NOCHECK)&&count($reponse)==0)
		return array($patt);
	if($drp & GLOB_NOSORT)
		return $reponse;
	sort( $reponse );
	return $reponse;
}

function myrmdir( $d ) {
	global $freefrdirtrash;
	if(!is_dir($d))
		return false;
	$h=opendir($d);
	while(false!==($s=readdir($h))) {
		if( $s != '.' && $s != '..' ) {
			closedir($h);
			return false;
		}
	}
	closedir($h);
	return rename($d, $freefrdirtrash);
}

function myopendir($x, $y=null) {
	if(!is_dir($x)) return false;
	return is_null($y) ? @opendir($x) : @opendir($x,$y);
}

function myumask($x=null) {
	return 022;
}

if(!function_exists('array_fill_keys')) {
	function array_fill_keys($keys, $value = '') {
		return is_array($keys) ?
			array_combine($keys,array_fill(0,count($keys),$value))
			: null;
	}
}

</code>
++++

===== sessions =====

La solution consiste à créer un dossier ''sessions'' à la racine de votre espace web chez free.

===== Versions de php =====
 
Les versions de dokuwiki actuelles (2010-11-07 <<anteater>> et +) fonctionnent avec php 5.

==== solution ====

Créer à la racine de son site un fichier nommé ''.htaccess'' contenant cette ligne
<code>
php 1
</code>

===== Modules PHP manquant =====

Sans openssl, on ne peut pas utiliser le module [[doku>plugin:securelogin]], seulement à moitié gênant. Le gestionnaire de greffon ne peut pas télécharger les greffons depuis certains sites comme github qui sont en HTTPS. De toutes façons, free a bridé un peu plus PHP, qui ne peut plus rien télécharger du tout. Voir [[#Absence de connexion vers l'extérieur]] plus bas dans la page.

Sans TLS, on est contraint d'utiliser seulement la fonction ''mail'' de PHP. pas très gênant en fait. Le module bureaucracy peut tout de même fonctionner presque normalement (sauf qu'il m'envoie des messages tout pourris à moitié en HTML mais sans y mettre les en-têtes nécessaires)

==== solution ====

Décider que c'est un faux problème. On peut toujours installer à la main les greffons dans le répertoire ''lib/plugins'' de DokuWiki. En tout cas ce n'est certainement pas vital, sinon :

  * pour le greffon [[doku>plugin:securelogin]], utiliser une bibliothèque SSL pure php (si cela existe) et l'incorporer au greffon [[doku>plugin:securelogin]].
  * pour le gestionnaire de greffon : le modifier vous même, faire parvenir la solution.

===== glob() =====

Si on regarde le type de ''glob()'' effectué dans dokuwiki, on se rend compte qu'il est très basique. par exemple pour la version <<anteater>> de fin 2010, voilà ce qu'il y à :

<file>
cd dokuwiki-2010-11-07
grep -r  'glob *(' *

inc/pageutils.php:    $files  = glob($dir.$name.'.*');
lib/images/fileicons/index.php:foreach (glob('*.png') as $img) {
lib/images/fileicons/index.php:foreach (glob('*.png') as $img) {
lib/plugins/config/settings/extra.class.php:      $authtypes = glob(DOKU_INC.'inc/auth/*.class.php');

</file>

et pour la version rc2011-05-08 “Rincewind RC2”, des trucs à peine plus compliqués

<cli>
grumpf [3934] 10:56:15 (0) tmp $ grep -nr 'glob *(' dokuwiki-rc2011-05-08
dokuwiki-rc2011-05-08/inc/pageutils.php:318:    $files    = glob($basename.'.*', GLOB_MARK);
dokuwiki-rc2011-05-08/lib/images/fileicons/index.php:35:foreach (glob('*.png') as $img) {
dokuwiki-rc2011-05-08/lib/images/fileicons/index.php:43:foreach (glob('*.png') as $img) {
dokuwiki-rc2011-05-08/lib/plugins/config/settings/extra.class.php:48:      $authtypes = glob(DOKU_INC.'inc/auth/*.class.php');
grumpf [3935] 10:57:42 (0) tmp $ 

</cli>

Vu le problème dans ''config/settings/extra.class.php'', DokuWiki sera incapable d'utiliser d'autre mécanismes d'authentification que le mécanisme standard (habituellement, c'est pas franchement gênant)

Dans ''pageutils'', par contre c'est dans une fonction appelée ''metaFiles''. Il faut donc s'attendre à ce que certaines fonctionnalités (que je n'ai pas identifiées) soient défectueuses.
==== solution ====

On pourra donc se contenter de la fonction ''[[php-chez-free#fonction_glob|myglob()]]'' à la main assez simpliste. Il faut la mettre dans le fichier ''inc/preload.php'' chargé par dokuwiki avant tout autre chose. Au besoin, créer le fichier ''inc/preload.php'' s'il n'existe pas.

Après avoir installé le fichier ''preload.php'' avec la fonction ''myglob() '' montrée ci-dessus, il faut appliquer la transformation ''glob'' -> ''myglob'' à tous les fichiers du répertoire dokuwiki concernés.
===== rmdir() =====

Le fait que la fonction ''rmdir()'' ne fonctionne pas a trois (au moins) impacts sur dokuwiki :

  - Le système de verrou basé sur la création -- forcément atomique -- de répertoires vides ne peux plus fonctionner normalement. On peut remplacer dans ''inc/io.php'' la création de répertoire par la création de fichier, et on contourne ainsi le problème. Mais le système de verrou est alors basé sur la création de fichiers et n'est plus atomique. Il est possible, en théorie, qu'un verrou ne soit pas respecté. Sur un wiki fermé avec un seul rédacteur, cela n'est pas gênant, dans tous les autres cas, il y a un problème potentiel. Cela dit, la probabilité pour que deux personnes réussissent à éditer le même document simultanément reste très faible. Le système de verrou basé sur des fichiers n'est pas sûr à 100% mais il s'en approche, et de toutes façons, le risque dépend aussi de l'activité du site...
  - DokuWiki ne peut plus détruire une catégorie (un //namespace//) lorsqu'elle devient vide... ça c'est franchement plus gênant.
  - dokuwiki ne peut pas détruire les dossiers temporaires créés lors de l'installation de nouveau greffons.
  - DokuWiki ne peut pas enlever correctement un greffon dont on ne veut plus
  - L'indexation du site ne fonctionne pas, ou mal
  - certains greffons ne fonctionneront pas ou mal (par exemple [[doku>plugin:cacherevisionseraser]])

Les fichiers atteints

<code>
$ grep -r rmdir * | grep -v -e inc/geshi -e install.php -e inc/preload.php

bin/indexer.php:            @rmdir($lock);
bin/indexer.php:    @rmdir($lock);
inc/io.php:        if(@rmdir($dir)) {
inc/subscription.php:            @rmdir($lock);
inc/subscription.php:    return @rmdir($lockf);
lib/exe/indexer.php:            @rmdir($lock);
lib/exe/indexer.php:    @rmdir($lock);
lib/exe/xmlrpc.php:                    @rmdir($lock);
lib/exe/xmlrpc.php:            @rmdir($lock);
lib/plugins/plugin/classes/ap_manage.class.php:            return @rmdir($path);
</code>

Comme on ne peut pas faire fonctionner ce qui est dans ''bin''((pas de shell disponible pour lancer ça et ''``'' ne fonctionne pas chez free)), on ne s'occupe même pas de ''bin/indexer.php''

==== Contournements ====

Le plus simple consiste à remplacer tous les ''rmdir()'' par des ''myrmdir()'' dans tous les fichiers ''.php'' de [[doku>dokuwiki|DokuWiki]] en utilisant [[php-chez-free#fonction_rmdir|cette définition]] de ''myrmdir()''.

Sinon, on peut faire des trucs plus fins, ou bêtement plus compliqués, c'est comme on veut.

  - Pour le fichier ''inc/io.php''
    - fonction ''io_lock''\\ remplacer ''mkdir(lockDir)'' par ''fopen($lockDir, 'x')''. L'option ''"x"'' de fopen équivaut à ''open( ... O_EXCL|O_CREAT)''; ça devrait faire l'affaire.
    - fonction ''io_unlock''\\ remplacer ''rmdir($lodkDir)'' par ''if(is_file($lockDir)) @unlink($lockDir)'';
    - fonction ''io_sweepNS''\\ qui enlève les répertoire des catégories vides. Remplacer ''rmdir'' par ''myrmdir''. à définir dans ''preload.php'' et qui utilise la technique [[php-chez-free#fonction_rmdir|précédemment]] décrite:
  - pour les fichiers ''inc/subscription.php'',\\ ''lib/exe/indexer.php'',\\ ''lib/exe/xmlrpc.php'',\\ il s'agit encore une fois de verrous. On fonctionne comme pour ''io.php'' : verrous basé sur un fichier; modification du code de ces fichiers.
  - ''lib/plugins/plugin/classes/ap_manage.class.php''\\ on dirait bien un vrai ''rmdir'', pas un verrou. Technique du rename vers répertoire poubelle grâce à la fonction ''myrmdir''.

J'ai créé et détruit des catégories, installé et retiré des [[doku>plugins|greffons]], sans rencontrer aucun problème en utilisant les deux techniques. Le plus simple reste le remplacement systématique.

===== opendir() =====

''opendir()'' échoue même avec l'opérateur ''@''. La classe de gestion des greffons (entre autre) tente d'ouvrir des répertoires avec ''@opendir(....)'', et le script foire. Dans certaines situations, dokuwiki ne fonctionne carrément plus. L'interface de gestion de [[doku>|dokuwiki]], entre autre et à tous les coups, ne fonctionne pas.

==== contournement ====

Le plus simple est de remplacer tous les appels à ''opendir'' par un appell à ''myopendir'' dans tous les fichiers ''.php''.

Sinon, comme précédemment, on peut faire au coup par coup. mais c'est plus compliqué. PHP indique avec un beau message d'erreur le nom du fichier qui contient l'erreur et la ligne ou l'erreur s'est produite. Reste alors à modifier le fichier en question...


===== fonction usleep() =====

Cette fonction ne fonctionne absolument pas.Je ne m'en étais même pas rendu compte. Il y a quelques fichiers qui l'utilisent, mais le fait que ça ne fonctionne pas ne semble pas gêner.

===== fonction array_fill_keys() =====

Cette fonction est absente de PHP chez free. Voir [[dokuwiki:php-chez-free#fonction_array_fill_keys|php chez free]] pour les détails. Le greffon [[doku>plugin:translation]] l'utilise, mais c'est l'un des rares. Cette fonction n'est pas utilisée par dokuwiki de base. 

La solution est d'inscrire dans le fichier ''preload.php'' la version en pur PHP que je donne sur [[dokuwiki:php-chez-free#fonction_array_fill_keys|cette page]].

Merci à Damien Gaignon d'avoir signalé le problème et testé la solution.
===== Absence de connexion vers l'extérieur =====

Symptôme :
  * Le gestionnaire de greffons ne peut pas télécharger les modules complémentaires depuis d'autre sites.
  * L'agrégateur interne de flux ATOM et RSS ne peut pas fonctionner : Les syntaxes du genre ''%%{{rss>http://slashdot.org/index.rss 5 author date 1h }}%%'' produisent ce message, pas le flux : \\ Une erreur s'est produite en récupérant ce flux : http://slashdot.org/index.rss
  * Dokuwiki ne peut pas vérifier s'il existe une version  plus récente de lui même.

{{:dokuwiki:doku-chez-free-pas-connexion.png?nolink& |Pas de connexion vers l'extérieur}}
<WRAP clear></WRAP>

Voir [[dokuwiki:php-chez-free|php chez free]] pour les explications semi techniques et les possibilités de déblocage d'URL externe.

++++Informations de debugage de dokuwiki lors du téléchargement d'un greffon|
<file txt journal.txt>
connection pool 0.0041251182556152s
opening connection 0.0041470527648926s

bloink.homelinux.net:80

request 0.02165412902832s

GET /cli.tar.gz HTTP/1.0
Accept-encoding: gzip
Accept: text/xml,application/xml,application/xhtml+xml,text/html,text/plain,image/png,image/jpeg,image/gif,*/*
Accept-Language: en-us
Host: bloink.homelinux.net
User-Agent: Mozilla/4.0 (compatible; DokuWiki HTTP Client; Linux)
Connection: Keep-Alive
Proxy-Authorization: Basic enRydWxwaGNzOnRjbzk5ZnJl
Cookie: 


response headers 0.10430312156677s

HTTP/1.0 403 Forbidden
Server: squid/3.0.STABLE21
Mime-Version: 1.0
Date: Sat, 24 Sep 2011 22:48:47 GMT
Content-Type: text/html
Content-Length: 1163
X-Squid-Error: ERR_ACCESS_DENIED 0
X-Cache: MISS from pageperso.priv.free.fr
Via: 1.0 pageperso.priv.free.fr (squid/3.0.STABLE21)
Connection: close


Object headers 0.10443305969238s

Array
(
    [server] => squid/3.0.STABLE21
    [mime-version] => 1.0
    [date] => Sat, 24 Sep 2011 22:48:47 GMT
    [content-type] => text/html
    [content-length] => 1163
    [x-squid-error] => ERR_ACCESS_DENIED 0
    [x-cache] => MISS from pageperso.priv.free.fr
    [via] => 1.0 pageperso.priv.free.fr (squid/3.0.STABLE21)
    [connection] => close
)

response body 0.10448813438416s

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML><HEAD><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>ERREUR&nbsp;: L'URL demand&eacute;e n'a pu &ecirc;tre charg&eacute;e</TITLE>
<STYLE type="text/css"><!--BODY{background-color:#ffffff;font-family:verdana,sans-serif}PRE{font-family:sans-serif}--></STYLE>
</HEAD><BODY>
<H1>ERREUR</H1>
<H2>L'URL demand&eacute;e n'a pu &ecirc;tre charg&eacute;e</H2>
<HR noshade size="1px">
<P>
En essayant de charger l'URL&nbsp;:
<A HREF="http://bloink.homelinux.net/cli.tar.gz">http://bloink.homelinux.net/cli.tar.gz</A>
<P>
L'erreur suivante a &eacute;t&eacute; rencontr&eacute;e&nbsp;:
<UL>
<LI>
<STRONG>
Acc&egrave;s interdit.
</STRONG>
<P>
La configuration du contr&ocirc;le d'acc&egrave;s interdit &agrave; votre requ&ecirc;te d'&ecirc;tre
accept&eacute;e &agrave; cette heure-ci. Veuillez contacter votre
prestataire de service si vous pensez que ceci n'a pas lieu d'&ecirc;tre.
</UL>
</P>


<br>
<hr>
<div id="footer">
Generated Sat, 24 Sep 2011 22:48:47 GMT by pageperso.priv.free.fr (squid/3.0.STABLE21)
</div>
</body></html>
</file>
++++

==== Contournement ====

Dès que vous êtes frappé par ce problème, il faut installer les greffons manuellement en les téléversant dans le dossier ''lib/plugins/**nom-du-greffon**''.

Le gestionnaire de modules externes peut toujours supprimer les modules.

===== temps d'exécution et mémoire ? =====

D'autre problèmes surviennent sans qu'il soit possible de vraiment savoir... Est-ce que le temps d'exécution d'un script est dépassé, ou bien s'agit-il d'un dépassement de mémoire ?

Le greffon [[http://www.dokuwiki.org/plugin:gallery|gallery]] par exemple ne parvient pas à afficher toutes les miniatures d'un gros //namespace// (365 images de 260 ko chacune env).

De même, en utilisant le même //namespace// que pour le greffon gallery, le greffon imageflow ne charge qu'une partie des images.

Dans les deux cas, les images sont valides.