array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.escapeshellarg.php', 1 => 'escapeshellarg', 2 => 'Maskiert eine Zeichenkette (String), um sie als Shell-Argument benutzen zu können', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Funktionen zur Programmausführung', ), 'prev' => array ( 0 => 'ref.exec.php', 1 => 'Funktionen zur Programmausführung', ), 'next' => array ( 0 => 'function.escapeshellcmd.php', 1 => 'escapeshellcmd', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/exec/functions/escapeshellarg.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

escapeshellarg

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

escapeshellarg — Maskiert eine Zeichenkette (String), um sie als Shell-Argument benutzen zu können

Beschreibung

escapeshellarg(string $arg): string

escapeshellarg() fügt einfache Anführungszeichen um eine Zeichenkette herum ein und maskiert alle existierenden einfachen Anführungszeichen innerhalb der Zeichenkette und ermöglicht es so, die Zeichenkette direkt als Argument an eine Shell-Funktion zu übergeben und sie als einzelnes sicheres Argument zu behandeln. Diese Funktion sollte verwendet werden, um einzelne Argumente aus Benutzereingaben zu maskieren, die an Shell-Funktionen übergeben werden. Zu den Shell-Funktionen zählen unter anderem exec(), system() und der Backtick Operator.

Unter Windows ersetzt escapeshellarg() stattdessen Prozentzeichen, Ausrufezeichen (verzögerte Variablenersetzung) und doppelte Anführungszeichen durch Leerzeichen und schließt die Zeichenkette in doppelte Anführungszeichen ein. Darüber hinaus wird jede Reihe aufeinanderfolgender Backslashes (\) durch einen zusätzlichen Backslash maskiert.

Parameter-Liste

arg

Die zu maskierende Zeichenkette.

Rückgabewerte

Die maskierte Zeichenkette.

Beispiele

Beispiel #1 escapeshellarg()-Beispiel

<?php
system('ls '.escapeshellarg($dir));
?>

Siehe auch