Discussion :

[saad.hessane]

Bonjour tout le monde,
J'étudie plusieurs CMS tel que Joomla ou Wordpress, pour m'en inspirer et apprendre à bien coder en PHP.
Une technique qui est récurrente et que je ne comprend pas, c'est d'utiliser la fonction dirname(__FILE__) avant d'inclure tout script.
Par exemple :

Code PHP :

Sélectionner tout - Visualiser dans une fenêtre à part

require_once( dirname(__FILE__) . '/script.php' );

Pourquoi ne font-ils pas seulement :

Code PHP :

Sélectionner tout - Visualiser dans une fenêtre à part

require_once( './script.php' );

Y a t-il une morale derrière?
Merci

[Thes32]

dirname permet au code d'être plus portable étant donné qu'il s'appuie sur le système pour faire les bonnes transformations des chemins étant donner qu'il existe parfois certaines différences des plateformes. Exemple les chemins windows utilises "\" comme séparateur dossier-fichier tandis sur les systèmes basés sur unix/linux c'est plutôt "/".

[julp]

Sauf que justement, PHP, comme d'autres langages scriptés, accepte / pour Windows comme *n*x.

Avec dirname(__FILE__) on se base sur le chemin du script lui-même (celui qui est entrain d'être exécuté).

Avec './script.php', ce n'est pas du tout la même chose : script.php est cherché dans le répertoire courant.

Prenez cet exemple : soit un programme composé de deux scripts /var/www/offline/jobs/balayette.php et /var/www/offline/libs/db.php (que le premier doit inclure).
Il est appelé de la sorte :

Code X :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
# pwd
/home/julp
# php /var/www/offline/jobs/balayette.php

Si /var/www/offline/jobs/balayette.php contient :

• require_once('../libs/db.php') : ça ne fonctionnera pas car PHP va chercher /home/julp/../libs/db.php (donc /home/libs/db.php) puisque le chemin est relatif au répertoire courant
• require_once(realpath(dirname(__FILE__) . '../libs/db.php')) : ça marchera dans tous les cas, puisqu'on ne dépend pas du répertoire courant

Mais en contexte web, le répertoire courant est modifié pour celui du script de départ (un équivalent de chdir(dirname(__FILE__))). Ce qui facilite les choses et explique que vos deux écritures soient, au final, équivalentes.

La méthode portable est de se baser sur dirname(__FILE__) : elle fonctionne également en CLI et en contexte web. On peut être tenté d'utiliser $_SERVER['DOCUMENT_ROOT'] en contexte web mais celle-ci peut donner une valeur qui ne correspond pas à ce qu'on attend (dans les cas notamment où l'on fait intervenir un Alias, le module Userdir ou encore un VirtualDocumentRoot pour rendre accessible son site).

[saad.hessane]

Merci pour vos réponses. Résolu