Visão INI

1Apresentação

A visão INI é usada para enviar arquivos INI feitos a partir de dados PHP.

Por padrão, trata-se de um fluxo simples (assim como na visão JSON) mas, opcionalmente, é possível especificar um nome de arquivo. O fluxo em formato INI será então enviado ao navegador com instruções para tratá-lo como um anexo e oferecer ao usuário a opção de salvá-lo em disco com o nome de arquivo em questão.

2Uso

Aqui está um exemplo de envio de dados em formato INI:

class ApiController extends \Temma\Web\Controller {
    public function getUsers() {
        // define os dados que serão enviados
        // no fluxo INI
        $this['data'] = [
            'user1' => [
                'name' => 'Alice',
                'age'  => 28,
            ],
            'user2' => [
                'name' => 'Bob',
                'age'  => 54,
            ],
        ];
        // define o nome do arquivo (opcional)
        $this['filename'] = 'userlist.ini';

        // definição da visão usada
        $this->_view('\Temma\Views\Ini');
    }
}

• Linhas 5 a 14: Os dados a serem enviados no fluxo INI são definidos ao serem atribuídos à variável data.
• Linha 16: Definimos o nome do arquivo INI (para que ele seja tratado como um anexo) atribuindo-o à variável filename. Esse parâmetro é opcional.
• Linha 19: Especificamos que a visão a ser usada para os dados de saída é a visão INI (e não a visão Smarty usual).

Observação: A visão INI obviamente não precisa de templates, já que são os dados PHP que são diretamente serializados.

Os dados recebidos terão esta aparência:

[user1]
"name"="Alice"
"age"=28
[user2]
"name"="Bob"
"age"=54