Path et url : Différence entre versions
| Ligne 49 : | Ligne 49 : | ||
Dans le cas ou la méthode renvoie false, une exception sera toujours levée. | Dans le cas ou la méthode renvoie false, une exception sera toujours levée. | ||
| + | |||
| + | Il faut utiliser cette méthode le moins souvent possible car elle est beaucoup plus lente que la fonction <code>is_writable</code> de php. Pour déterminer si on peut écrire réellement dans répertoire cette méthode effectue des tests de création et de suppression de fichiers et de répertoires. | ||
==== pop() et push() ==== | ==== pop() et push() ==== | ||
| + | |||
| + | <code>pop()</code> permet de retourner le dernier répertoire du chemin, et de raccourcir le chemin d'un élément | ||
| + | |||
| + | <code>push('folder')</code> permet d'ajouter le répertoire <code>folder</code> à la fin du chemin | ||
==== createDir() ==== | ==== createDir() ==== | ||
| + | |||
| + | Cette méthode essai de créer le répertoire sur le disque | ||
==== tostring() ==== | ==== tostring() ==== | ||
| + | Retourne le chemin sous la forme d'une chaîne de caractères | ||
Version du 25 septembre 2009 à 16:45
| |
Cette API est disponible à partir de Ovidentia 7.2.0 |
Sommaire
bab_Path
bab_Path est un objet permettant de manipuler un chemin
Inclure le fichier pour utiliser l'API :
<source lang="php"> include_once $GLOBALS['babInstallPath'].'utilit/path.class.php'; </source>
bab_Path::isAbsolutePath($path)
Tester si un chemin est absolu
Utilisation de l'objet
l'objet bab_Path peut prendre un nombre indéfini de paramètre lors de sa création, il permet de créer un chemin a partir de la chaine de caractère d'un ou plusieurs chemins
exemple :
<source lang="php"> $path = new bab_Path('www/html/ovidentia'); </source>
avec cet autre exemple, on obtendra le même résultat :
<source lang="php"> $path = new bab_Path('www','html/ovidentia'); </source>
isAbsolute()
tester si le chemin de l'objet est absolu, la méthode retourne un booléen.
isFolderWriteable()
Tester de manière très poussée si il est possible d'écrire dans le répertoire.
Cette méthode à été crée afin de palier aux problèmes des installations de PHP sur des plateformes windows avec IIS car dans ce cas la méthode is_writable de php ne fonctionne pas, la méthode retourne un booléen mais aussi deux types d'exceptions :
- Exception : dans le cas ou la demande ne peut être traitée (le répertoire n'existe pas ou il pointe vers un fichier)
- bab_FolderAccessRightsException : quand le problème rencontré concerne les droits d'accès
Dans le cas ou la méthode renvoie false, une exception sera toujours levée.
Il faut utiliser cette méthode le moins souvent possible car elle est beaucoup plus lente que la fonction is_writable de php. Pour déterminer si on peut écrire réellement dans répertoire cette méthode effectue des tests de création et de suppression de fichiers et de répertoires.
pop() et push()
pop() permet de retourner le dernier répertoire du chemin, et de raccourcir le chemin d'un élément
push('folder') permet d'ajouter le répertoire folder à la fin du chemin
createDir()
Cette méthode essai de créer le répertoire sur le disque
tostring()
Retourne le chemin sous la forme d'une chaîne de caractères
bab_url
bab_url est un objet permettant de manipuler une adresse url.
Inclure le fichier pour utiliser l'API :
<source lang="php"> include_once $GLOBALS['babInstallPath'].'utilit/urlincl.php'; </source>