2022-03-14 19:13:10 +01:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace Config;
|
|
|
|
|
|
|
|
use CodeIgniter\Config\BaseConfig;
|
|
|
|
use CodeIgniter\Format\FormatterInterface;
|
2024-04-07 22:17:30 +02:00
|
|
|
use CodeIgniter\Format\JSONFormatter;
|
|
|
|
use CodeIgniter\Format\XMLFormatter;
|
2022-03-14 19:13:10 +01:00
|
|
|
|
|
|
|
class Format extends BaseConfig
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
* Available Response Formats
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
*
|
|
|
|
* When you perform content negotiation with the request, these are the
|
|
|
|
* available formats that your application supports. This is currently
|
|
|
|
* only used with the API\ResponseTrait. A valid Formatter must exist
|
|
|
|
* for the specified format.
|
|
|
|
*
|
|
|
|
* These formats are only checked when the data passed to the respond()
|
|
|
|
* method is an array.
|
|
|
|
*
|
2024-04-07 22:17:30 +02:00
|
|
|
* @var list<string>
|
2022-03-14 19:13:10 +01:00
|
|
|
*/
|
2024-04-07 22:17:30 +02:00
|
|
|
public array $supportedResponseFormats = [
|
2022-03-14 19:13:10 +01:00
|
|
|
'application/json',
|
|
|
|
'application/xml', // machine-readable XML
|
|
|
|
'text/xml', // human-readable XML
|
|
|
|
];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
* Formatters
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
*
|
|
|
|
* Lists the class to use to format responses with of a particular type.
|
|
|
|
* For each mime type, list the class that should be used. Formatters
|
|
|
|
* can be retrieved through the getFormatter() method.
|
|
|
|
*
|
|
|
|
* @var array<string, string>
|
|
|
|
*/
|
2024-04-07 22:17:30 +02:00
|
|
|
public array $formatters = [
|
|
|
|
'application/json' => JSONFormatter::class,
|
|
|
|
'application/xml' => XMLFormatter::class,
|
|
|
|
'text/xml' => XMLFormatter::class,
|
2022-03-14 19:13:10 +01:00
|
|
|
];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
* Formatters Options
|
|
|
|
* --------------------------------------------------------------------------
|
|
|
|
*
|
|
|
|
* Additional Options to adjust default formatters behaviour.
|
|
|
|
* For each mime type, list the additional options that should be used.
|
|
|
|
*
|
|
|
|
* @var array<string, int>
|
|
|
|
*/
|
2024-04-07 22:17:30 +02:00
|
|
|
public array $formatterOptions = [
|
2022-03-14 19:13:10 +01:00
|
|
|
'application/json' => JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES,
|
|
|
|
'application/xml' => 0,
|
|
|
|
'text/xml' => 0,
|
|
|
|
];
|
|
|
|
|
|
|
|
/**
|
|
|
|
* A Factory method to return the appropriate formatter for the given mime type.
|
|
|
|
*
|
|
|
|
* @return FormatterInterface
|
|
|
|
*
|
|
|
|
* @deprecated This is an alias of `\CodeIgniter\Format\Format::getFormatter`. Use that instead.
|
|
|
|
*/
|
|
|
|
public function getFormatter(string $mime)
|
|
|
|
{
|
|
|
|
return Services::format()->getFormatter($mime);
|
|
|
|
}
|
|
|
|
}
|