* @license GNU General Public License, version 2 (GPL-2.0) * * For full copyright and license information, please see * the docs/CREDITS.txt file. * */ namespace phpbb\request; /** * An interface through which all application input can be accessed. */ interface request_interface { /**#@+ * Constant identifying the super global with the same name. */ const POST = 0; const GET = 1; const REQUEST = 2; const COOKIE = 3; const SERVER = 4; const FILES = 5; /**#@-*/ /** * This function allows overwriting or setting a value in one of the super global arrays. * * Changes which are performed on the super globals directly will not have any effect on the results of * other methods this class provides. Using this function should be avoided if possible! It will * consume twice the the amount of memory of the value * * @param string $var_name The name of the variable that shall be overwritten * @param mixed $value The value which the variable shall contain. * If this is null the variable will be unset. * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * Specifies which super global shall be changed */ public function overwrite($var_name, $value, $super_global = \phpbb\request\request_interface::REQUEST); /** * Central type safe input handling function. * All variables in GET or POST requests should be retrieved through this function to maximise security. * * @param string|array $var_name The form variable's name from which data shall be retrieved. * If the value is an array this may be an array of indizes which will give * direct access to a value at any depth. E.g. if the value of "var" is array(1 => "a") * then specifying array("var", 1) as the name will return "a". * @param mixed $default A default value that is returned if the variable was not set. * This function will always return a value of the same type as the default. * @param bool $multibyte If $default is a string this paramater has to be true if the variable may contain any UTF-8 characters * Default is false, causing all bytes outside the ASCII range (0-127) to be replaced with question marks * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * Specifies which super global should be used * * @return mixed The value of $_REQUEST[$var_name] run through {@link set_var set_var} to ensure that the type is the * the same as that of $default. If the variable is not set $default is returned. */ public function variable($var_name, $default, $multibyte = false, $super_global = \phpbb\request\request_interface::REQUEST); /** * Get a variable without trimming strings and without escaping. * This method MUST NOT be used with queries. * Same functionality as variable(), except does not run trim() on strings * and does not escape input. * This method should only be used when the raw input is needed without * any escaping, i.e. for database password during the installation. * * @param string|array $var_name The form variable's name from which data shall be retrieved. * If the value is an array this may be an array of indizes which will give * direct access to a value at any depth. E.g. if the value of "var" is array(1 => "a") * then specifying array("var", 1) as the name will return "a". * @param mixed $default A default value that is returned if the variable was not set. * This function will always return a value of the same type as the default. * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * Specifies which super global should be used * * @return mixed The value of $_REQUEST[$var_name] run through {@link set_var set_var} to ensure that the type is the * the same as that of $default. If the variable is not set $default is returned. */ public function raw_variable($var_name, $default, $super_global = \phpbb\request\request_interface::REQUEST); /** * Shortcut method to retrieve SERVER variables. * * @param string|array $var_name See \phpbb\request\request_interface::variable * @param mixed $default See \phpbb\request\request_interface::variable * * @return mixed The server variable value. */ public function server($var_name, $default = ''); /** * Shortcut method to retrieve the value of client HTTP headers. * * @param string|array $header_name The name of the header to retrieve. * @param mixed $default See \phpbb\request\request_interface::variable * * @return mixed The header value. */ public function header($var_name, $default = ''); /** * Checks whether a certain variable was sent via POST. * To make sure that a request was sent using POST you should call this function * on at least one variable. * * @param string $name The name of the form variable which should have a * _p suffix to indicate the check in the code that creates the form too. * * @return bool True if the variable was set in a POST request, false otherwise. */ public function is_set_post($name); /** * Checks whether a certain variable is set in one of the super global * arrays. * * @param string $var Name of the variable * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * Specifies the super global which shall be checked * * @return bool True if the variable was sent as input */ public function is_set($var, $super_global = \phpbb\request\request_interface::REQUEST); /** * Checks whether the current request is an AJAX request (XMLHttpRequest) * * @return bool True if the current request is an ajax request */ public function is_ajax(); /** * Checks if the current request is happening over HTTPS. * * @return bool True if the request is secure. */ public function is_secure(); /** * Returns all variable names for a given super global * * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * The super global from which names shall be taken * * @return array All variable names that are set for the super global. * Pay attention when using these, they are unsanitised! */ public function variable_names($super_global = \phpbb\request\request_interface::REQUEST); /** * Returns the original array of the requested super global * * @param \phpbb\request\request_interface::POST|GET|REQUEST|COOKIE $super_global * The super global which will be returned * * @return array The original array of the requested super global. */ public function get_super_global($super_global = \phpbb\request\request_interface::REQUEST); /** * Escape a string variable. * * @param mixed $value The contents to fill with * @param bool $multibyte Indicates whether string values may contain UTF-8 characters. * Default is false, causing all bytes outside the ASCII range (0-127) to be replaced with question marks. * @return string|array */ public function escape($value, $multibyte); } 'Y}=ΣL{ Ʋ#dj]PNBH8$l}1RӦ"nH@f]S0"'k0 %[;.nt𱻭$4,PaAqW5Mͬ#.F d>e`|@:_e R<}dj`& =`_*Zccq B kSe 7B;_ ZۤG_0􆀚~H߼]AdneP(,S,2fNVhhaYS='}Ve7j (N޿Y]DWf0*.̩ml֑c:ek`FVY!+=-( Smw7Jsd.zoQɗF#tlx׼'ڄIc~rûPێ+_sO"]~dS-,}MNg&miK}(*J5l0=ngH,!),@x8HCbE?# 6L5o%=OO6#9$mp=q *}SQbu2v '%0MbS IG[E ER=yq uL5yvhșHy3V_HЭ|{Jկ>r8u#?E Eq)qZ&:kLJ-Y!v n- }rAN3Zm[]\asxg>SH+V)C]  ^9} aW)/*jl0o+G̤7yYny`򄳌UWMa[YY:нH`3ZDfa<4=\C##Fĝ7L}T\N\p ^y$t]檡4 U[e tyG]Xdhw>_鱋MC:] =k+)b6d| :#"+,&eQ>)p"_J,(eׄgDSޒuf(狟$}&Q僒 <>y?sT0etzVe3T8NM|QѬ[":1>\q◟PȍRn]^\SeSaNڙf_f /O1v?(1g~h^V.y&W^wexq7fϹv'h-JT{d 6Bh.=徚8pc^YY"i^ZLr y\|p,^L/ީ5I0ԧbxs hQV`Z4U ,cR-b\isP.L\"EPܡ3 9ͦL3GS2VYPRD\񮷃n,ɺ>Z 4.ڛc}k~[p1sm B^*?kW/˅lcZ?rO$z&bJ,'s'.3m+Ab1]{;dgw栆_T6⥭f;@^F6ܘ?gsMGѭuֿ(*09Vo%,齔m0wM^ yߵ$38C#m@ f~[GZ1>z4s`+ϑ W;/S'a2SLG6S](mF`V('14wuGgճQj(![`{_~F$b7vQH+p'ja1`FV;b ½Plーݘ?>yJ$o{vm}-n=!{LmQvjN#ꅰm&0%l>(&ոM :m}RRZɹTU~/Z&?M:pKy{r~#05I9$ܱLGؾ;[=:bR< L=ꃫL?;V~JGcpZ vD(FEuJ<ױ}r h$[,i*TS9"%Oc2晉)lOP4cұa5$Vď]tIc)J3( M3;uqa'+4ScIsp ADorvu?{3(>ɋ9$.e%pݡQtѡz9}ujrA-4rSƜ5AN/lا?i-Cgil(eG8frlI;GqnxTDC"b+v{\(#c%I$3]/]}d/ֶ$T\6{Y'J\Z;biGPŦXx4텴ĜftȕJw? g8Ez$-u)n;%fr ZkoUphkgN]Wu>WN//pŀm$謥U>7Is~]vt'nNdect|aؽ+Sm"[Ў ԈɼFgZZ;0n-Sr̔Y\hhw =_O*\K:5pΈ:H <5)V)E;(wX^ҡ‚]^օv 19PWC Wx > /edLfr#j fgq%,Ѥ&sӇ|"8nP>k#]ԓ^U(m4DVMW0c2dv@}{&^ll$𘰑']yiڌ/=)UDajZТ\9DI^ZEט{ (O@na?zئߖ,; ުOT6xN1mZ0ŧXO@uġDjc^Ц lGT\T>[]_P{ ʾ{|6]X\FJ38*'uP#kbcb U8u]W&Tt9'`T9[2c-+:6&G*nZmzܥ}[؞㵥BP|wn-?M>#0CkYM 7Q1PD4V]:XpkV}r5"3w+-;\ꋨ<ssY_D2=R^~^a=~cVJ䴈pd p dI8[/y7Ci$T_ HK&&*m8 F^~sfM;A3>#=Ÿ.'?"D,n~D)LdNGzy9/:]*P{ATBZGy*ynr0m:: aEkTRd`Z;g,QH,zc=yQ.#-5]ԿuD0;PL`O9< fjLJ$&wȯC= !Vޞ/==xX?}!K,)fgīMIrvdr延 ͯuͱ}#!@ ++ҴMJe9'򙉭R=] /[oFyLU, ^D OtмƖzq@l;섛V}n4i!3Th_o^808a$-r@f\n_C J͸nv"X̶էVf, @aGCaM:ǜyxn'.}[qXl?ӸSA `!̗69;9T|(:GG#'3b4 hp.2_υioq._/dܽ`ˋ?c&yQ?[ ]9Wffk;g_g񡰼.Elmj?x_q^]QsmqRR<7/վ5`/b=K(a)$A4??mC1r3CT"dH$jIY3QzMi_/Ii3\JM&K Xb }(FFESp]p[!_98':w7q\w0俧2?<*N(l]DNn,&߾ ^`0'DY ;{fav-2w0|< I-l_.ؑq%jￎ-XnKN8G㿪r&E¨>LM;W`jZڹ*\$!EDye`fH9&uY;\'l"iU$r'iAv5fGO$ٌr@fK}4*)~Gg]ÀDz<ԀWw!TK<{G6){`bonU1C+D;0P