* @copyright Copyright (c) 2015, 2016 the Pantsu.cat developers * * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ /** * The Response class is a do-it-all for getting responses out in different * formats. * * @todo Create sub-classes to split and extend this god object. */ class Response { /** * Indicates response type used for routing. * * Valid strings are 'csv', 'html', 'json' and 'text'. * * @var string $type Response type */ private $type; /** * Indicates requested response type. * * Valid strings are 'csv', 'html', 'json', 'gyazo' and 'text'. * * @param string|null $response_type Response type */ public function __construct($response_type = null) { switch ($response_type) { case 'csv': header('Content-Type: text/csv; charset=UTF-8'); $this->type = $response_type; break; case 'html': header('Content-Type: text/html; charset=UTF-8'); $this->type = $response_type; break; case 'json': header('Content-Type: application/json; charset=UTF-8'); $this->type = $response_type; break; case 'gyazo': // Deprecated API since version 2.0.0, fallback to similar text API header('Content-Type: text/plain; charset=UTF-8'); $this->type = 'text'; break; case 'text': header('Content-Type: text/plain; charset=UTF-8'); $this->type = $response_type; break; default: header('Content-Type: application/json; charset=UTF-8'); $this->type = 'json'; $this->error(400, 'Invalid response type. Valid options are: csv, html, json, text.'); break; } } /** * Routes error messages depending on response type. * * @param int $code HTTP status code number. * @param int $desc Descriptive error message. * @return void */ public function error($code, $desc) { $response = null; switch ($this->type) { case 'csv': $response = $this->csv_error($desc); break; case 'html': $response = $this->html_error($code, $desc); break; case 'json': $response = $this->json_error($code, $desc); break; case 'text': $response = $this->text_error($code, $desc); break; } http_response_code(500); // "500 Internal Server Error" echo $response; } /** * Routes success messages depending on response type. * * @param mixed[] $files * @return void */ public function send($files) { $response = null; switch ($this->type) { case 'csv': $response = $this->csv_success($files); break; case 'html': $response = $this->html_success($files); break; case 'json': $response = $this->json_success($files); break; case 'text': $response = $this->text_success($files); break; } http_response_code(200); // "200 OK". Success. echo $response; } /** * Indicates with CSV body the request was invalid. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param int $description Descriptive error message. * @return string Error message in CSV format. */ private static function csv_error($description) { return '"error"'."\r\n"."\"$description\""."\r\n"; } /** * Indicates with CSV body the request was successful. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param mixed[] $files * @return string Success message in CSV format. */ private static function csv_success($files) { $result = '"name","url","hash","size"'."\r\n"; foreach ($files as $file) { $result .= '"'.$file['name'].'"'.','. '"'.$file['url'].'"'.','. '"'.$file['hash'].'"'.','. '"'.$file['size'].'"'."\r\n"; } return $result; } /** * Indicates with HTML body the request was invalid. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param int $code HTTP status code number. * @param int $description Descriptive error message. * @return string Error message in HTML format. */ private static function html_error($code, $description) { return '

ERROR: ('.$code.') '.$description.'

'; } /** * Indicates with HTML body the request was successful. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param mixed[] $files * @return string Success message in HTML format. */ private static function html_success($files) { $result = ''; foreach ($files as $file) { $result .= ''.$file['url'].'
'; } return $result; } /** * Indicates with JSON body the request was invalid. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param int $code HTTP status code number. * @param int $description Descriptive error message. * @return string Error message in pretty-printed JSON format. */ private static function json_error($code, $description) { return json_encode(array( 'success' => false, 'errorcode' => $code, 'description' => $description, ), JSON_PRETTY_PRINT); } /** * Indicates with JSON body the request was successful. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param mixed[] $files * @return string Success message in pretty-printed JSON format. */ private static function json_success($files) { return json_encode(array( 'success' => true, 'files' => $files, ), JSON_PRETTY_PRINT); } /** * Indicates with plain text body the request was invalid. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param int $code HTTP status code number. * @param int $description Descriptive error message. * @return string Error message in plain text format. */ private static function text_error($code, $description) { return 'ERROR: ('.$code.') '.$description; } /** * Indicates with plain text body the request was successful. * * @deprecated 2.1.0 Will be renamed to camelCase format. * @param mixed[] $files * @return string Success message in plain text format. */ private static function text_success($files) { $result = ''; foreach ($files as $file) { $result .= $file['url']."\n"; } return $result; } }