Différences avec les autres SAPIs

Les différences les plus notables entre le CLI SAPI et les SAPI sont :

• Contrairement au CGI SAPI, aucun en-tête HTTP n'est écrit dans le résultat.

  Bien que le CGI SAPI fournisse un moyen de supprimer les en-têtes HTTP, il n'est pas possible d'activer les en-têtes HTTP dans le CLI SAPI.

  CLI est lancé en mode silencieux par défaut, bien que les options -q et --no-header soient gardées pour rester compatible avec les anciennes versions CGI.

  Il ne change pas le répertoire courant en celui du script. (les options -C et --no-chdir sont gardées par souci de compatibilité)

  Messages d'erreurs en texte brut (pas de formatage HTML).

• Il y a plusieurs directives du php.ini qui sont redéfinies par le CLI SAPI, car elles n'ont pas de sens en environnement shell :

  Directives php.ini redéfinies

  Directive	Valeur par défaut pour CLI SAPI	Commentaire
  html_errors	false	Par défaut à false, vu qu'il peut être bien difficile de lire des messages d'erreur sur un terminal lorsqu'ils sont noyés dans des balises HTML non-interprétées.
  implicit_flush	true	Dans un terminal, il est généralement souhaitable que tout affichage en provenance de print, echo et autres, soit immédiatement affiché, et non pas placé dans un buffer quelconque. Néanmoins, il est toujours possible d'utiliser la bufferisation de sortie pour retarder un affichage, ou bien en manipuler le contenu une dernière fois.
  max_execution_time	0 (sans limite)	PHP dans un terminal est susceptible d'être utilisé pour des tâches bien plus diverses que dans des scripts web, et vu que cela prend généralement beaucoup de temps, ce paramètre sera défini par défaut à 0 permettant ainsi d'être illimité.
  register_argc_argv	true	La définition à true de cette directive signifie que les scripts exécutés via le SAPI CLI auront toujours accès à argc (représentant le nombre d'arguments passés à l'application) et argv (le tableau contenant les arguments passés). Les variables PHP $argc et $argv sont automatiquement définies et remplies avec les valeurs appropriées, lors de l'utilisation du SAPI CLI. Ces valeurs peuvent également être trouvées dans la variable $_SERVER, par exemple : $_SERVER['argv']. Avertissement La présence de $argv ou $_SERVER['argv'] n'est pas une indication fiable qu'un script est exécuté depuis la ligne de commande, car ces variables peuvent être définies dans d'autres contextes lorsque register_argc_argv est activé. La valeur retournée par php_sapi_name() devrait être vérifiée à la place. <?php if (php_sapi_name() === 'cli') { echo "Ce script est exécuté depuis la ligne de commande !\n"; } Avertissement Cette fonctionnalité est OBSOLÈTE à partir de PHP 8.5.0. Dépendre de cette fonctionnalité est fortement déconseillé.
  output_buffering	false	Même si cette configuration INI est codée en dur à false, les fonctions relatives à l'affichage du buffer sont disponibles.
  max_input_time	false	Le PHP CLI ne supporte pas GET, POST et le téléchargement de fichiers.

  Note:

  Ces directives ne peuvent pas être initialisées avec d'autres valeurs dans le fichier php.ini ou par une autre méthode. C'est une limitation, car ces valeurs par défaut s'appliquent une fois que tous les autres fichiers de configuration ont été analysés. Cependant, ces valeurs peuvent être modifiées durant l'exécution (ce qui n'est pas logique pour certaines directives, comme register_argc_argv).

  Note:

  Il est recommandé de définir ignore_user_abort pour les scripts en ligne de commande. Voir la fonction ignore_user_abort() pour plus d'informations.

• Pour faciliter le travail en environnement shell, plusieurs constantes sont définies pour les flux I/O.

• Le CLI SAPI ne transforme pas le dossier courant en dossier d'exécution du script.

  Exemple #1 Exemple montrant la différence avec le SAPI CGI :

  <?php
// Un test simple : affiche le dossier d'exécution
echo getcwd(), "\n";
?>

  Lors de l'utilisation de la version CGI, l'affichage sera :

  $ pwd
  /tmp
  
  $ php -q autre_dossier/test.php
  /tmp/autre_dossier
  

  Cela montre clairement que PHP modifie le dossier courant, et utilise le dossier du script exécuté.

  En utilisant le CLI SAPI, on obtient :

  $ pwd
  /tmp
  
  $ php -f autre_dossier/test.php
  /tmp
  

  Cela donne beaucoup plus de souplesse lors de la rédaction de scripts shell avec PHP.

  Note:

  Le CGI SAPI se comporte de la même façon que le CLI SAPI, en lui passant l'option -C, lorsqu'il est invoqué en ligne de commande.