Mastering Relative Chemins: La puissance de __dir__ et __file__

Dir et les fichiers sont des constantes magiques en PHP qui peuvent résoudre efficacement les erreurs d'inclusion de fichiers causées par des chemins relatifs dans des projets complexes. 1. Le fichier renvoie le chemin complet du fichier actuel et __dir__ renvoie son répertoire; 2. Utilisez DIR pour vous assurer que l'inclusion ou l'exigence est toujours exécuté par rapport au fichier actuel pour éviter les erreurs de chemin en raison de différents scripts d'appel; 3. Il peut être utilisé pour inclure de manière fiable des fichiers, tels que require_once dir. '/../config.php'; 4. Définissez les constantes Base_DIR dans le fichier d'entrée pour unifier la gestion du chemin du projet; 5. Chargez des fichiers de configuration en toute sécurité, tels que $ config = nécessitent dir. '/config/database.php'; 6. Localisez le répertoire de fichiers de classe avec précision lors de l'enregistrement de l'autoader; 7. Utilisez le fichier pour le débogage et la journalisation, tels que error_log ("Erreur dans le fichier:". __File__); En résumé, l'utilisation rationnelle de ces deux constantes peut améliorer la portabilité, la maintenabilité et la stabilité de l'application.

L'utilisation de __DIR__ et __FILE__ peut ressembler à de petits détails en PHP, mais ce sont des outils puissants pour créer des applications portables fiables, en particulier lorsqu'ils traitent de l'inclusion des fichiers et de la navigation de répertoire. La clé réside dans la compréhension de la façon dont les chemins relatifs peuvent se briser à mesure que votre projet se développe et comment ces constantes magiques vous aident à éviter ces pièges.

Que sont __DIR__ et __FILE__ ?

Ce sont des constantes magiques de PHP - des valeurs intégrées spéciales qui changent selon leur utilisation.

• __FILE__ : Renvoie le chemin complet du fichier PHP actuel, y compris le nom de fichier.

  • Exemple: /var/www/project/includes/config.php

• __DIR__ : Renvoie le répertoire du fichier actuel (essentiellement dirname(__FILE__) ).

  • Exemple: /var/www/project/includes

Ils sont résolus au moment de la compilation , ils sont donc rapides et fiables. Contrairement aux chemins relatifs comme ../includes/config.php , ils pointent toujours vers l'emplacement correct, quelle que soit la façon dont le script a été appelé.

Pourquoi les chemins relatifs échouent sans eux

Imaginez que vous avez une structure de script comme ceci:

 projet/
├fiques index.php
├fiques
│ └fique
└til inclut /
    └fiques aux aides.php

Supposons maintenant que helpers.php sont inclus dans index.php et dashboard.php . Si vous utilisez un chemin relatif à l'intérieur helpers.php comme:

 inclure «database.php»;

Il recherchera database.php par rapport à l'endroit où se trouve le script d'appel - pas où vit helpers.php . Donc:

• From index.php : regarde dans project/
• From dashboard.php : regarde dans project/admin/

Cette incohérence provoque des erreurs. Le correctif? Utiliser __DIR__ :

 Inclure __dir__. '/database.php';

Maintenant, il semble toujours dans le dossier includes/ - extrêmement là où vous vous attendez.

Utilisations pratiques de __DIR__ et __FILE__

1. Inclusions de fichiers fiables

Utilisez toujours __DIR__ lors de l'inclusion de fichiers par rapport au fichier actuel:

 require_once __dir__. '/../config.php';
require_once __dir__. «/ vendeur/autoload.php»;

Cela rend votre code portable. Peu importe la profondeur de la pile d'exécution, les chemins restent précis.

2. Définition des constantes d'application

Définissez un chemin de base pour votre application en utilisant __DIR__ dans votre point d'entrée (comme index.php ):

 Définir ('base_dir', __dir__. '/');

Ensuite, utilisez BASE_DIR tout au long de votre application:

 nécessitent une base_dir. «inclut / functions.php»;

Cela centralise la logique de chemin et évite les répétitions ../ grimper.

3. Renvoi de données à partir de fichiers (par exemple, fichiers config)

Il est courant d'avoir des fichiers de configuration qui renvoient les données:

 // config / database.php
Retour [
    'host' => 'localhost',
    'name' => 'myapp'
]]

Pour le charger en toute sécurité de n'importe où:

 $ config = require __dir__. '/config/database.php';

Encore une fois, __DIR__ garantit que vous chargez du bon endroit.

4. Enregistrement des autoloadeurs

Lorsque vous configurez PSR-4 ou Autoloaders personnalisés, utilisez __DIR__ pour localiser votre src/ ou classes/ dossier:

 spl_autoload_register (fonction ($ class) {
    $ base_dir = __dir__. '/ src /';
    $ file = $ base_dir. str_replace ('\\', '/', $ class). '.php';
    if (file_exists ($ file)) {
        exiger un fichier $;
    }
});

Cela fait fonctionner votre autoloader, peu importe où il est invoqué.

Bonus: __FILE__ pour le débogage et la journalisation

__FILE__ est utile lorsque vous devez vous connecter ou afficher où quelque chose s'est produit:

 error_log ("Erreur dans le fichier:". __file__);

Ou dans les aides de débogage:

 Echo "En cours d'exécution:". __DÉPOSER__;

Il est également utilisé dans les plugins ou les thèmes (comme dans WordPress) pour obtenir le chemin du plugin actuel:

 Plugin_dir_path (__ File__) // Exemple WordPress

Fondamentalement, __DIR__ et __FILE__ éliminent les suppositions. Ils rendent vos chemins de fichier prévisibles, votre application plus maintenable et le déploiement plus fluide. Une fois que vous commencez à utiliser __DIR__ cohérente pour les inclusions locales, vous cesserez de vous soucier de «Dans quel niveau suis-je?» - et c'est le vrai pouvoir.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!