프로퍼티 | 타입 | 설명 | |
---|---|---|---|
$_body | string | callable | Buffer string or callable for response message | |
$_cacheDirectives | array | Holds all the cache directives that will be converted into headers when sending the request | |
$_charset | string | The charset the response body is encoded with | |
$_contentType | string | Content type to send. This can be an 'extension' that will be transformed using the $_mimetypes array or a complete mime-type | |
$_cookies | array | Holds cookies to be sent to the client | |
$_file | Cake\Filesystem\File | File object for file to be read out as response | |
$_fileRange | array | File range. Used for requesting ranges of files. | |
$_headers | array | Buffer list of headers | |
$_mimeTypes | array | Holds type key to mime type mappings for known mime types. | |
$_protocol | string | Protocol header to send to the client | |
$_status | integer | Status code to send to the client | |
$_statusCodes | array | Holds HTTP response statuses |
메소드 | 설명 | |
---|---|---|
__construct ( array $options = [] ) | Constructor | |
__debugInfo ( ) : array | Returns an array that can be used to describe the internal state of this object. | |
__toString ( ) : string | String conversion. Fetches the response body as a string. | |
body ( string | callable | null $content = null ) : string | Buffers the response message to be sent if $content is null the current buffer is returned | |
cache ( string $since, string $time = '+1 day' ) : void | Sets the correct headers to instruct the client to cache the response. | |
charset ( string | null $charset = null ) : string | Sets the response charset if $charset is null the current charset is returned | |
checkNotModified ( Cake\Network\Request $request ) : boolean | Checks whether a response has not been modified according to the 'If-None-Match' (Etags) and 'If-Modified-Since' (last modification date) request headers. If the response is detected to be not modified, it is marked as so accordingly so the client can be informed of that. | |
compress ( ) : boolean | Sets the correct output buffering handler to send a compressed response. Responses will be compressed with zlib, if the extension is available. | |
cookie ( array | null $options = null ) : mixed | Getter/Setter for cookie configs | |
cors ( Cake\Network\Request $request, string | array $allowedDomains = [], string | array $allowedMethods = [], string | array $allowedHeaders = [] ) : Cake\Network\CorsBuilder | Setup access for origin and methods on cross origin requests | |
disableCache ( ) : void | Sets the correct headers to instruct the client to not cache the response | |
download ( string $filename ) : void | Sets the correct headers to instruct the browser to download the response as a file. | |
etag ( string | null $hash = null, boolean $weak = false ) : string | null | Sets the response Etag, Etags are a strong indicative that a response can be cached by a HTTP client. A bad way of generating Etags is creating a hash of the response output, instead generate a unique hash of the unique components that identifies a request, such as a modification time, a resource Id, and anything else you consider it makes it unique. | |
expires ( string | DateTime | null $time = null ) : string | null | Sets the Expires header for the response by taking an expiration time If called with no parameters it will return the current Expires value | |
file ( string $path, array $options = [] ) : void | Setup for display or download the given file. | |
getFile ( ) : Cake\Filesystem\File | null | Get the current file if one exists. | |
getMimeType ( string $alias ) : mixed | Returns the mime type definition for an alias | |
header ( string | array | null $header = null, string | array | null $value = null ) : array | Buffers a header string to be sent Returns the complete list of buffered headers | |
httpCodes ( integer | array | null $code = null ) : mixed | Queries & sets valid HTTP response codes & messages. | |
length ( integer | null $bytes = null ) : integer | null | Sets the Content-Length header for the response If called with no arguments returns the last Content-Length set | |
location ( null | string $url = null ) : string | null | Accessor for the location header. | |
mapType ( string | array $ctype ) : string | array | null | Maps a content-type back to an alias | |
maxAge ( integer | null $seconds = null ) : integer | null | Sets the Cache-Control max-age directive. | |
modified ( string | DateTime | null $time = null ) : string | null | Sets the Last-Modified header for the response by taking a modification time If called with no parameters it will return the current Last-Modified value | |
mustRevalidate ( boolean | null $enable = null ) : boolean | Sets the Cache-Control must-revalidate directive. | |
notModified ( ) : void | Sets the response as Not Modified by removing any body contents setting the status code to "304 Not Modified" and removing all conflicting headers | |
outputCompressed ( ) : boolean | Returns whether the resulting output will be compressed by PHP | |
protocol ( string | null $protocol = null ) : string | Sets the protocol to be used when sending the response. Defaults to HTTP/1.1 If called with no arguments, it will return the current configured protocol | |
send ( ) : void | Sends the complete response to the client including headers and message body. | |
sendHeaders ( ) : void | Sends the HTTP headers and cookies. | |
sharable ( boolean | null $public = null, integer | null $time = null ) : boolean | null | Sets whether a response is eligible to be cached by intermediate proxies This method controls the public or private directive in the Cache-Control header | |
sharedMaxAge ( integer | null $seconds = null ) : integer | null | Sets the Cache-Control s-maxage directive. | |
statusCode ( integer | null $code = null ) : integer | Sets the HTTP status code to be sent if $code is null the current code is returned | |
stop ( integer | string $status ) : void | Stop execution of the current script. Wraps exit() making testing easier. | |
type ( string | null $contentType = null ) : mixed | Sets the response content type. It can be either a file extension which will be mapped internally to a mime-type or a string representing a mime-type if $contentType is null the current content type is returned if $contentType is an associative array, content type definitions will be stored/replaced | |
vary ( string | array | null $cacheVariances = null ) : array | null | Sets the Vary header for the response, if an array is passed, values will be imploded into a comma separated string. If no parameters are passed, then an array with the current Vary header value is returned |
메소드 | 설명 | |
---|---|---|
_clearBuffer ( ) : boolean | Clears the contents of the topmost output buffer and discards them | |
_fileRange ( Cake\Filesystem\File $file, string $httpRange ) : void | Apply a file range to a file and set the end offset. | |
_flushBuffer ( ) : void | Flushes the contents of the output buffer | |
_getUTCDate ( string | integer | DateTime | null $time = null ) : DateTime | Returns a DateTime object initialized at the $time param and using UTC as timezone | |
_isActive ( ) : boolean | Returns true if connection is still active | |
_sendContent ( string | callable $content ) : void | Sends a content string to the client. | |
_sendFile ( Cake\Filesystem\File $file, array $range ) : boolean | Reads out a file, and echos the content to the client. | |
_sendHeader ( string $name, string | null $value = null ) : void | Sends a header to the client. | |
_setCacheControl ( ) : void | Helper method to generate a valid Cache-Control header from the options set in other methods | |
_setContent ( ) : void | Sets the response body to an empty text if the status code is 204 or 304 | |
_setContentType ( ) : void | Formats the Content-Type header based on the configured contentType and charset the charset will only be set in the header if the response is of type text/* | |
_setCookies ( ) : void | Sets the cookies that have been added via Cake\Network\Response::cookie() before any other output is sent to the client. Will set the cookies in the order they have been set. |
public __construct ( array $options = [] ) | ||
$options | array | list of parameters to setup the response. Possible values are: - body: the response text that should be sent to the client - statusCodes: additional allowable response codes - status: the HTTP status code to respond with - type: a complete mime-type string or an extension mapped in this class - charset: the charset for the response body |
public __debugInfo ( ) : array | ||
리턴 | array |
public __toString ( ) : string | ||
리턴 | string |
protected _clearBuffer ( ) : boolean | ||
리턴 | boolean |
protected _fileRange ( Cake\Filesystem\File $file, string $httpRange ) : void | ||
$file | Cake\Filesystem\File | The file to set a range on. |
$httpRange | string | The range to use. |
리턴 | void |
protected _flushBuffer ( ) : void | ||
리턴 | void |
protected _setCacheControl ( ) : void | ||
리턴 | void |
protected _setContent ( ) : void | ||
리턴 | void |
protected _setContentType ( ) : void | ||
리턴 | void |
protected _setCookies ( ) : void | ||
리턴 | void |
public checkNotModified ( Cake\Network\Request $request ) : boolean | ||
$request | Cake\Network\Request | Request object |
리턴 | boolean | Whether the response was marked as not modified or not. |
public cors ( Cake\Network\Request $request, string | array $allowedDomains = [], string | array $allowedMethods = [], string | array $allowedHeaders = [] ) : Cake\Network\CorsBuilder | ||
$request | Cake\Network\Request | Request object |
$allowedDomains | string | array | List of allowed domains, see method description for more details |
$allowedMethods | string | array | List of HTTP verbs allowed |
$allowedHeaders | string | array | List of HTTP headers allowed |
리턴 | Cake\Network\CorsBuilder | A builder object the provides a fluent interface for defining additional CORS headers. |
public disableCache ( ) : void | ||
리턴 | void |
public getMimeType ( string $alias ) : mixed | ||
$alias | string | the content type alias to map |
리턴 | mixed | String mapped mime type or false if $alias is not mapped |
public header ( string | array | null $header = null, string | array | null $value = null ) : array | ||
$header | string | array | null | An array of header strings or a single header string - an associative array of "header name" => "header value" is also accepted - an array of string headers is also accepted |
$value | string | array | null | The header value(s) |
리턴 | array | List of headers to be sent |
public httpCodes ( integer | array | null $code = null ) : mixed | ||
$code | integer | array | null | If $code is an integer, then the corresponding code/message is returned if it exists, null if it does not exist. If $code is an array, then the keys are used as codes and the values as messages to add to the default HTTP codes. The codes must be integers greater than 99 and less than 1000. Keep in mind that the HTTP specification outlines that status codes begin with a digit between 1 and 5, which defines the class of response the client is to expect. Example: httpCodes(404); // returns [404 => 'Not Found'] httpCodes([ 381 => 'Unicorn Moved', 555 => 'Unexpected Minotaur' ]); // sets these new values, and returns true httpCodes([ 0 => 'Nothing Here', -1 => 'Reverse Infinity', 12345 => 'Universal Password', 'Hello' => 'World' ]); // throws an exception due to invalid codes For more on HTTP status codes see: http://www.w3.org/Protocols/rfc2616/rfc2616-sec6.html#sec6.1 |
리턴 | mixed | Associative array of the HTTP codes as keys, and the message strings as values, or null of the given $code does not exist. |
public location ( null | string $url = null ) : string | null | ||
$url | null | string | Either null to get the current location, or a string to set one. |
리턴 | string | null | When setting the location null will be returned. When reading the location a string of the current location header value (if any) will be returned. |
public notModified ( ) : void | ||
리턴 | void |
public outputCompressed ( ) : boolean | ||
리턴 | boolean |
public sharable ( boolean | null $public = null, integer | null $time = null ) : boolean | null | ||
$public | boolean | null | If set to true, the Cache-Control header will be set as public if set to false, the response will be set to private if no value is provided, it will return whether the response is sharable or not |
$time | integer | null | time in seconds after which the response should no longer be considered fresh |
리턴 | boolean | null |
protected array $_cacheDirectives | ||
리턴 | array |
protected string $_charset | ||
리턴 | string |
protected string $_contentType | ||
리턴 | string |
protected File,Cake\Filesystem $_file | ||
리턴 | Cake\Filesystem\File |
protected array $_fileRange | ||
리턴 | array |
protected array $_mimeTypes | ||
리턴 | array |