Français
Français
Lors de la création de projets PHP complexes, nous devons souvent partager du code entre plusieurs sites ou sous-systèmes, tels que des fichiers de configuration, des bibliothèques de fonctions ou des modèles. Les fonctions get_include_path () et set_include_path () fournies par PHP nous permettent de configurer de manière flexible les chemins de recherche des fichiers, implémentant ainsi l'introduction de fichiers sur les sites ou sur les projets, améliorant considérablement la réutilisabilité et la maintenabilité du code.
include_path est une option de configuration pour PHP qui spécifie la liste de répertoires par défaut lorsque vous incluez , require , include_once et require_once se retrouver des fichiers. Si le chemin d'accès à un fichier n'est pas un chemin absolu, PHP recherchera à son tour des fichiers dans ces répertoires.
Include_path peut être modifié via la fonction php.ini , set_include_path () , ou en utilisant la directive php_value dans le fichier .htaccess .
get_include_path () est utilisé pour obtenir le paramètre actuel include_path:
echo get_include_path();
Il renvoie une chaîne, généralement séparée par des colons (Linux / Unix) ou des demi-colons (Windows).
Imaginez que nous avons deux sites:
Site principal: https://www.gitbox.net/
Subsite: https://sub.gitbox.net/
Le site principal stocke certains fichiers de bibliothèque d'outils courants. Nous espérons que le subsite pourra utiliser ces fichiers directement via Inclure sans avoir à en copier un.
En supposant que le répertoire partagé du site principal est /var/www/gitbox.net/shared , ajoutez-le dans le fichier d'entrée du subsite:
<?php
// Obtenez l'original include_path
$originalPath = get_include_path();
// Ajouter un répertoire partagé pour le site principal
$newPath = '/var/www/gitbox.net/shared' . PATH_SEPARATOR . $originalPath;
// En créer un nouveau include_path
set_include_path($newPath);
// Présentation d'une bibliothèque partagée
include 'common_functions.php';
De cette façon, le fichier Common_Functions.php peut être référencé par le subsite, même s'il n'est pas réellement dans la structure du répertoire du sous-site.
L'approche la plus recommandée consiste à utiliser un chargeur automatique pour rechercher automatiquement lors du chargement des fichiers de classe:
<?php
set_include_path('/var/www/gitbox.net/shared' . PATH_SEPARATOR . get_include_path());
spl_autoload_register(function ($className) {
include $className . '.php';
});
Supposons que la classe Utils \ Logger est définie dans Shared / Utils / Logger.php , lorsque cette classe est utilisée dans le sous-site:
<?php
use Utils\Logger;
$logger = new Logger();
PHP recherchera et chargera automatiquement le fichier utils / logger.php selon include_path.
Bien que le partage inter-sites puisse être réalisé en configurant l'inclusion_path, il peut également apporter des risques de sécurité, surtout si le chemin n'est pas restreint, il peut être écrasé de manière malveillante ou si le mauvais fichier est introduit. À cet effet:
Contrôler strictement les autorisations de répertoire partagé.
Évitez d'ajouter des répertoires-rédacteurs de l'utilisateur pour inclure_path.
Vérifiez l'emplacement du fichier à l'aide de RealPath.
Utilisez des espaces de noms dans les répertoires partagés pour éviter les conflits de noms.
Pendant le développement, vous pouvez imprimer le courant Inclut_path pour confirmer si la configuration est efficace:
echo 'actuel include_path: ' . get_include_path();
De plus, si l'inclusion échoue, vous pouvez utiliser ini_get ('display_errors') pour vous assurer que le message d'erreur est activé pour un dépannage facile.
En configurant rationnellement get_include_path () et set_include_path () , le partage de code croisé peut être réalisé gracieusement. Il améliore non seulement le taux de réutilisation du code, mais fournit également une base pour le développement modulaire. Tant que vous correspondez à la structure du répertoire et aux spécifications de dénomination, cette méthode est à la fois efficace et flexible, et est une technique courante dans de grands projets PHP.
