Ce document a pour objectif d'aider toutes les personnes qui rencontrent un problèmes dans la conception, le développement ou la mise en production d'un site web reposant sur php.

Très concrétement il s'agit d'expliciter comment :

La définition du périmétre est l'un des choses les plus importantes, c'est ce qui va permette de déterminer dans quelle direction chercher la solution.

Il convient tout d'abord de savoir dans quel phase du projet on se situe :

Avant de tenter de définir des moyens pour trouver plus vite des solution, un tout petit rappel : toujours essayer de se situer soi-même par rapport à ce que l'on souhaite faire, et par rapport a ce qui existe.

Ainsi, si l'on débute, commencer d'abord par bien regarder les tutoriaux avant d'aller sur un forum...

L'étape de conception est très importante, puisque c'est de la qualité de la conception que va directement découler la compexité du développement. Plus la conception est étudiée, plus le développement sera ensuite simplifié.

Les problèmes de conception sont des questions du type "Comment faire pour" :

La plupart de ces questions trouvent leurs réponse dans les tutoriels des différents sites, ou parfois dans les sites de scripts.

On trouve les tutoriels dans deux genres de sites web :

Ces deux catégories offrent des articles intéressants, souvent de grande qualité, même si les solutions qu'ils proposent peuvent sembler s'opposer.

Très concrétement, pour chercher une réponse a un problème du type :
"Comment génerer des pdf avec php".


1. Aller sur l'un des sites : phpindex, phpinfo ou phpscript, dans le moteur de recherche, saisir : "pdf".
on obtient déjà des résultats intéressants, par exemple :

C'est, pour la requête spécifiée, phpindex qui donne le plus de résultats, mais surtout, qui donne les résultats les plus intéressants. Au passage, phpindex propose de voir l'url a laquelle on accède, par exemple : "http://www.phpindex.com/articles/article...", ce qui permet de savoir quel genre d'information on va trouver.

Ici, on a un article : JDNet: des documents PDF à la volée en PHP de phpindex qui renvoie sur un autre du journal du net qui propose déjà une réponse intéressante.

2. Si rien n'est trouvé de satisfaisant, on peut tenter sa chance du coté des moteurs de recherche internet. Attention, dans la mesure ou l'on sort alors du contexte "php", il va falloir le préciser a chaque fois.

Par exemple, sur google, rechercher : generer des pdf php. On remarque au passage que l'on revient parfois sur des pages de phpinfo ou phpindex.

3. S'il n'y a toujours rien de satisfaisant, il faut alors penser a utiliser les forums php qui existent un peu partout.

Attention avant d'utiliser ce genre de forums :

Evidement, éviter de poser la même question en même temps dans plusieurs forums... et... penser a remercier celui ou celle qui a répondu.

Si au passage on a le temps d'aider quelques personnes, c'est l'idéal.


Enfin, une petite astuce pour chercher rapidement de l'information dans des grandes pages de texte : utiliser le "Ctrl-F" (sous IE PC), qui permet de chercher un mot dans la page courante. On gagne alors un temps précieux si les pages contiennent beaucoup de texte.

Les problèmes au développement sont de plusieurs natures :

La documentation php est l'outil le plus adapté pour rechercher une fonction. Elle est disponible sous deux formes :

La documentation php contient la totalité des fonctions utilisées. Elle est particulierement bien conçue, et permet de résoudre 99% des problèmes de fonctions. A tel point qu'il peut être très intéressant de la lire de temps en temps en prennant une page au hasard, on peut découvrir des fonctions que l'on ne soupçonne pas d'exister.

Enfin, les pages de la documentation renvoient souvent a d'autres fonctions, ne pas hésiter a jeter un oeuil au cas ou, cela peut s'averer utile par la suite.

Pour exemple, voici ce que nous fournit la documentation concernant les pdf : http://www.php.net/manual/fr/ref.pdf.php

Pour conclure, phpindex propose aussi une documentation très intéressante, puisqu'expurgée de pas mal de détails qui rendent la documentation officielle un peu trop volumineuse.

Si l'on ne trouve pas son bonheur, les forums sont souvent d'un grand secourt. Comme dit précédement, lire la charte au préalable, puis demander précisément, par exemple : "Je cherche une fonction pour faire .... j'ai beau chercher dans la documentation php, je n'arrive pas a trouver mon bonheur".

Pour rappel, un algorithme est un genre de "recette" pour répondre a un cas spécifique, on a par exemple des algorithmes de tris, de gestion de données, etc..

C'est typiquement le genre de problèmatique qui nécessite d'avoir recourt a un forum (accessoirement, c'est aussi le genre de question les mieux accueillies, si la réponse n'est pas évidente).

Dans la question, il faut :

Evidement, il est inutile de rappeler qu'il faut toujours rechercher dans le forum si la question n'a pas déjà été posée...

Cela arrive parfois, impossible de trouver pourquoi ce script ne veut pas fonctionner ! On n'obtient qu'un message d'erreur vaguement comprehensible.

Si il y a un message d'erreur, essayer de comprendre ce qu'il peut vouloir dire, même si c'est en anglais, on comprend toujours au moins quelques mots. Les messages d'erreurs php sont composés de la manière suivante :
Le type d'erreur rencontré : Le texte de l'erreur, le fichier contenant l'erreur, la ligne contenant l'erreur.

Par exemple :
Parse error: parse error, expecting `T_VARIABLE' or `'$'' in e:\program files\apache group\apache\htdocs\sms\test.php on line 2

Qui signigie : erreur d'analyse (parse) du script test.php a la ligne 2, "expecting `T_VARIABLE' or `'$''".

Même si l'on ne comprend pas ce que peut vouloir dire "expecting `T_VARIABLE' or `'$''", le premier reflexe doit être d'aller voir ce qui se trouve à la ligne 2 du fichier concerné, puis de regarder la ligne, ainsi que celles qui se trouvent au dessus. Attention, beaucoup d'erreur sont liées a des oublis de ";" en fin de ligne précédent celle indiquée par php, elles provoquent des messages pas toujours très clairs (comme celui ci-dessus).

Si l'erreur n'est pas évidente, on peut utilise les moteurs de recherche des forums, ou les moteurs de recherche internet, en cherchant sur le descriptif de l'erreur, ici "parse error, expecting `T_VARIABLE' or `'$''", voire sur un bout seulement de la chaine : "parse error, expecting".

Enfin, la documentation php est aussi précieuse, toujours en cherchant sur un morceau de la chaine d'erreur renvoyée, car elle indique souvent ce qui peut en être la cause.

Si rien n'y fait, il ne reste plus qu'a aller sur les forums. Attention, les erreurs de syntaxes ne sont que modérement appréciées. Donc, bien le préciser dans le titre, par exemple :

Enfin, dernier soucis du développeur, les scripts qui ne font pas ce que l'on souhaite, sans que l'on puisse comprendre pourquoi ! Le script ne fait rien, ou alors a un comportement totalement erratique.

Dans ce cas, toujours se souvenir d'une chose : "le script ne fait rien d'autre que ce que l'on lui a demandé". L'erreur ne peut provenir que du développeur !

Il faut alors user, voire même abuser des instructions permettant d'y voir plus clair :

Pour ce genre d'erreur, mieux vaut éviter de poster dans un forum sans avoir copieusement ajouté des "echo", "var_dump" et autres fonctions. Si malgrès tout rien n'y fait, poster dans le forum en fournissant un maximum d'indications, et en plaçant le minimum de code possible.

Par exemple :

Dans tous les cas, bannir la formule "Ca ne marche pas : il ne s'affiche rien", qui n'aide pas du tout celui qui veut répondre. Au minimum, placer un "echo "OK"" dans le script qui montre qu'on passe bien a l'intérieur.

Enfin, dernière catégorie de problèmes, ceux qui surviennent tout d'un coup, sur un script qui fonctionnait précédement, ou lors du transfert du site sur une autre machine.

La cause peut être :

Dans le premier cas, il convient de vérifier quelles sont les différences entre les deux machines. Pour cela, rien de tel qu'un phpinfo(), qui permet de visualiser l'ensemble des caractéristiques des machines. Un détail tout simple, comme l'installation d'une nouvelle version de php peut modifier une valeur du php.ini, et provoquer un plantage d'un script (par exemple a cause des "magic-quotes" ou du "register-global").

Souvent, c'est une extension php qui n'est installée que sur l'une des machines, ou qui a été supprimée...

Dans le second cas, le problème est directement lié a la conception du script. L'exemple le plus connu est celui du passage a l'an 2000, avec des dates codées sur 2 chiffres. Si rien n'avait été fait, tous les programmes se seraient subitement arretés le 1er janvier 2000, alors que rien n'était modifié.

Dans tous les cas de scripts qui s'arretent de fonctionner, ou qui ne fonctionnent que sur une machine, il convient d'examiner tout ce qui a pu se produire entre les deux états :

Pour ce genre d'erreur, il faut, quand on doit finalement soumettre le question a un forum, préciser :

Par exemple :

Comme partout ailleurs, bannir le "il ne se passe rien".

La capacité a résoudre rapidement les problèmes réprésente le gains de temps le plus important dans un développement. La seule différence entre le développeur confirmé et le débutant, c'est que le confirmé sait ou chercher quand il rencontre un problème.

C'est ainsi, et uniquement ainsi qu'il parvient a développer beaucoup plus rapidement.

On le voit, lorsque la situation devient inextricable, il faut toujours faire appel aux forums, sans hésiter. Ils fournissent quasiment toujours des solutions, mais seulement si le problème est bien présenté, et si celui qui le pose respecte les règles élémentaires de politesse.