Français
Français
Dans le développement de PHP, le chargement des bibliothèques tierces est une tâche courante. Afin de permettre à des bibliothèques externes d'être correctement introduites et utilisées, nous devons généralement définir le chemin d'inclusion (y compris_path) de PHP. La fonction set_include_path () est l'un des outils utilisés pour définir ou modifier ce chemin. Cet article vous présentera comment utiliser correctement la fonction SET_INCLUDE_PATH () et partager quelques conseils pratiques pour vous aider à charger des bibliothèques tierces plus efficacement.
Tout d'abord, comprenons l'utilisation de base de set_include_path () . Cette fonction est utilisée pour définir le chemin d'inclusion de PHP, c'est-à-dire spécifier un ou plusieurs répertoires dans lesquels PHP recherchera les fichiers référencés par inclure ou exiger des instructions.
grammaire:
<span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$path</span></span><span>);
</span></span>Le paramètre $ chemin est le chemin d'inclusion qui doit être défini. Il peut s'agir d'un chemin vers un répertoire ou plusieurs chemins séparés par path_separator (semi-colon ";" sous Windows et Colon ":" sous Unix / Linux).
Utilisez la fonction set_include_path () pour définir de manière flexible plusieurs chemins de répertoire, permettant à PHP de trouver des fichiers sous ces chemins. Par exemple:
<span><span><span class="hljs-comment">// Path inclus par réglage</span></span><span>
</span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-string">'/path/to/your/library'</span></span><span> . PATH_SEPARATOR . </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>());
</span></span>Dans cet exemple, set_include_path () ajoute le répertoire / path / to / votre / bibliothèque à l' inclut_path existant. Le chemin d'inclusion actuel peut être obtenu via la fonction get_include_path () , garantissant que nous ajoutons un nouveau répertoire sans supprimer le chemin existant.
Pendant le développement, vous pouvez rencontrer des situations où vous devez utiliser des chemins relatifs pour charger des fichiers de bibliothèque. Vous pouvez utiliser les fonctions set_include_path () et dirname () pour définir des chemins relatifs.
<span><span><span class="hljs-comment">// Définir les chemins relatifs</span></span><span>
</span><span><span class="hljs-title function_ invoke__">set_include_path</span></span><span>(</span><span><span class="hljs-title function_ invoke__">dirname</span></span><span>(</span><span><span class="hljs-keyword">__FILE__</span></span><span>) . </span><span><span class="hljs-string">'/libs'</span></span><span> . PATH_SEPARATOR . </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>());
</span></span>Ici, Dirname (__ File__) reviendra au répertoire où se trouve le script actuel, et / Libs est le dossier où nous stockons des bibliothèques tierces. Cela garantit que peu importe où le script est exécuté, il peut être chargé correctement à la bibliothèque tierce.
Une fois le chemin d'inclusion défini, PHP recherchera des fichiers dans l'ordre des chemins que vous avez spécifiés. Supposons que nous ayons un fichier de bibliothèque tiers nommé MyLibrary.php , situé dans le répertoire / path / vers / votre / bibliothèque , et le code à charger est le suivant:
<span><span><span class="hljs-comment">// Présentation des bibliothèques tierces</span></span><span>
</span><span><span class="hljs-keyword">include_once</span></span><span>(</span><span><span class="hljs-string">'MyLibrary.php'</span></span><span>);
</span><span><span class="hljs-comment">// Utilisez des cours dans la bibliothèque</span></span><span>
</span><span><span class="hljs-variable">$library</span></span><span> = </span><span><span class="hljs-keyword">new</span></span><span> </span><span><span class="hljs-title class_">MyLibrary</span></span><span>();
</span><span><span class="hljs-variable">$library</span></span><span>-></span><span><span class="hljs-title function_ invoke__">doSomething</span></span><span>();
</span></span>Étant donné que nous avons défini les chemins d'inclusion via set_include_path () , PHP consultera automatiquement le fichier myLibrary.php dans ces chemins sans écrire le chemin complet.
Lorsque le débogage inclut les chemins, utilisez la fonction get_include_path () pour afficher les paramètres de chemin actuels. Cela est très utile pour s'assurer que le chemin est correct.
<span><span><span class="hljs-comment">// Sortie le courant Inclut le chemin</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-title function_ invoke__">get_include_path</span></span><span>();
</span></span>En sortant le chemin actuel, vous pouvez clairement voir la liste des répertoires que PHP recherche. S'il y a un problème, vous pouvez trouver la raison en vérifiant les paramètres du chemin.
L'ordre de chemin est important : les chemins définis par set_include_path () seront recherchés dans l'ordre. Si l'ordre du répertoire est incorrect, certains fichiers de bibliothèque peuvent ne pas se charger correctement.
Évitez d'écraser le chemin par défaut : ne pas facilement écraser la valeur par défaut de PHP inclut_path , sinon cela peut affecter le chargement d'autres fichiers système. Au lieu de le remplacer complètement, vous pouvez obtenir le chemin actuel via get_include_path () et ajouter le nouveau chemin.
Utilisez des chemins absolus : essayez d'utiliser des chemins absolus pour éviter les erreurs causées par des chemins relatifs. Bien que les chemins relatifs soient plus pratiques dans certains cas, les chemins absolus peuvent réduire les problèmes causés par les problèmes de chemin.
Utilisez ini_set () pour modifier temporairement include_path : si vous souhaitez modifier l'inclusion_path uniquement pendant l'exécution du script actuel, vous pouvez utiliser ini_set () pour le définir dynamiquement:
<span><span><span class="hljs-title function_ invoke__">ini_set</span></span><span>(</span><span><span class="hljs-string">'include_path'</span></span><span>, </span><span><span class="hljs-string">'/path/to/your/library'</span></span><span>);
</span></span>Le chemin défini de cette manière n'est valable que pour le script actuel et n'affectera pas d'autres scripts une fois le script terminé.
Bien que set_include_path () soit un moyen efficace de charger des bibliothèques tierces, plus de développeurs PHP ont aujourd'hui tendance à utiliser le compositeur pour gérer les bibliothèques et les dépendances. Composer fournit une fonction Autoloader, ce qui ne permet plus de définir manuellement le chemin inclus. Installez simplement la bibliothèque via Composer et il définira automatiquement le chemin d'accès à vous et générera le fichier AutoLoad approprié.
<span><span>composer require vendor/package-name
</span></span>Ensuite, dans votre fichier PHP, importez simplement le fichier Autoload du compositeur:
<span><span><span class="hljs-keyword">require_once</span></span><span> </span><span><span class="hljs-string">'vendor/autoload.php'</span></span><span>;
</span></span>Le compositeur charge automatiquement toutes les dépendances requises, en évitant la cumbersomeness de la configuration manuelle des chemins.
L'utilisation de la fonction set_include_path () pour charger des bibliothèques tierces est toujours une astuce très utile dans certains cas. En définissant raisonnablement le chemin, nous pouvons nous assurer que PHP peut charger correctement les fichiers de bibliothèque et réduire les problèmes de débogage causés par les erreurs de chemin. Cependant, avec la popularité des outils de développement de PHP modernes, l'utilisation du compositeur pour charger automatiquement les bibliothèques est devenue un moyen plus efficace et recommandé. Si vous n'avez pas essayé Composer, il est fortement recommandé de l'apprendre et de l'utiliser, ce qui peut vous éviter beaucoup de problèmes avec la configuration manuelle.
