Documentation

请求环境(Request Environment)

每个 HTTP 请求(通常由浏览器发起),包含了请求参数、HTTP 头信息(包括Cookies)、文件等。Web 应用程序需要解析这些信息,并根据这些信息返回正确的响应给请求者。 请求对象 Phalcon\Http\Request 封装了这些信息,你可以以面向对象的方式访问它。

<?php

use Phalcon\Http\Request;

// Getting a request instance
$request = new Request();

// Check whether the request was made with method POST
if ($request->isPost()) {
    // Check whether the request was made with Ajax
    if ($request->isAjax()) {
        echo "Request was made using POST and AJAX";
    }
}

获取请求参数(Getting Values)

PHP automatically fills the superglobal arrays $_GET and $_POST depending on the type of the request. These arrays contain the values present in forms submitted or the parameters sent via the URL. The variables in the arrays are never sanitized and can contain illegal characters or even malicious code, which can lead to SQL injection or Cross Site Scripting (XSS) attacks.

Phalcon\Http\Request allows you to access the values stored in the $_REQUEST, $_GET and $_POST arrays and sanitize or filter them with the ‘filter’ service, (by default Phalcon\Filter). The following examples offer the same behavior:

<?php

// Gets a variable from the $_REQUEST superglobal
$id = $request->get("id");

// Checks whether $_REQUEST superglobal has certain index
$ret = $request->has("id");

// Manually applying the filter
$filter = new Phalcon\Filter();
$email  = $filter->sanitize($_POST["user_email"], "email");

// Manually applying the filter to the value
$filter = new Phalcon\Filter();
$email  = $filter->sanitize($request->getPost("user_email"), "email");

// Automatically applying the filter
$email = $request->getPost("user_email", "email");

// Setting a default value if the param is null
$email = $request->getPost("user_email", "email", "some@example.com");

// Setting a default value if the param is null without filtering
$email = $request->getPost("user_email", null, "some@example.com");

// Gets variable from the dispatcher
$host = $request->getParam("id");

// Gets a variable from put request
$id = $request->getPut("id");

// Gets variable from $_GET superglobal
$id = $request->getQuery("id");

// Gets variable from $_SERVER superglobal
$host = $request->getServer("HOST");

请求方法(Request Method)

判断请求方法(Check Method)

<?php

// Check if HTTP method match any of the passed methods
$ret = $request->isMethod('POST');

// Checks whether HTTP method is POST. if $_SERVER['REQUEST_METHOD']=='POST'
$ret = $request->isPost();

获取请求方法(Getting Method)

<?php

// Gets HTTP method which request has been made
$id = $request->getMethod();

控制器中访问请求(Accessing the Request from Controllers)

The most common place to access the request environment is in an action of a controller. To access the Phalcon\Http\Request object from a controller you will need to use the $this->request public property of the controller:

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function indexAction()
    {

    }

    public function saveAction()
    {
        // Check if request has made with POST
        if ($this->request->isPost()) {

            // Access POST data
            $customerName = $this->request->getPost("name");
            $customerBorn = $this->request->getPost("born");

        }
    }
}

文件上传(Uploading Files)

Another common task is file uploading. Phalcon\Http\Request offers an object-oriented way to achieve this task:

<?php

use Phalcon\Mvc\Controller;

class PostsController extends Controller
{
    public function uploadAction()
    {
        // Check if the user has uploaded files
        if ($this->request->hasFiles()) {

            // Print the real file names and sizes
            foreach ($this->request->getUploadedFiles() as $file) {

                // Print file details
                echo $file->getName(), " ", $file->getSize(), "\n";

                // Move the file into the application
                $file->moveTo('files/' . $file->getName());
            }
        }
    }
}

Each object returned by Phalcon\Http\Request::getUploadedFiles() is an instance of the Phalcon\Http\Request\File class. Using the $_FILES superglobal array offers the same behavior. Phalcon\Http\Request\File encapsulates only the information related to each file uploaded with the request.

使用头信息(Working with Headers)

As mentioned above, request headers contain useful information that allow us to send the proper response back to the user. The following examples show usages of that information:

<?php

// Get the Http-X-Requested-With header
$requestedWith = $request->getHeader("HTTP_X_REQUESTED_WITH");
if ($requestedWith == "XMLHttpRequest") {
    echo "The request was made with Ajax";
}

// Same as above
if ($request->isAjax()) {
    echo "The request was made with Ajax";
}

// Check the request layer
if ($request->isSecureRequest()) {
    echo "The request was made using a secure layer";
}

// Get the servers's IP address. ie. 192.168.0.100
$ipAddress   = $request->getServerAddress();

// Get the client's IP address ie. 201.245.53.51
$ipAddress   = $request->getClientAddress();

// Get the User Agent (HTTP_USER_AGENT)
$userAgent   = $request->getUserAgent();

// Get the best acceptable content by the browser. ie text/xml
$contentType = $request->getAcceptableContent();

// Get the best charset accepted by the browser. ie. utf-8
$charset     = $request->getBestCharset();

// Get the best language accepted configured in the browser. ie. en-us
$language    = $request->getBestLanguage();