This component provides an abstraction over HTTP. It has several services that simplify sending and receiving data via HTTP.
\Krystal\Http\RequestThis service is available in controllers as request property.
\Krystal\Http\Request::isIntended()Tells whether request has been made either via POST or GET request. Returns boolean value. It's called isIntended() because most web application only do use POST and GET requests.
\Krystal\Http\Request::getMetaCsrfToken()Returns CSRF token if present in headers. If not, then null is returned.
\Krystal\Http\Request::hasMetaCsrfToken()Determines whether CSRF token is present in request headers. Returns boolean.
\Krystal\Http\Request::getCookieBag()Returns an instance of CookieBag. It has its own dedicated documentation below.
\Krystal\Http\Request::getAll($separate = true)Returns all request data, including files if they present. If its $separate argument is true, then it will create two standalone keys; one for data, another for files. Otherwise it will merge request and files.
\Krystal\Http\Request::buildQuery(array $params, $includeCurrent = true)Builds a raw query string. The first $params argument is a pair itself. And the second $includeCurrent defines whether to merge current query data with provided params or not.
\Krystal\Http\Request::getFiles($name = null)Returns an array of FileEnity objects. Each file entity object has the following methods, that provide basic data about the uploaded file itself:
getUniqueName() - return unique file name.
getType() - returns guessed Mime-Type.
getName() - returns a base name.
getTmpName() - returns a path to a temporary uploaded file.
getError() - returns error code
getSize() - returns file size in bytes
If the first argument is null, then it returns all files that have been sent by a user. If you want to filter by specific field name, you can provide that name as the argument.
\Krystal\Http\Request::hasFiles($name = null)Determines whether at least one file has been sent by a user. If $name isn't null then it will reduce checking to particular input file by its name.
\Krystal\Http\Request::serialize($data)Builds raw query string based on pairs
\Krystal\Http\Request::unserialize($string)Turns back serialized string into an array.
\Krystal\Http\Request::getCurrentURL()Returns current URL.
\Krystal\Http\Request::getClientIP($proxy = false)Returns IP of the current user. The first $proxy argument tells whether to rely on proxy or not.
\Krystal\Http\Request::getRootDir()Returns root directory path.
\Krystal\Http\Request::getHost()Returns current host name.
\Krystal\Http\Request::getServerIP()Returns server's IP current script runs on.
\Krystal\Http\Request::getMethod()Returns method type the request has been made with.
\Krystal\Http\Request::getSubdomains()Returns current sub-domains, if present
\Krystal\Http\Request::getDomain()Returns current domain
\Krystal\Http\Request::getLanguages()Returns all languages supported by a browser.
\Krystal\Http\Request::getLanguage()Returns default browser's language.
\Krystal\Http\Request::getTimestamp()Returns UNIX timestamp when the request has been made.
\Krystal\Http\Request::getServerPort()Returns server post, the script runs on.
\Krystal\Http\Request::getBaseUrl()Returns base URL.
\Krystal\Http\Request::getRemotePort()Returns server port.
\Krystal\Http\Request::isRedirected()Determines whether request has been redirected internally. You can use this method to determine whether is has been redirected by mod_rewrite or not.
\Krystal\Http\Request::getScriptLocation()Returns the path to the current script.
\Krystal\Http\Request::isSecure()Returns boolean value, that indicates whether request has been done via secure protocol (i.e via HTTPS).
\Krystal\Http\Request::getScheme()Returns current protocol scheme. Can be either HTTP or HTTPS.
\Krystal\Http\Request::getURI()Returns URI from the query.
\Krystal\Http\Request::isXHR()Determines whether request has been done via AJAX. Returns boolean.
\Krystal\Http\Request::isFlash()Determines whether request has been done from flash script. Returns boolean.
\Krystal\Http\Request::isCLI()Determines whether request has been done from a command line.
\Krystal\Http\Request::hasQueryVals($filter = null)Determines whether query string contains at least one non-empty value. Optionally can be filtered by a group, in case query string has nested arrays.
\Krystal\Http\Request::hasQueryNs($ns, $key)Determines whether query's nested array, has a particular key. The first argument is a name of an array, and the second $key is a name of the target key. Returns boolean.
\Krystal\Http\Request::getQueryNs($ns, $key, $default)Returns a value from a nested query's array. The first argument is a name of nested array, the second is a target key, and the third a default value to be returned in case a target key doesn't exist.
\Krystal\Http\Request::getWithNsQuery($ns, $data, $mark = true)Returns merged data with current query data. The first $ns argument is a name of nested query array, the second $data is a custom array, and the third optional $mark defines whether to append questing mark to the target result. Returns a query string.
\Krystal\Http\Request::getWithQuery($data, $mark = true)Just like as previous getWithNsQuery() does the same, but without assumption about nested array.
\Krystal\Http\Request::hasQuery()Determines whether query parameter exists, This method is variadic. That means you can supply as many argument as you need, like hasQuery('foo', 'bar', 'bar'). If no arguments supplied, then it would check the whole query data.
\Krystal\Http\Request::hasPost()Determines whether POST parameter exists. This method is variadic as well. That means you can supply as many argument as you need, like hasPost('foo', 'bar', 'bar'). If no arguments supplied, then it would check the whole POST data.
\Krystal\Http\Request::getPost($key, $default = null)Returns a value from POST request associated with a target key. If no arguments provided, then the whole POST array is returned.
\Krystal\Http\Request::getQuery($key, $default = null)Returns a value from GET request associated a target key. If no arguments provided, then the whole GET array is returned.
\Krystal\Http\Request::isAjaxPost()Determines whether request has been made via POST and has AJAX headers. Return boolean.
\Krystal\Http\Request::isAjaxGet()Determines whether request has been made via GET and has AJAX headers. Return boolean.
\Krystal\Http\Request::isAjax()That's just an alias to isXhr().
Here's a list of methods, that detect the type of the request:
isPost()
isGet()
isOptions()
isPropFind()
isHead()
isPut()
isDelete()
isTrace()
isConnect()
isPatch()As you might already guessed, they all return boolean value.