2012-02-12 20:20:30 +04:00
|
|
|
<?php
|
|
|
|
/**
|
2015-03-26 13:44:34 +03:00
|
|
|
* @author Bart Visscher <bartv@thisnet.nl>
|
|
|
|
* @author Jörn Friedrich Dreyer <jfd@butonic.de>
|
|
|
|
* @author Lukas Reschke <lukas@owncloud.com>
|
|
|
|
* @author Morris Jobke <hey@morrisjobke.de>
|
|
|
|
* @author Robin McCorkell <rmccorkell@karoshi.org.uk>
|
|
|
|
* @author Thomas Müller <thomas.mueller@tmit.eu>
|
|
|
|
* @author Vincent Petry <pvince81@owncloud.com>
|
|
|
|
*
|
|
|
|
* @copyright Copyright (c) 2015, ownCloud, Inc.
|
|
|
|
* @license AGPL-3.0
|
|
|
|
*
|
|
|
|
* This code is free software: you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU Affero General Public License, version 3,
|
|
|
|
* as published by the Free Software Foundation.
|
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful,
|
|
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
* GNU Affero General Public License for more details.
|
|
|
|
*
|
|
|
|
* You should have received a copy of the GNU Affero General Public License, version 3,
|
|
|
|
* along with this program. If not, see <http://www.gnu.org/licenses/>
|
|
|
|
*
|
2012-02-12 20:20:30 +04:00
|
|
|
*/
|
2015-02-26 13:37:37 +03:00
|
|
|
|
2012-02-12 20:20:30 +04:00
|
|
|
class OC_Response {
|
2012-02-12 23:38:06 +04:00
|
|
|
const STATUS_FOUND = 304;
|
2012-02-12 20:20:30 +04:00
|
|
|
const STATUS_NOT_MODIFIED = 304;
|
2012-02-12 23:38:06 +04:00
|
|
|
const STATUS_TEMPORARY_REDIRECT = 307;
|
2014-05-04 17:51:08 +04:00
|
|
|
const STATUS_BAD_REQUEST = 400;
|
2012-02-14 02:35:33 +04:00
|
|
|
const STATUS_NOT_FOUND = 404;
|
2013-06-10 15:45:19 +04:00
|
|
|
const STATUS_INTERNAL_SERVER_ERROR = 500;
|
2014-03-14 16:58:34 +04:00
|
|
|
const STATUS_SERVICE_UNAVAILABLE = 503;
|
2012-02-12 20:20:30 +04:00
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* Enable response caching by sending correct HTTP headers
|
2014-02-06 19:30:58 +04:00
|
|
|
* @param integer $cache_time time to cache the response
|
2012-02-18 00:33:39 +04:00
|
|
|
* >0 cache time in seconds
|
|
|
|
* 0 and <0 enable default browser caching
|
|
|
|
* null cache indefinitly
|
|
|
|
*/
|
2012-02-14 01:37:27 +04:00
|
|
|
static public function enableCaching($cache_time = null) {
|
|
|
|
if (is_numeric($cache_time)) {
|
|
|
|
header('Pragma: public');// enable caching in IE
|
|
|
|
if ($cache_time > 0) {
|
|
|
|
self::setExpiresHeader('PT'.$cache_time.'S');
|
|
|
|
header('Cache-Control: max-age='.$cache_time.', must-revalidate');
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
self::setExpiresHeader(0);
|
|
|
|
header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
|
|
|
|
}
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
header('Cache-Control: cache');
|
|
|
|
header('Pragma: cache');
|
|
|
|
}
|
|
|
|
|
2012-02-12 20:20:30 +04:00
|
|
|
}
|
2012-02-18 00:33:39 +04:00
|
|
|
|
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* disable browser caching
|
2012-02-18 00:33:39 +04:00
|
|
|
* @see enableCaching with cache_time = 0
|
|
|
|
*/
|
2012-02-14 02:48:05 +04:00
|
|
|
static public function disableCaching() {
|
|
|
|
self::enableCaching(0);
|
|
|
|
}
|
2012-02-12 20:20:30 +04:00
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* Set response status
|
2014-04-21 17:44:54 +04:00
|
|
|
* @param int $status a HTTP status code, see also the STATUS constants
|
2012-02-18 00:33:39 +04:00
|
|
|
*/
|
2012-02-12 20:20:30 +04:00
|
|
|
static public function setStatus($status) {
|
2012-02-12 23:38:06 +04:00
|
|
|
$protocol = $_SERVER['SERVER_PROTOCOL'];
|
2012-02-12 20:20:30 +04:00
|
|
|
switch($status) {
|
|
|
|
case self::STATUS_NOT_MODIFIED:
|
|
|
|
$status = $status . ' Not Modified';
|
|
|
|
break;
|
2012-02-12 23:38:06 +04:00
|
|
|
case self::STATUS_TEMPORARY_REDIRECT:
|
|
|
|
if ($protocol == 'HTTP/1.1') {
|
|
|
|
$status = $status . ' Temporary Redirect';
|
|
|
|
break;
|
|
|
|
} else {
|
|
|
|
$status = self::STATUS_FOUND;
|
|
|
|
// fallthrough
|
|
|
|
}
|
|
|
|
case self::STATUS_FOUND;
|
|
|
|
$status = $status . ' Found';
|
|
|
|
break;
|
2012-02-14 02:35:33 +04:00
|
|
|
case self::STATUS_NOT_FOUND;
|
|
|
|
$status = $status . ' Not Found';
|
|
|
|
break;
|
2013-06-10 15:45:19 +04:00
|
|
|
case self::STATUS_INTERNAL_SERVER_ERROR;
|
|
|
|
$status = $status . ' Internal Server Error';
|
|
|
|
break;
|
2014-03-14 16:58:34 +04:00
|
|
|
case self::STATUS_SERVICE_UNAVAILABLE;
|
|
|
|
$status = $status . ' Service Unavailable';
|
|
|
|
break;
|
2012-02-12 20:20:30 +04:00
|
|
|
}
|
2012-02-12 23:38:06 +04:00
|
|
|
header($protocol.' '.$status);
|
|
|
|
}
|
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* Send redirect response
|
2014-02-06 19:30:58 +04:00
|
|
|
* @param string $location to redirect to
|
2012-02-18 00:33:39 +04:00
|
|
|
*/
|
2012-02-12 23:38:06 +04:00
|
|
|
static public function redirect($location) {
|
|
|
|
self::setStatus(self::STATUS_TEMPORARY_REDIRECT);
|
|
|
|
header('Location: '.$location);
|
2012-02-12 20:20:30 +04:00
|
|
|
}
|
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* Set reponse expire time
|
2014-05-12 00:51:30 +04:00
|
|
|
* @param string|DateTime $expires date-time when the response expires
|
2012-02-18 00:33:39 +04:00
|
|
|
* string for DateInterval from now
|
|
|
|
* DateTime object when to expire response
|
|
|
|
*/
|
2012-02-12 23:38:28 +04:00
|
|
|
static public function setExpiresHeader($expires) {
|
|
|
|
if (is_string($expires) && $expires[0] == 'P') {
|
|
|
|
$interval = $expires;
|
|
|
|
$expires = new DateTime('now');
|
2012-02-14 01:35:48 +04:00
|
|
|
$expires->add(new DateInterval($interval));
|
2012-02-12 23:38:28 +04:00
|
|
|
}
|
|
|
|
if ($expires instanceof DateTime) {
|
2012-02-14 01:47:31 +04:00
|
|
|
$expires->setTimezone(new DateTimeZone('GMT'));
|
2012-02-12 23:38:28 +04:00
|
|
|
$expires = $expires->format(DateTime::RFC2822);
|
|
|
|
}
|
2012-02-14 01:35:48 +04:00
|
|
|
header('Expires: '.$expires);
|
2012-02-12 23:38:28 +04:00
|
|
|
}
|
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
|
|
|
* Checks and set ETag header, when the request matches sends a
|
|
|
|
* 'not modified' response
|
2014-05-12 00:51:30 +04:00
|
|
|
* @param string $etag token to use for modification check
|
2012-02-18 00:33:39 +04:00
|
|
|
*/
|
2012-02-12 20:20:30 +04:00
|
|
|
static public function setETagHeader($etag) {
|
|
|
|
if (empty($etag)) {
|
|
|
|
return;
|
|
|
|
}
|
2012-09-07 15:40:30 +04:00
|
|
|
$etag = '"'.$etag.'"';
|
2012-02-12 20:20:30 +04:00
|
|
|
if (isset($_SERVER['HTTP_IF_NONE_MATCH']) &&
|
|
|
|
trim($_SERVER['HTTP_IF_NONE_MATCH']) == $etag) {
|
|
|
|
self::setStatus(self::STATUS_NOT_MODIFIED);
|
|
|
|
exit;
|
|
|
|
}
|
2012-09-07 15:40:30 +04:00
|
|
|
header('ETag: '.$etag);
|
2012-02-12 20:20:30 +04:00
|
|
|
}
|
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
|
|
|
* Checks and set Last-Modified header, when the request matches sends a
|
|
|
|
* 'not modified' response
|
2014-05-12 00:51:30 +04:00
|
|
|
* @param int|DateTime|string $lastModified time when the reponse was last modified
|
2012-02-18 00:33:39 +04:00
|
|
|
*/
|
2012-02-12 20:20:30 +04:00
|
|
|
static public function setLastModifiedHeader($lastModified) {
|
|
|
|
if (empty($lastModified)) {
|
|
|
|
return;
|
|
|
|
}
|
2012-02-14 02:35:33 +04:00
|
|
|
if (is_int($lastModified)) {
|
|
|
|
$lastModified = gmdate(DateTime::RFC2822, $lastModified);
|
|
|
|
}
|
2012-02-12 20:20:30 +04:00
|
|
|
if ($lastModified instanceof DateTime) {
|
|
|
|
$lastModified = $lastModified->format(DateTime::RFC2822);
|
|
|
|
}
|
|
|
|
if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) &&
|
|
|
|
trim($_SERVER['HTTP_IF_MODIFIED_SINCE']) == $lastModified) {
|
|
|
|
self::setStatus(self::STATUS_NOT_MODIFIED);
|
|
|
|
exit;
|
|
|
|
}
|
|
|
|
header('Last-Modified: '.$lastModified);
|
|
|
|
}
|
2012-02-14 02:35:33 +04:00
|
|
|
|
2013-12-10 15:05:39 +04:00
|
|
|
/**
|
|
|
|
* Sets the content disposition header (with possible workarounds)
|
|
|
|
* @param string $filename file name
|
|
|
|
* @param string $type disposition type, either 'attachment' or 'inline'
|
|
|
|
*/
|
|
|
|
static public function setContentDispositionHeader( $filename, $type = 'attachment' ) {
|
2015-02-10 15:02:48 +03:00
|
|
|
if (\OC::$server->getRequest()->isUserAgent(
|
|
|
|
[
|
|
|
|
\OC\AppFramework\Http\Request::USER_AGENT_IE,
|
|
|
|
\OC\AppFramework\Http\Request::USER_AGENT_ANDROID_MOBILE_CHROME,
|
|
|
|
\OC\AppFramework\Http\Request::USER_AGENT_FREEBOX,
|
|
|
|
])) {
|
2013-12-10 15:05:39 +04:00
|
|
|
header( 'Content-Disposition: ' . rawurlencode($type) . '; filename="' . rawurlencode( $filename ) . '"' );
|
|
|
|
} else {
|
|
|
|
header( 'Content-Disposition: ' . rawurlencode($type) . '; filename*=UTF-8\'\'' . rawurlencode( $filename )
|
|
|
|
. '; filename="' . rawurlencode( $filename ) . '"' );
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-02-18 00:33:39 +04:00
|
|
|
/**
|
2014-05-19 19:50:53 +04:00
|
|
|
* Send file as response, checking and setting caching headers
|
2014-02-06 19:30:58 +04:00
|
|
|
* @param string $filepath of file to send
|
2012-02-18 00:33:39 +04:00
|
|
|
*/
|
2012-02-18 00:35:31 +04:00
|
|
|
static public function sendFile($filepath) {
|
2012-02-14 02:35:33 +04:00
|
|
|
$fp = fopen($filepath, 'rb');
|
|
|
|
if ($fp) {
|
|
|
|
self::setLastModifiedHeader(filemtime($filepath));
|
|
|
|
self::setETagHeader(md5_file($filepath));
|
|
|
|
|
|
|
|
header('Content-Length: '.filesize($filepath));
|
|
|
|
fpassthru($fp);
|
|
|
|
}
|
|
|
|
else {
|
|
|
|
self::setStatus(self::STATUS_NOT_FOUND);
|
|
|
|
}
|
|
|
|
}
|
2014-05-12 17:14:01 +04:00
|
|
|
|
2015-02-09 18:30:01 +03:00
|
|
|
/**
|
2014-05-12 17:14:01 +04:00
|
|
|
* This function adds some security related headers to all requests served via base.php
|
|
|
|
* The implementation of this function has to happen here to ensure that all third-party
|
|
|
|
* components (e.g. SabreDAV) also benefit from this headers.
|
|
|
|
*/
|
|
|
|
public static function addSecurityHeaders() {
|
2015-02-09 18:30:01 +03:00
|
|
|
/**
|
|
|
|
* FIXME: Content Security Policy for legacy ownCloud components. This
|
|
|
|
* can be removed once \OCP\AppFramework\Http\Response from the AppFramework
|
|
|
|
* is used everywhere.
|
|
|
|
* @see \OCP\AppFramework\Http\Response::getHeaders
|
|
|
|
*/
|
|
|
|
$policy = 'default-src \'self\'; '
|
2014-05-12 17:14:01 +04:00
|
|
|
. 'script-src \'self\' \'unsafe-eval\'; '
|
|
|
|
. 'style-src \'self\' \'unsafe-inline\'; '
|
|
|
|
. 'frame-src *; '
|
|
|
|
. 'img-src *; '
|
|
|
|
. 'font-src \'self\' data:; '
|
2014-10-30 02:00:40 +03:00
|
|
|
. 'media-src *; '
|
2015-02-09 18:30:01 +03:00
|
|
|
. 'connect-src *';
|
2014-05-12 17:14:01 +04:00
|
|
|
header('Content-Security-Policy:' . $policy);
|
|
|
|
}
|
|
|
|
|
2012-02-12 20:20:30 +04:00
|
|
|
}
|