(PHP 4 >= 4.1.0, PHP 5 < 5.4.0)
import_request_variables — Импортирует переменные GET/POST/Cookie в глобальную область видимости
$types
[, string $prefix
] ) : boolИмпортирует переменные GET/POST/Cookie в глобальную область видимости. Это бывает полезно при отключенной директиве register_globals и желании видеть некоторые переменные в глобальной области видимости.
Если необходимо импортировать в глобальную область видимости другие переменные, такие как $_SERVER, воспользуйтесь функцией extract().
Данная функция была объявлена УСТАРЕВШЕЙ, начиная с PHP 5.3.0 и была УДАЛЕНА в PHP 5.4.0.
types
С помощью параметра types
, можно указать,
какие переменные запроса необходимо импортировать.
Можно использовать символы 'G', 'P' и 'C' соответственно
для GET, POST и Cookie. Данные символы не являются
регистрозависимыми, поэтому также можно использовать любую комбинацию из 'g', 'p'
и 'c'. POST включает в себя информацию о загруженных файлах методом POST.
Замечание:
Имейте в виду, что порядок букв имеет значение, т.е. при использовании "GP" переменные POST перезапишут переменные GET с таким же именем. Любые буквы, отличные от GPC, игнорируются.
prefix
Префикс имени переменной, добавляемый перед всеми именами переменных, импортируемых в глобальную область видимости. То есть, если есть переменная GET с именем "userid", и указан префикс "pref_", то результатом будет глобальная переменная с именем $pref_userid.
Замечание:
Несмотря на то, что
prefix
- необязательный параметр, будет вызвана ошибка уровняE_NOTICE
, если префикс не будет указан или будет указана пустая строка в качестве префикса. Это потенциальная брешь в безопасности. Ошибки уровня Notice не отображаются при использовании уровня отображения ошибок по умолчанию.
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
Пример #1 Пример использования import_request_variables()
<?php
// В примере импортируются переменные GET и POST
// с префиксом "rvar_"
import_request_variables("gp", "rvar_");
echo $rvar_foo;
?>