Au final, sur 75 questions, seulement 1/3 m’ont posées problème et après relecture plus que 2 ou 3 sur lesquelles je n’arrivais pas à me prononcer. Cela ne m’a pas empêché de faire des erreurs (j’ai vérifié par la suite) mais je l’ai eu au final

Je fait donc partie des 5 premiers certifiés français !

Librairies obsolètes, besoin particulier, expérimentation ou tout simplement l’envie de créer sa propre extension sont autant de raisons qui peuvent vous amener à vouloir compiler votre propre extension.

Le plus dur, sous Windows, étant de démarrer, voici un petit guide pour vous y aider.

Téléchargement nécessaires

Voici les étapes :

• Installer si ce n’est pas déja fait Visual Studio C++ Express Edition 2008
• Télécharger le pack de librairies pour Windows sur le site d’Edin Kadribašić
• Télécharger PHP en version source et en version binaire sur le site PHP.net
  • Attention : les deux versions devront être de version identique (je le dit … on sait jamais )
  • Attention (bis) : Pour Zend Core, la version binaire doit être une version NTS!
• Une extension existante pour tester la compilation, par exemple win32ps

Voici une arborescence type que je prendrais en référence pour la suite :

Build layout

Pour résumer, un répertoire Build à la racine du lecteur D dans lequel je place trois répertoires :

1. bin/ pour la version binaire de PHP
2. php_build/ extrait du pack de librairies d’Edin Kadribašić
3. src/php-5.2.5 dans lequel je met les sources de PHP et de l’extension à compiler
4. src/win32ps-1.0.1 l’extension à compiler (cf. plus loin)

Configuration de VS C++

La première chose à faire et de configurer les répertoires par défaut de VS C++ pour ajouter les fichiers téléchargés (Outils >> Options, puis  Projets et Solutions >> Répertoires de VC++).

D’autres méthodes sont possibles, comme spécifier dans chaque projet ces chemins, mais cela oblige à le faire pour chaque projet et cela ne vous permet pas de modifier le layout sans avoir à mettre à jour tous vos projets. Personnellement je ne compile que pour PHP donc cela ne me pose pas de problèmes.

Chargement d’un projet existant (win32ps)

Nous allons prendre comme exemple win32ps, qui exporte des fonctions pour lister les processus qui tournent sur votre machine.

Séléctionnez le traditionnel Fichier >> Ouvrir >> Projet/Solution…

Dans le cas de de win32ps et de beaucoup d’extensions PECL vous devrez passez par la conversion du fichier dsp (Visual Studio C++ 6 – L’environnement de compilation utilisé pour PHP, mais payant), ouvrez donc le fichier win32ps.dsp

Configuration du projet

Cliquez-droit sur le nom du projet puis sélectionnez Propriétés. A partir de cette interface vous avez accès à l’ensemble des paramètres de génération du projet.

La première chose à faire et de créer une nouvelle configuration pour notre extension. Une configuration regroupe des paramètres de compilation.

Cliquez sur Gestionnaire de configurations… puis choisissez <Nouveau…>

Habituellement les deux configurations, Release et Debug, sont créées automatiquement pour tout projet Windows. Avec PHP les configuration basique s’appellent Release_TS et Debug_TS (TS pour Thread Safe). Dans notre cas l’extension sera Non-Thread Safe, donnez lui donc le nom de Release.

Première chose à modifier, les directives du préprocesseur. Il faut enlever la directive ZTS (Zend Thread Safe). Ce paramètre défini si PHP sera compilé avec l’option Thread Safe. Sans cette extension l’exécution sera plus rapide mais cela interdit l’utilisation de la librairies avec un programme multi threadés.

Nous devons ensuite Modifier le répertoire de sortie. Par défaut il est situé deux niveaux au dessus car l’extension peut être compilée dans le répertoire ext des sources de PHP ce qui permet d’avoir l’ensemble des extensions au même endroit.

Plus important, il faut préciser la librairie PHP avec laquelle lier notre extension. Il existe deux versions pour php5 : php5ts.lib et php5.lib – je vous laisse deviner la différence!

Modification des sources

Afin de permettre de compiler les extensions existantes vous devrez ajouter la ligne suivante aux sources de votre extension :

Cela permet de définir les constantes nécessaires pour permettre la compilation de l’extension PHP.

Compilation

Vous n’avez plus qu’à compiler l’extension en choisissant Générer >> Générer win32ps

Note : Visual Studio vous proposera de sauver le fichier win32ps.sln qui est le fichier de projet des version récentes de Visual Studio

Quelques warnings (sans conséquences) plus tard vous devez avoir un fichier win32ps.dll dans le répertoire Release de l’extension.

Installation

Mon conseil sera de créer un répértoire build dans le répertoire d’extensions de PHP. Cela vous permettra de différencier les extensions natives de celles que vous aurez compilé.

• Copiez donc le fichier php_win32ps.dll dans le répertoire extensions/build
• Modifiez votre fichier php.ini pour ajouter la ligne :
  • extension=build/php_win32ps.dll
• Et voila ! Votre extension est prête à l’emploi.

Tests

• Vérifiez que votre extension est chargée en utilisant la commande : php -m

• Vous pouvez aussi vérifier le phpinfo à partir de la console Zend Core

Création d’un nouveau projet

Je ne vais pas refaire l’article de TalkPHP, juste quelques précisions :

• Toujours en C (pas d’utilisation de syntaxe C++ + /TC)
• Ne pas utiliser les entêtes pré-compilés (StdAfx.h/StdAfx.c)
• La définition de DllMain est facultative
• Toujours inclure le fichier zend_config.w32.h avant tout autre fichier des sources de PHP (ex: php.h)

Références

• La base de cet article : Creating a PHP Extension for Windows using Microsoft Visual C++ 2008
• Un HOW-TO de Elizabeth Marie Smith
• Le projet perisama qui propose des binaires pré compilés pour les différentes version des compilateurs Microsoft, ainsi qu’une série de slides qui traite des problématiques de compilation sous Windows (un must read !!)

• PHP est configuré avec les valeurs recommandées (sécurité, performances) pas les valeurs par defaut (souvent gardées pour compatibilité)
• Les extensions installées sont certifiée par une QA additonnelle réalisée par les équipes de Zend – important sous Windows : peu monde compile les pré versions sur cette plateforme
• Certains connecteurs (natifs et PDO) sont certifiés par des petits éditeurs qui débutent : Oracle et IBM/DB2
• L’installeur permet d’installer MySQL (évidement !) mais aussi Oracle (Express Edition) et DB2 (Express-c)
• Last but not least : c’est gratuit !

Vu qu’il faut bien gagner sa vie, une offre de support permet de garder PHP à jour à l’aide d’un utilitaire de mise à jour graphique.

Un des inconvénients avec Zend Core cependant, c’est que l’ensemble des extensions disponibles sur le package php.net n’est pas disponible sur Zend Core. Ceci car toutes les extensions n’ont pas étée intégrées au système de QA Zend.

Dans ce cas il ne vous reste plus qu’a trouver un moyen de récupérer l’extension :

• Linux : le moyen les plus fiable et de compiler l’extension, un utilitaire PHP intégré à Zend Core (bin/phpize) permet de préparer une extension à être compilée. Jon Coggeshall à fait un excellent tutoriel sur le sujet.

• Windows : le site de téléchargement de php.net permet de télécharger les extensions pré-compilées pour les versions NTS (Non-Thread-Safe)

Attention cependant : Zend Core embarque une version NTS (Non-Thread-Safe)!

Les releases de php.net pour Windows sont souvent disponibles en version Thread Safe. Ceci car si php est installé en tant que module d’Apache sous Windows le serveur doit pouvoir utiliser des threads (MPM Worker) ce qui est bien plus efficace sous Windows et qu’un paquet TS peux (évidemment?) fonctionner lorsque les threads ne sont pas utilisés (MPM Prefork).

Mais Zend Core prend une autre direction : PHP en tant que processus fast-cgi (pour Apache et IIS).

Ceci à l’avantage de tirer le meilleur d’Apache sur Windows (les threads sont très performants sur cette plateforme) et d’alléger PHP : en effet les routines internes à PHP effectuant la gestion des threads peuvent êtres désactivées (le fameux mode NTS donc).