Drupal est une horreur, depuis peu je suis amené à mettre le nez dedans et je déchante complètement. Pas de POO, pas de MVC, tout en base de données..
Pour développer une simple fonction il faut toucher au Php et à la base de données.

En résumé, je n’aime pas!

Comme pour tous les WS avec NuSoap, il faut définir l’objet renvoyer.
Par exemple ici, on va définir un contact comprenant un nom, prenom, site web et un téléphone. Puis on va définir un tableau de contact, le ContactArray

$serveur->wsdl->addComplexType(
   'Contact',
   'complexType',
   'struct',
   'all','',
   array(
      'nom' => array('name' => 'nom', 'type' => 'xsd:string'),
      'prenom' => array('name' => 'prenom', 'type' => 'xsd:string'),
      'web' => array('name' => 'web', 'type' => 'xsd:string'),
      'tel' => array('name' => 'tel', 'type' => 'xsd:int'),
   )
);
 
$serveur->wsdl->addComplexType(
   'ContactArray',
   'complexType',
   'array','',
   'SOAP-ENC:Array',array(),
   array(
      array('ref'=>'SOAP-ENC:arrayType','wsdl:arrayType'=>'tns:Contact[]')
   ),
   'tns:Contact'
);

Puis comme d habitude on définit la méthode du WS.

$serveur->register('getContacts',
                           array(), //pas de paramètre en entré
                           array('Contact' => 'tns:ContactArray')
               );

Donc getContacts retournera un ContactArray. Il ne reste plus qu’à définir getContacts.

function getContacts() { 
$result = array();
	$req="SELECT * FROM `Contacts`";
	$res=mysql_query($req);
	while($obj=mysql_fetch_object($res)) {
		$result[] = array( 'nom' => $obj->nom, 'prenom' => $obj->prenom,'email'=>$obj->email, 'tel'=>$obj->tel);
	}
return $result;
}

Et voilà!

I) Le serveur

<?
include('lib/nusoap.php');
$serveur = new soap_server;
$serveur->register('bonjour');
function bonjour($prenom)
{
return "Bonjour ".$prenom;
}
$serveur->service($HTTP_RAW_POST_DATA);
?>

Ligne 3 : on créer une instance de serveur
Ligne 4 : on enregistre une méthode « bonjour »
Ligne 5 : on défini la méthode « bonjour », cela retourne un texte avec la variable passée.
Ligne 9 : on envoie le résultat.

II) Le client

<?php
require_once('lib/nusoap.php');
$serverpath ='http://url-de-ma-page-serveur';
$param = array('prenom'=>'Jerome');
$client = new soapclient($serverpath);
$result = $client->call('bonjour', $param);
print($client->request);
?>

Ligne 3 : l’url du serveur
Ligne 4 : le tableau des paramètres à passer
Ligne 5 : on créé le client
Ligne 6 : l’appelle à la fonction ‘bonjour’ et les paramètres.
Ligne 7 : on affiche le resultat.

C’est un exemple d’utilisation simple. Il est possible de passer un message soap précis, de forcer le nommage dans le xml etc…
Ca sera pour un prochain tuto

Autre tuto : http://www.jkraft.fr/2010/11/05/php-retourner-un-tableau-avec-nusoap/

Installer Jpeg-6b :

# cd /usr/local/src/
# wget ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz
# tar xzvf jpegsrc.v6b.tar.gz
# cd jpeg-6b
# ./configure --prefixe=/usr
# make && make install

Si ça retourne une erreur, refaire la même chose sans le –prefix

Recompiler php :

# ./configure --with-apxs2=/usr/local/apache2/bin/apxs --enable-dom --with-iconv --enable-mbstring=all --enable-mbregex --with-mysql --with-zlib=/usr --with-jpeg-dir=../jpeg-6b --with-gd
# make clean && Make && make install

Le make clean est important!!!!!

Et voilà , vérifier dans le phpinfo que tout est correctement configuré. Mais on devrait avoir un php avec GD et Jpeg prêt !

I) Installation de FreeBSD

Introduisez le premier CD de FreeBSD.

1. Choisissez la langue, puis le clavier
2. Sélectionnez Begin a standard installation
3. Vous devez choisir le disque dur sur lequel installer FreeBSD (A pour choisir le disque entier, Q pour terminer)
4. Comme je n’installe que ce système je ne met pas de Boot Manager (None)
5. Créez les partitions (A pour la création automatique, Q pour terminer)
6. Choisissez l’installation minimal
7. Sélectionnez l’installation à partir du CD/DVD
8. Continuez l’installation, il va maintenant formater le disque, créer les partitions et installer le système
9. Une fois l’installation terminée, configurez votre carte réseau (Mettez bien un nom d’hôte avec un .com / .fr etc.. )
10. Configurez les services dont vous avez besoin
11. Ajoutez les comptes utilisateurs et votre mot de passe root
12. Vous êtes de nouveau sur le menu. Sélectionnez Configure puis Distributions pour installer les ports et les man-pages. Si vous avez un soucis avec l’installation par CD/DVD changer le média type et passer par une installation FTP.

II) Webmin

En premier on installe webmin. C’est une interface web qui permet d’administrer très facilement le serveur. On va donc utiliser les ports qui est une bibliothèque d’applications et d’utilitaires.

Donc on y va :

# cd /usr/ports/sysutils/webmin
# make install clean


Webmin est automatiquement téléchargé et installé dans : /usr/local/lib/webmin/

On va maintenant le configurer.

# cd /usr/local/lib/webmin/
# ./setup.sh


Validez les infos, et modifiez les pour votre config. Personnellement je laisse tout par défaut, port 10000 et pas de SSL. Entrez le login et mot de passe admin.

Modifiez /etc/rc.conf et ajoutez la ligne webmin_enable= »YES » (vous pouvez utiliser vi pour le modifier)
# echo webmin_enable=\"YES\" >> /etc/rc.conf

Redémarrer et dans votre navigateur aller sur : http://votre-ip:10000

Je n’explique pas comment Webmin fonctionne. C’est assez simple.

III) Wget

On install l’outil Wget qui permet de télécharger via le terminal.

# cd /usr/ports/ftp/wget
# make install clean


IV) Installer MySql 5 Client et Serveur

On utilise encore les ports pour le client

# cd /usr/ports/database/mysql50-client
# make install clean


Pour le serveur, c’est un petit peu plus compliqué

# cd /usr/src/
# wget http://mir2.ovh.net/ftp.mysql.com/Downloads/MySQL-5.0/mysql-5.0.51b.tar.gz

Comme la procédure est un peu longue je ne vais pas la décrire ici. Mais suivez ce tutorial très simple.

http://freed0.developpez.com/mysql/

V) Apache 2 et Php 5

Dans un premier temps il faut installer un pré-requis libxml2

# /usr/ports/textproc/libxml2
# make install clean

Puis GD pour la gestion des images

# /usr/ports/graphics/gd
# make install clean

Il suffit de suivre mon tutorial Compilation Apache 2 et Php 5. Pour la configuration Apache avant la compilation juste mettre –enable-so comme argument.

Et voilà . Votre serveur est prêt à être utilisé. Pour toutes questions : contact@jkraft.fr

Il suffit de faire appeler le script via la commande lynx. Lynx étant un navigateur web textuel. Vous pouvez essayer de taper

#lynx http://www.macfan.fr

Et vous naviguerez en mode texte. Pas très esthétique, mais très pratique si vous voulez exécuter un script. Il vous suffit de rajouter la ligne suivante à  votre fichier de configuration de cron.

0 2 * * * lynx http://url-votresite/script.php

Ce qui aura pour effet d’exécuter votre script tous les jours à 2h du matin. Si vous n’avez pas lynx, la commande wget fonctionne aussi, mais téléchargera le fichier résultat dans un dossier du serveur.

Installation de Curl :

On récupère le package
# wget http://curl.haxx.se/download/curl-7.16.0.tar.gz
On décompresse le fichier
# tar zxvf curl-7.16.0.tar.gz

On configure et on installe
# cd curl-7.16.0
# ./configure --prefix=/usr/loca/curl
# make && make install

Curl est maintenant installé. Il faut recompiler Php avec l’option –with-curl=<dir>

Je vais reprendre les options utilisées dans mon article sur la compilation de Php 5.

Configuration de Php 5

On configure Php 5
# cd /php-5.2.5
# ./configure --with-apxs2=/usr/local/apache2/bin/apxs --enable-dom --with-iconv --enable-mbstring=all --enable-mbregex --with-mysql --with-gd --with-zlib

On le compile et on l’installe
# make && make install

Les fonctions Curl sont maintenant accessibles. Voilà un petit exemple d’utilisation :

<?
// Création d'une nouvelle ressource cURL
$ch = curl_init();
// Configuration de l'URL et d'autres options
curl_setopt($ch, CURLOPT_URL, "http://www.google.fr");
curl_setopt($ch, CURLOPT_HEADER, 0);
// Récupération de l'URL et affichage sur le naviguateur
curl_exec($ch);
// Fermeture de la session cURL
curl_close($ch);
?>

Pour en savoir plus sur Curl, un petit tour sur la doc de Php 5 : http://fr3.php.net/curl

Installer Apache

On récupère les sources :
# wget http://apache.crihan.fr/dist/httpd/httpd-2.2.8.tar.gz

On décompresse puis on configure :
# tar xzvf httpd-2.2.8.tar.gz
# cd httpd-2.2.8

Pour permettre le chargement dynamique de PHP, le serveur Apache doit être compilé avec le support Dynamic Shared Object (DSO). Cette fonctionnalité peut être activée en ajoutant l’option –enable-so :

# ./configure --prefix=/usr/local/apache2 --enable-so

On compile et on installe :

# make && make install

Voilà Apache 2 installé dans le répertoire /usr/local/apache2.

Installer PHP 5

J’ai eu des soucis avec php 5.1.6, je n ai pas réussi à le faire fonctionner avec apache 2.2.8. Je vous conseille donc de prendre la dernière version. A l’heure actuelle c’est la 5.2.5. On récupère donc les sources puis on décompresse l’archive.

# wget http://fr2.php.net/distributions/php-5.2.5.tar.gz

# tar xzvf php-5.2.5.tar.gz
# cd php-5.2.5

L’étape de configuration de PHP est très importante. C’est là que vous allez définir les modules dont vous allez avoir besoin. Voilà un exemple :

# ./configure --with-apxs2=/usr/local/apache2/bin/apxs --enable-dom --with-iconv --enable-mbstring=all --enable-mbregex --with-mysql --with-gd --with-zlib

• L’argument –with-apxs2 indique à PHP où se trouve le répertoire d’installation d’Apache 2 et le script apxs qui gère les extensions.
• L’argument –enable-dom permet d’utiliser l’API DOM de php5 pour utiliser des documents XML.
• L’argument –with-iconv permet de convertir des fichiers vers différent jeux de charactères.
• L’argument –enable-mbstring d’utiliser différent jeux de charactères.
• L’argument –enable-mbregex active les fonctions regex.
• L’argument –with-mysql active l’extension MySQL regular. Dans PHP 5.0, elle n’est pas active par défaut (contrairement à PHP 4.0) et doit être nommée explicitement dans configure pour être activée.
• L’argument –with-gd active les fonctions de manipulation d’images.
• l’argument –with-zlib active la bibliothèque de compression zlib pour la compression de données à la volée.

D’autres options et extensions sont également possibles. Pour obtenir une liste complète, exécutez la commande suivante:

# ./configure --help

Une fois que le script configure a terminé son traitement, vous pouvez compiler et installer PHP.

# make
# make install

Configurer et tester Apache avec PHP

Dernière petite manipulation pour que tout fonctionne, dire à Apache de reconnaitre les fichiers .php et pour cela on va aller ajouter dans le fichier /usr/local/apache2/conf/httpd.conf la ligne suivante :

AddType application/x-httpd-php .php

Enregistrez le fichier, puis démarrez le serveur:

# /usr/local/apache2/bin/apachectl start

Vous pouvez maintenant tester si tout fonctionne. La racine des documents du serveur se trouve la : /usr/local/apache2/htdocs/
Il suffit de créer un fichier PHP avec par exemple le code suivant :

<?php phpinfo(); ?>

Connectez vous sur l’url http://localhost/nom-de-votre-fichier.php et vous devriez voir la page d’informations de PHP.