Phalcon 3 - Http\Request

فئة Phalcon \ Http \ Request




phalcon

تنفذ Phalcon\Http\RequestInterface ، Phalcon\Http\RequestInterface Phalcon\Di\InjectionAwareInterface

المصدر على جيثب

يغلف معلومات الطلب للوصول السهل والآمن من وحدات تحكم التطبيق.

كائن الطلب عبارة عن كائن قيمة بسيط يتم تمريره بين الفصول الدراسية وفئات وحدة التحكم. انها حزم بيئة طلب HTTP.

use Phalcon\Http\Request;

$request = new Request();

if ($request->isPost() && $request->isAjax()) {
    echo "Request was made using POST and AJAX";
}

$request->getServer("HTTP_HOST"); // Retrieve SERVER variables
$request->getMethod();            // GET, POST, PUT, DELETE, HEAD, OPTIONS, PATCH, PURGE, TRACE, CONNECT
$request->getLanguages();         // An array of languages the client accepts

أساليب

public getHttpMethodParameterOverride ()

...

public setHttpMethodParameterOverride ( مختلطة $ httpMethodParameterOverride)

...

setDI العامة ( Phalcon\DiInterface $ dependencyInjector)

يضبط حاقن التبعية

getDI العامة ()

إرجاع حاقن التبعية الداخلية

اكتساب الجمهور ([اسم $ مختلط ] ، [فلاتر $ مختلطة ] ، [قيمة افتراضية مختلطة $] ، [ مختلط $ notAllowEmpty] ، [ مختلط $ noRecursive])

الحصول على متغير من $ _REQUEST superglobal apply filters إذا لزم الأمر. إذا لم يتم تحديد معلمات ، فسيتم إرجاع $ _REQUEST superglobal

// Returns value from $_REQUEST["user_email"] without sanitizing
$userEmail = $request->get("user_email");

// Returns value from $_REQUEST["user_email"] with sanitizing
$userEmail = $request->get("user_email", "email");

getPost العامة ([اسم $ مختلط ] ، [فلاتر $ مختلطة ] ، [قيمة افتراضية مختلطة $] ، [ مختلط $ notAllowEmpty] ، [ مختلط $ noRecursive])

الحصول على متغير من مرشحات تطبيق superLlobal $ _POST إذا لزم الأمر في حالة عدم إعطاء أي معلمات يتم إرجاع $_POST superglobal

// Returns value from $_POST["user_email"] without sanitizing
$userEmail = $request->getPost("user_email");

// Returns value from $_POST["user_email"] with sanitizing
$userEmail = $request->getPost("user_email", "email");

getPut العامة ([اسم $ مختلط ] ، [فلاتر $ مختلطة ] ، [قيمة افتراضية مختلطة $] ، [ مختلط $ notAllowEmpty] ، [ مختلط $ noRecursive])

يحصل على متغير من وضع الطلب

// Returns value from $_PUT["user_email"] without sanitizing
$userEmail = $request->getPut("user_email");

// Returns value from $_PUT["user_email"] with sanitizing
$userEmail = $request->getPut("user_email", "email");

getQuery العامة ([اسم $ مختلط ] ، [فلاتر $ مختلطة ] ، [قيمة افتراضية مختلطة $] ، [ مختلط $ notAllowEmpty] ، [ مختلط $ noRecursive])

الحصول على متغير من $ _GET فلاتر تطبيق superglobal إذا لزم الأمر إذا لم يتم إعطاء أي معلمات يتم إرجاع $ _GET superglobal

// Returns value from $_GET["id"] without sanitizing
$id = $request->getQuery("id");

// Returns value from $_GET["id"] with sanitizing
$id = $request->getQuery("id", "int");

// Returns value from $_GET["id"] with a default value
$id = $request->getQuery("id", null, 150);

getHelper النهائي المحمية (مصدر $ array ، [اسم $ مختلط ] ، [فلاتر $ مختلطة ] ، [قيمة افتراضية مختلطة $] ، [ مختلط $ notAllowEmpty] ، [ مختلط $ noRecursive])

مساعد للحصول على بيانات من superglobals ، وتطبيق المرشحات إذا لزم الأمر. إذا لم يتم إعطاء أي معلمات يتم إرجاع superglobal.

getServer عامة (اسم $ مختلط )

الحصول على متغير من $ _SERVER superglobal

عام لديه (اسم $ مختلط )

للتحقق مما إذا كان $ _REQUEST superglobal به فهرسة معينة

public hasPost (اسم $ مختلط )

للتحقق مما إذا كان $ _POST superglobal به فهرسة معينة

hasPut عام (اسم $ مختلط )

التحقق مما إذا كانت بيانات PUT لديها فهرس معين

عام hasQuery (اسم $ مختلط )

التحقق مما إذا كان $ _GET superglobal به فهرس معين

hasServer النهائي العام (اسم $ مختلطة )

التحقق مما إذا كان $ _SERVER superglobal به فهرسة معينة

final getHeader العامة (رأس $ مختلط )

الحصول على رأس HTTP من بيانات الطلب

getScheme العامة ()

يحصل على مخطط HTTP (http / https)

public isAjax ()

التحقق مما إذا كان الطلب قد تم إجراؤه باستخدام ajax

public isSoap ()

للتحقق مما إذا كان الطلب قد تم باستخدام SOAP

public isSoapRequested ()

الاسم المستعار من isSoap (). سيتم إيقافه في الإصدارات المستقبلية

الجمهور isSecure ()

للتحقق مما إذا كان الطلب قد تم باستخدام أي طبقة آمنة

public isSecureRequest ()

الاسم المستعار من isSecure (). سيتم إيقافه في الإصدارات المستقبلية

public getRawBody ()

يحصل على نص طلب HTTP الأساسي

public getJsonRawBody ([مجموعة مختلطة من الدولارات ])

يحصل على فك شفرة طلب JSON HTTP raw

public getServerAddress ()

يحصل على عنوان الخادم النشط IP

public getServerName ()

يحصل على اسم الخادم النشط

public getHttpHost ()

يحصل على اسم المضيف المستخدم من قبل الطلب. Request :: getHttpHost تحاول العثور على اسم المضيف بالترتيب التالي: - $ _SERVER [“HTTP_HOST”] - $ _SERVER [“SERVER_NAME”] - $ _SERVER [“SERVER_ADDR”] اختياريا للطلب :: getHttpHost يقوم بالتحقق من صحة اسم المضيف وتنظيفه. يمكن استخدام Request :: $ _ strictHostCheck للتحقق من صحة اسم المضيف. ملاحظة: التحقق من الصحة والتنظيف لها تأثير سلبي على الأداء نظرًا لأنها تستخدم التعبيرات العادية.

use Phalcon\Http\Request;

$request = new Request;

$_SERVER["HTTP_HOST"] = "example.com";
$request->getHttpHost(); // example.com

$_SERVER["HTTP_HOST"] = "example.com:8080";
$request->getHttpHost(); // example.com:8080

$request->setStrictHostCheck(true);
$_SERVER["HTTP_HOST"] = "ex=am~ple.com";
$request->getHttpHost(); // UnexpectedValueException

$_SERVER["HTTP_HOST"] = "ExAmPlE.com";
$request->getHttpHost(); // example.com

setStrictHostCheck العام ([علامة $ مختلطة ])

يتم تعيينه إذا كان يجب استخدام الأسلوب Request :: getHttpHost التحقق من صحة اسم المضيف أم لا

public isStrictHostCheck ()

التحقق مما إذا كان الأسلوب Request :: getHttpHost سيتم استخدام التحقق من صحة اسم المضيف أم لا

getPort العامة ()

الحصول على معلومات حول المنفذ الذي تم إجراء الطلب عليه.

النهائي العام getURI ()

الحصول على HTTP URI الذي تم تقديم الطلب

getClientAddress العامة ([trust $ trustForwardedHeader])

الحصول على معظم عناوين IPv4 للعميل. تبحث هذه الطريقة في $ _SERVER [“REMOTE_ADDR”] واختياريا في $ _SERVER [“HTTP_X_FORWARDED_FOR”]

final getMethod العامة ()

الحصول على طريقة HTTP التي تم طلبها إذا تم تحديد عنوان X-HTTP-Method-Override ، وإذا كانت الطريقة POST ، فسيتم استخدامها لتحديد أسلوب HTTP المقصود "الحقيقي". يمكن أيضًا استخدام معلمة الطلب _method لتحديد أسلوب HTTP ، ولكن فقط إذا تم استدعاء setHttpMethodParameterOverride (صواب). الطريقة هي دائما سلسلة كبيرة.

public getUserAgent ()

الحصول على وكيل مستخدم HTTP المستخدم لإجراء الطلب

public isValidHttpMethod (طريقة مختلطة $)

يتم التحقق مما إذا كانت الطريقة هي طريقة HTTP صالحة

public isMethod (طرق $ مختلطة ، [ مختلطة $ صارمة])

تحقق مما إذا كانت طريقة HTTP تتطابق مع أي من الطرق التي تم تمريرها عندما يكون الصارم صحيحًا ، يتم التحقق مما إذا كانت الطرق التي تم التحقق منها هي أساليب HTTP حقيقية

العام هو ()

للتحقق ما إذا كانت طريقة HTTP هي POST. إذا كان _SERVER ["REQUEST_METHOD"] === "POST"

public isGet ()

للتحقق ما إذا كان أسلوب HTTP هو GET. إذا كان _SERVER ["REQUEST_METHOD"] === "GET"

الجمهور isPut ()

للتحقق ما إذا كانت طريقة HTTP PUT. إذا كان _SERVER ["REQUEST_METHOD"] === "PUT"

public isatch ()

للتحقق ما إذا كانت طريقة HTTP هي PATCH. إذا كان _SERVER ["REQUEST_METHOD"] === "PATCH"

الجمهور isHead ()

للتحقق ما إذا كان أسلوب HTTP هو الرأس. إذا كان _SERVER ["REQUEST_METHOD"] === "HEAD"

الجمهور هو حذف ()

للتحقق ما إذا كان أسلوب HTTP هو DELETE. إذا كان _SERVER ["REQUEST_METHOD"] === "DELETE"

الجمهور isOptions ()

للتحقق ما إذا كانت طريقة HTTP هي OPTIONS. إذا كان _SERVER ["REQUEST_METHOD"] === "OPTIONS"

العامة isPurge ()

للتحقق ما إذا كانت طريقة HTTP هي PURGE (دعم الحبار والورنيش). إذا كان _SERVER ["REQUEST_METHOD"] === "PURGE"

public isTrace ()

للتحقق ما إذا كانت طريقة HTTP هي TRACE. إذا كان _SERVER ["REQUEST_METHOD"] === "TRACE"

عامة isConnect ()

للتحقق ما إذا كانت طريقة HTTP هي CONNECT. إذا كان _SERVER ["REQUEST_METHOD"] === "CONNECT"

public hasFiles ([ مختلط $ only ناجحة])

للتحقق ما إذا كان الطلب يشمل الملفات المرفقة

الحماية النهائية hasFileHelper (بيانات $ مختلطة ، مختلطة $ onlysuccessful)

يحسب بشكل متكرر الملف في صفيف من الملفات

public getUploadedFiles ([ مختلط $ onlySuccessful])

يحصل الملفات المرفقة باسم مثيلات Phalcon \ Http \ Request \ File

الحماية النهائية finalFiles ( مجموعة من أسماء $ ، صفيف $ types ، array $ tmp_names ، صفيف أحجام $ ، أخطاء $ array ، اختلاف $ prefix)

اخرج $ _FILES لتكوين صفيف عادي مع كل الملفات التي تم تحميلها

رؤساء الدعاية العامة ()

لعرض الرؤوس المتاحة في الطلب

$_SERVER = [
    "PHP_AUTH_USER" => "phalcon",
    "PHP_AUTH_PW"   => "secret",
];

$headers = $request->getHeaders();

echo $headers["Authorization"]; // Basic cGhhbGNvbjpzZWNyZXQ=

public getHTTPReferer ()

الحصول على صفحة ويب تشير إلى الطلب النشط. على سبيل المثال: http://www.google.com

الحماية النهائية _getBestQuality ( صفيف $ qualityParts ، $ $ مختلطة )

تعامل مع عنوان طلب وأرجع العنوان بأفضل جودة

public getContentType ()

الحصول على نوع المحتوى الذي تم تقديم الطلب

public getAcceptableContent ()

الحصول على صفيف يحتوي على mime / types وجودة مقبولة من المستعرض / العميل من _SERVER [“HTTP_ACCEPT”]

public getBestAccept ()

الحصول على أفضل تمثيل / نوع مقبول من المستعرض / العميل من _SERVER [“HTTP_ACCEPT”]

public getClientCharsets ()

الحصول على مصفوفة charsets والجودة المقبولة بواسطة المتصفح / العميل من _SERVER [“HTTP_ACCEPT_CHARSET”]

العامة getBestCharset ()

الحصول على أفضل حرف مقبول من المستعرض / العميل من _SERVER ["HTTP_ACCEPT_CHARSET"]

getLanguages العامة ()

الحصول على مجموعة من اللغات وجودة مقبولة من المستعرض / العميل من _SERVER ["HTTP_ACCEPT_LANGUAGE"]

public getBestLanguage ()

الحصول على أفضل لغة مقبولة من المستعرض / العميل من _SERVER ["HTTP_ACCEPT_LANGUAGE"]

public getBasicAuth ()

الحصول على معلومات المصادقة التي يقبلها المتصفح / العميل من $ _SERVER [“PHP_AUTH_USER”]

public getDigestAuth ()

الحصول على معلومات المصادقة التي يقبلها المتصفح / العميل من $ _SERVER [“PHP_AUTH_DIGEST”]

الحماية النهائية _getQualityHeader ( مختلطة $ serverIndex ، مختلطة $ اسم)

معالجة عنوان طلب وإرجاع صفيف من القيم مع الصفات الخاصة بهم