escapeshellarg

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

escapeshellargЭкранировать строку для того, чтобы она могла быть использована как аргумент командной строки

Описание

escapeshellarg ( string $arg ) : string

Функция escapeshellarg() добавляет одинарные кавычки вокруг строки и кавычек и экранирует любые существующие одинарные кавычки, позволяя вам передать строку непосредственно в функцию оболочки и рассматривать её как один безопасный аргумент. Эта функция должна использоваться для того, чтобы экранировать отдельные аргументы для функций оболочки, полученные из пользовательского ввода. Экранирование аргумента необходимо в таких функциях оболочки как exec(), system() и оператор "обратный апостроф".

В Windows escapeshellarg() заменяет восклицательный знак, знак процента (позднее связывание переменных) и двойные кавычки на пробелы и добавляет двойные кавычки вокруг строки.

Список параметров

arg

Аргумент, который будет экранирован.

Возвращаемые значения

Экранированная строка.

Примеры

Пример #1 Пример использования escapeshellarg()

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

Список изменений

Версия Описание
5.4.43, 5.5.27, 5.6.11 Восклицательный знак заменяется пробелом.

Смотрите также

  • escapeshellcmd() - Экранировать метасимволы командной строки
  • exec() - Выполнить внешнюю программу
  • popen() - Открывает файловый указатель процесса
  • system() - Выполнить внешнюю программу и отобразить вывод
  • Оператор исполнения