Configurações
O Zeanwork possui uma grande gama de configurações, tornado assim um framework bem flexível, mais você não precisa se preocupar em configurar tudo isso, pois o Zeanwork já traz configurações padrões.
Estas configurações são utilizadas pelo core do Zeanwork e também podem ser usadas na aplicação, você pode criar suas próprias configurações sem nenhum problema. No desenvolvimento dos seus projetos, você pode personalizar ao máximo as configurações para que a aplicação fique o melhor possível para você e para as regras do negocio.
O Zeanwork trabalha com ambientes, com isso você pode criar várias configurações para cada ambiente. Por exemplo, você deseja ter uma determinada configuração quando sua aplicação estiver publicada, outra quando estiver sendo desenvolvida e mais uma quando estiver sendo testada.
Para selecionar o ambiente (environment) que você deseja, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada environment.
O valor a ser definido é uma string.
Veja exemplo:
Para definir o charset, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada charset.
O valor a ser definido é uma string.
Veja exemplo:
Como o Zeanwork trabalha com URL’s Amigáveis, nós usamos um interpretador de URL's, nós chamamos de URI. Possuímos um sistema de URI muito eficiente, por isso você pode usar o Zeanwork em qualquer servidor, seja ele apache ou não.
Bom, se você usa apache com o module rewrite habilitado, então você não precisa fazer nada, o Zeanwork sai funcionando perfeitamente. Mas se você não usa apache, então devemos alterar esta configuração.
Para alterar esta configuração, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada uriProtocol.
Veja exemplo:
Protocolos que é aceito pelo Zeanwork.
Se a versão do seu php não da suporte a short tag (ex: ), você pode definir que deseja utilizar esta opção nas views. O Zeanwork fará a imterpretação das tags sem nenhum problema.
Para ativar o suporte a short tag, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada rewriteShortTags.
O valor a ser definido é boolean (true/false), onde que true, será ativado este recurso e false não será ativado.
Veja exemplo:
Para ativar ou desativar os erros que são exibidos na tela, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada debugger.
O valor a ser definido é uma array, onde o key deve ser o nome do ambiente (environment) com o valor boolean (true/false).
Veja exemplo:
Para ativar ou desativar os logs, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada logs.
O valor a ser definido é uma array, onde o key deve ser o nome do ambiente (environment) com uma array, informando pelo key o tipo do log a ser definido, o valor que ele deverá receber é boolean (true/false).
Veja exemplo:
Para alterar as configurações dos cookies, você deve ir até o arquivo App/Configs/settings.php e localizar as configurações com o prefixo chamado cookie.
O cookie requer várias configurações diferentes para o bom funcionamento deste recurso.
Veja quais opções você pode definir:
Para alterar as configurações de segrança, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada security.
O key 'encrypts' armazena dados adicionais quando é salvo algo encriptado pelo Zeanwork.
Veja quais opções você pode definir:
Para alterar o formato da data padrão, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada dateFormat.
O Zeanwork possui uma extensão (extension) para datas que faz converções de um formato para outro, esta configuração é utilizado por esta extensão. Por exemplo, quando você manda converter uma data e não especifica para qual formato será convertido, ele irá utilizar este.
Veja exemplo:
Veja os formatos que é aceito pela extensão do Zeanwork em: Extensions > Formatos de datas que o Zeanwork aceita
O Zeanwork possui uma opção de auto renderização do layout, você pode definir que não será renderizado o layout automáticamente se for um requisição ajax (XMLHttpRequest).
Para alterar esta configuração, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada autoLayout.isAjax.
O valor a ser definido é boolean (true/false), onde que true, será renderizado automáticamente e false não será renderizado.
Veja exemplo:
Para definir a versão do aplicativo, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada aplicationVersion.
Veja exemplo:
Para definir a extensão de arquivos de view, layout e elements, você deve ir até o arquivo Zeanwork/Configs/settings.php e localizar a configuração chamada defaultExtension.
O valor a ser definido é uma string.
Veja exemplo:
O Zeanwork possui constantes que definem o local onde estão os arquivos de mídias tais como: CSS, JS, IMG e SWF.
Para definir as constantes, você deve ir até o arquivo App/Configs/definesMedia.php.
O valor a ser definido é uma string.
Para definir os doctypes, você deve ir até o arquivo App/Configs/doctypes.php e localizar a configuração chamada doctypes.
O valor a ser definido é uma array, o key é uma string com o nome do doctype e o valor deve ser uma string contendo o doctype.
Estas configurações são utilizadas pelo core do Zeanwork e também podem ser usadas na aplicação, você pode criar suas próprias configurações sem nenhum problema. No desenvolvimento dos seus projetos, você pode personalizar ao máximo as configurações para que a aplicação fique o melhor possível para você e para as regras do negocio.
Ambiente (Environment)
O Zeanwork trabalha com ambientes, com isso você pode criar várias configurações para cada ambiente. Por exemplo, você deseja ter uma determinada configuração quando sua aplicação estiver publicada, outra quando estiver sendo desenvolvida e mais uma quando estiver sendo testada.
Para selecionar o ambiente (environment) que você deseja, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada environment.
O valor a ser definido é uma string.
Veja exemplo:
Configure::write('environment', 'development');
Definindo o charset
Para definir o charset, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada charset.
O valor a ser definido é uma string.
Veja exemplo:
Configure::write('charset', 'UTF-8');
Protocolo de interpretação da URL
Como o Zeanwork trabalha com URL’s Amigáveis, nós usamos um interpretador de URL's, nós chamamos de URI. Possuímos um sistema de URI muito eficiente, por isso você pode usar o Zeanwork em qualquer servidor, seja ele apache ou não.
Bom, se você usa apache com o module rewrite habilitado, então você não precisa fazer nada, o Zeanwork sai funcionando perfeitamente. Mas se você não usa apache, então devemos alterar esta configuração.
Para alterar esta configuração, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada uriProtocol.
Veja exemplo:
Configure::write('uriProtocol', 'REQUEST_URI');
Protocolos que é aceito pelo Zeanwork.
Valor | Comentário ou exemplo |
AUTO | Automático |
REQUEST_URI | Com apache e module rewrite habilitado |
PATH_INFO | example.com.br/index.php/home |
ORIG_PATH_INFO | example.com.br/index.php/home |
QUERY_STRING | example.com.br/?/home |
Ativando o suporte a short tag
Se a versão do seu php não da suporte a short tag (ex: ), você pode definir que deseja utilizar esta opção nas views. O Zeanwork fará a imterpretação das tags sem nenhum problema.
Para ativar o suporte a short tag, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada rewriteShortTags.
O valor a ser definido é boolean (true/false), onde que true, será ativado este recurso e false não será ativado.
Veja exemplo:
Configure::write('rewriteShortTags', true);
Ativando/Desativando erros
Para ativar ou desativar os erros que são exibidos na tela, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada debugger.
O valor a ser definido é uma array, onde o key deve ser o nome do ambiente (environment) com o valor boolean (true/false).
Veja exemplo:
Configure::write('debugger', array(
'development' => true
, 'published' => false
)
);
Ativando/Desativando logs
Para ativar ou desativar os logs, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada logs.
O valor a ser definido é uma array, onde o key deve ser o nome do ambiente (environment) com uma array, informando pelo key o tipo do log a ser definido, o valor que ele deverá receber é boolean (true/false).
Veja exemplo:
Configure::write('logs', array('development' => array(
LOG_WARNING => true
, LOG_DEBUG => true
, LOG_ERR => true
, LOG_ERROR => true
, LOG_SECURITY => true
),
'published' => array(
LOG_WARNING => false
, LOG_DEBUG => false
, LOG_ERR => false
, LOG_ERROR => false
, LOG_SECURITY => true
)
));
Cookies
Para alterar as configurações dos cookies, você deve ir até o arquivo App/Configs/settings.php e localizar as configurações com o prefixo chamado cookie.
O cookie requer várias configurações diferentes para o bom funcionamento deste recurso.
Veja quais opções você pode definir:
Configure::write('cookie.path', '/'); Se for definido '/', o cookie estará disponível dentro de todo o domínio. Se for definido '/foo/', o cookie estará disponível apenas no /foo/ diretório e todos os subdiretórios como /foo/bar/ do domínio.Configure::write('cookie.secure', false);Define se o cookie será transmitido através de uma conexão segura HTTPS do cliente.Configure::write('cookie.prefix', 'Zeanwork.');Define um prefixo para os cookies que serão salvos atravez do Zeanwork.Configure::write('cookie.domain', null);Define os domínios em que o cookie estará disponível.Configure::write('cookie.expires', null);Define quando tempo o cookie será valido, o valor a ser definido deve ser em timestamp.Segurança
Para alterar as configurações de segrança, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada security.
O key 'encrypts' armazena dados adicionais quando é salvo algo encriptado pelo Zeanwork.
Veja quais opções você pode definir:
Configure::write('security', array('encrypts' => array(
'dataStart' => 'Kp4LU1S9DkFpRkCrKFQoGi3F4' //Prefixo que será adicionado nos dados encriptados.
, 'dataEnd' => '1S9DkFpRkCrQoi34' //Sufixo que será acrescentado nos dados encriptados.
)
)
);
Formato da data padrão
Para alterar o formato da data padrão, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada dateFormat.
O Zeanwork possui uma extensão (extension) para datas que faz converções de um formato para outro, esta configuração é utilizado por esta extensão. Por exemplo, quando você manda converter uma data e não especifica para qual formato será convertido, ele irá utilizar este.
Veja exemplo:
Configure::write('dateFormat', 'dd/mm/aaaa');
Veja os formatos que é aceito pela extensão do Zeanwork em: Extensions > Formatos de datas que o Zeanwork aceita
Renderização automática, se for ajax
O Zeanwork possui uma opção de auto renderização do layout, você pode definir que não será renderizado o layout automáticamente se for um requisição ajax (XMLHttpRequest).
Para alterar esta configuração, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada autoLayout.isAjax.
O valor a ser definido é boolean (true/false), onde que true, será renderizado automáticamente e false não será renderizado.
Veja exemplo:
Configure::write('autoLayout.isAjax', false);
Versão da aplicação
Para definir a versão do aplicativo, você deve ir até o arquivo App/Configs/settings.php e localizar a configuração chamada aplicationVersion.
Veja exemplo:
Configure::write('aplicationVersion', '1');
Extensão dos arquivos de view, layout e elements
Para definir a extensão de arquivos de view, layout e elements, você deve ir até o arquivo Zeanwork/Configs/settings.php e localizar a configuração chamada defaultExtension.
O valor a ser definido é uma string.
Veja exemplo:
Configure::write('defaultExtension', 'html');
Constantes para mídias
O Zeanwork possui constantes que definem o local onde estão os arquivos de mídias tais como: CSS, JS, IMG e SWF.
Para definir as constantes, você deve ir até o arquivo App/Configs/definesMedia.php.
O valor a ser definido é uma string.
Tipos de documentos HTML (doctype)
Para definir os doctypes, você deve ir até o arquivo App/Configs/doctypes.php e localizar a configuração chamada doctypes.
O valor a ser definido é uma array, o key é uma string com o nome do doctype e o valor deve ser uma string contendo o doctype.
