Les fonctions System sont appelées comme les autres fonctions.
<?php
if (!System::rm('-r file1 dir1')) {
print "Could not delete all the files";
}
?>
Les arguments des fonctions peuvent être introduits en tant que chaînes de caractères ou tableau :
<?php
System::rm(array('-r', 'file1', 'dir1'));
?>
Les fonctions systèmes fonctionnent comme toutes les autres fonctions PHP et retourneront FALSE lorsque l'opération n'aura pas pû être exécutée complètement. Les fonctions systèmes ne s'arrêteront pas lorsqu'une erreur surviendra et tentera de continuer. Par exemple, si vous tentez d'effacer trois fichiers et que le premier ne peut être effacé, les deux suivants seront effacés mais la fonction retournera FALSE.
Les erreurs seront affichées en utilisant la fonction PHP trigger_error()() et donc, les méthodes systèmes peuvent devenir silencieuses en préfixant l'appel de la fonction avec le signe '@' (par exemple : @System::mkdir('-p dir1/dir2/dir3');).
La classe Systemfournit les fonctions systèmes sur les fichiers. Elles sont nommées comme les commandes du système de fichiers sur les systèmes Unix et supportent les mêmes options indépendamment de votre système d'exploitation.
Actuellement, ces fonctions sont testées sous Linux et Windows. Tout retour sur la compatibilité sur les autres systèmes est le bienvenue.
Dans les versions antérieures à PHP 4, la fonction unlink() peut échouer sous Windows. Ce bogue est déjà résolu dans les dernières versions.
Ce manuel décrit les paramètres des fonctions System, la plupart du tant de façon assez concis. Les arguments et les options spécifiques d'une commande ne sont pas documentés dans ce manuel. Reportez-vous aux pages Man sous les systèmes Unix :
ou lorsque les pages Man ne sont pas disponibles sous votre système, visitez les pages de la documentation UNIX en ligne.