Seguindo a filosofia de facilitar a vida do programador, todas as configurações necessárias para a execução do PHP Coupé ficam em um único arquivo.
Essas configurações são usadas pelo núcleo do programa e são compartilhadas entre as Classes Coupé e os Módulos. Por tanto, é importante que seus parâmetros sejam observados antes de começarmos a trabalhar em um projeto.
O PHP Coupé já vem com configurações definidas que o deixam pronto para ser executado. Porém, ao começar a desenvolver um projeto, é fundamental que alguns parâmetros de acordo com suas preferências/necessidades.
É importante observar que, como plataforma de desenvolvimento, o PHP Coupé não exige banco de dados. Ele passará a usar banco de dados somente se a aplicação desenvolvida sobre ele necessitar desse recurso. Para trabalhos com banco de dados, o arquivo de configuração tem o espaço reservado para os parâmetros do seu SGBD.
Suas configurações são:
Na verdade uma função da linguagem PHP, ela controla o nível de exibição dos avisos de erro/alertas de uma aplicação.
É altamente recomendável usar ERROR_REPORTING(E_ALL) durante o desenvolvimento de um projeto para que não escape nenhum tipo de erro ou inconsistência.
Use ERROR_REPORTING(0) quando o programa estiver pronto e for ser utilizado. Assim, evitamos que o PHP passe informações sobre o programa caso aconteça algum erro.
error_reporting(0);
Para mais informações sobre essa função acesse http://www.php.net/manual/pt_BR/function.error-reporting.php
O parâmetro BASE_PATH deve ser configurado com o endereço base do seu site (http://www.meusite.com.br/) sempre com uma '/' (barra) no final. Essa propriedade é usada nos métodos de navegação e geração de URLs do PHP Coupé.
$config['BASE_PATH'] = 'http://www.meudominio.com.br/';
Configure aqui o nome que será dado as sessões criadas por seu aplicativo. Essa configuração serve apenas para convencionar um nome padrão para as sessões e facilitar a manipulação de suas informações, mas não é obrigatória. Durante o desenvolvimento sempre é possível escolher outros nomes normalmente.
$config['SESSION_NAME'] = 'Mysession';
Assim como a SESSION_NAME, na configuração ENCRYPTION_KEY é definido uma a chave criptográfica padrão para quando seu aplicativo for se utilizar de criptografias. Da mesma forma também é possível escolher outras chaves durante o desenvolvimento. Ficando essa propriedade apenas como um padrão a ser utilizado.
$config['ENCRYPTION_KEY'] = 'Mykey';
O PHP Coupé possui URLs amigáveis. URLs amigáveis é o nome dado a capacidade de deixar o endereço de seu site mais limpo, sem aquele caracteres malucos dos sites dinâmicos. Isso favorece o projeto com uma melhor indexação nos mecanismos de busca e facilita a memorização de algum endereço por parte dos visitantes.
O PHP Coupé trabalha com URLs amigáveis em dois níveis: (1) controlado pelo PHP e (2) controlado pelo Apache e seu módulo Rewrite. Usamos esses dois níveis pois, caso seu site não seja hospedado por um servidor Apache ou não tenha o Apache configurado para isso, poderá usar URLs amigáveis somente com os recursos do PHP.
Então definindo com TRUE essa opção falamos ao PHP Coupé : Quero usar URLs amigáveis e o farei no nível 1 (sem usar o modo Rewrite do Apache).
O único inconveniente de usar URLs amigáveis usando apenas o PHP (nível 1) é que seus endereços sempre terão um 'index.php' no início. Por outro lado os caracteres especiais serão removidos. Veja um exemplo:
URLs sem ser amigável:
http://www.meusite.com.br/?id=blog¬icia=oracle+compra+sun
URLs amigável gerenciada pelo PHP (nível 1):
http://www.meusite.com.br/index.php/blog/noticia:oracle+compra+sun/
$config['URL_FRIENDLY'] = TRUE;
Essa opção ativa as URLs amigáveis gerenciadas pelo módulo Rewrite do seu servidor Apache(nível 2). Para ativar essa opção, é necessário que URL_FRIENDLY também seja definida como TRUE. Assim dizemos ao PHP Coupé que queremos usar URLs amigáveis e agora, nessa opção, dizemos que temos um servidor Apache devidamente configurado. Ou seja, não coloque essa opção como TRUE se a opção anterior estiver como FALSE.
URLs amigável gerenciada pelo Apache (nivel 2):
http://www.meusite.com.br/blog/noticia:oracle+compra+sun/
$config['URL_HTACCESS'] = TRUE;Lembrando que o arquivo .htaccess necessário acompanha o PHP Coupé.
$config['URL_SUFFIX'] = '.html';
Insira aqui o identificador do documento que será usado como conteúdo inicial do seu projeto. O identificador de um documento é sempre o nome do arquivo sem sua extensão. Por exemplo: Se seu arquivo se chama 'bemvindo.cnt.php', seu identificador será 'bemvindo'.
$config['START_PAGE'] = 'bemvindo';
O PHP Coupé possui um sistema de log pronto para uso. Ativando essa opção o sistema começará a registrar em /$manager/$system/log/ os eventos internos que já estão pré-configurados como carregamento de Classe, execução de módulo, erro de endereçamento, etc. Você também pode complementar as informações colotadas com suas próprias entradas de log em qualquer lugar do seu programa.
$config['ACTIVE_LOG'] = FALSE;
Para mais informações sobre Log acesse "Efetuando log"
Imagine a situação: Em seu projeto temos uma determinada área somente para exibição de relatórios. A cada novo acesso a esses relatórios, o programa PHP é obrigado a executar suas rotinas e ainda executar as consultas ao banco de dados.
Agora, imagine a possibilidade de executar toda essas operação uma única vez, e sempre que os relatórios forem solicitados, ao invés de executar sempre as mesmas operações, os dados fossem acessados de um arquivo HTML com o resultado das consultas e processamentos já salvos. Pois é isso que o PHP Coupe faz ativando essa propriedade.
$config['ACTIVE_CACHE'] = FALSE;
Para mais informações sobre Cache acesse "Utilizando cache"
Nessa propriedade você ativa o sistema de debug do PHP Coupé. O debug revela ao desenvolvedor o tempo total de execução da aplicação, as classes e módulos utilizados no momento, o tempo de execução de cada módulo, o tempo de execução de cada consulta ao banco de dados, o tempo total gasto com essas consultas, como também revela no próprio layout do projeto onde estão inseridos os elementos que compõem a página exibida.
Com tantas informações reveladas, é importante observar que o debug deve ser ativado SOMENTE em ambientes de desenvolvimento e SEMPRE estar desativado em ambientes de produção.
$config['ACTIVE_DEBUG'] = FALSE;
Para mais informações acesse "Depurando a aplicação"
A partir da versão 0.4 o PHP Coupé ganhou a capacidade de traduzir projetos para outros idiomas de uma forma muito descomplicada. Por enquanto basta saber que aqui é que deverão ser informados os idiomas com os quais seu projeto irá trabalhará.
As definições de idiomas são feitos dentro de um array onde a chave associativa é o código do idioma no formato ISO639-2. E o conteúdo da posição leva o nome dos idiomas separados por vírgula. Essas informações serão usadas mais tarde para gerar o menu para escolha do idioma.
Para facilitar o entendimento, veja o exemplo:
$config['IDIOM'] = array( 'por' => 'Português,Inglês,Espanhol', 'eng' => 'Portuguese,English,Spanish', 'spa' => 'Portugués,Inglés,Español' );
Como pode-se observar, se for definido mais de um idioma, o conteúdo de cada posição do vetor deve ter o nome de todos idiomas definidos de acordo com o idioma da chave associativa. Separados por vírgula.
Assim, caso o usuário mude o idioma, o menu também será atualizado para o idioma escolhido.
Caso não queira se preocupar com isso, defina o mesmo conteúdo para todos idiomas.
Para mais informações sobre como utilizar idiomas acesse "Traduzindo meu projeto"
Para mais informações sobre a ISO639-2 acesse http://www.loc.gov/standards/iso639-2/php/code_list.php.
Dos idiomas definidos na configuração 'IDIOM', qual é o padrão do projeto?
$config['IDIOM_DEFAULT'] = 'por';
Apesar de já vir preparado para operações com banco de dados, o PHP Coupé não precisa de um SGBD para funcionar. Mas se sua aplicação for utilizar banco de dados, por comodidade, você pode definir aqui as informações que sempre serão usadas para conexão com o servidor.
Se sua aplicação precisar conectar-se a outra base de dados durante a execução, você poderá fazer isso normalmente. Como já dito, esses parâmetros são para comodidade. Servem apenas para definir o banco de dados padrão da sua aplicação para que você não tenha que ficar digitando as informações toda vez que for utilizar método de conexão a banco de dados do PHP Coupé .
$config['DB_TYPE'] = 'mysql'; $config['DB_SERVER'] = 'localhost'; $config['DB_USER'] = 'root'; $config['DB_PASSWORD'] = 'minha_senha'; $config['DB_NAME'] = 'phpcoupe'; $config['DB_PREFIX'] = 'phpcoupe_';
Para conhecer os métodos de banco de dados do PHP Coupé acesse "Classe Coupe_Database"
Após instalar o PHP Coupé , é recomendável renomear seu diretório MANAGER para qualquer outro nome. Nesse diretório é onde ficam armazenados todos recursos do seu PHP Coupé e, caso alguém descubra que seu projeto é feito com o PHP Coupé , pode querer acessar essa pasta diretamente para tentar obter alguma informação privilegiada sobre seu projeto.
Como todos os arquivos possuem a extensão PHP, mesmo que ele saiba o caminho de sua pasta manager muito provavelmente não conseguirá obter nada. O risco é o mesmo para qualquer outro programa PHP. De qualquer forma, para alterar o caminho, basta renomear o diretório manager e ir logo no início do 'index.php' e informar o novo nome do diretório.
O conjunto de opções aqui apresentadas é feito para incrementar a ocultação dos recursos do PHP Coupé . Assim, mesmo que um usuário mal intencionado saiba o caminho de sua pasta "manager", ele terá que saber agora o nome dos diretórios internos onde Módulos, Classes, Blocos, etc. ficam armazenados.
$config['DIR_CONTENT'] = 'contents/'; $config['DIR_TEMPLATE'] = 'templates/'; $config['DIR_MODULE']= 'modules/'; $config['DIR_BLOCK']= 'blocks/'; $config['DIR_CLASSES']= 'classes/'; $config['DIR_CACHE']= 'cache/'; $config['DIR_SYSTEM']= 'system/';
Esse conjunto de opções também foi deixado para o incremento da ocultação dos recursos do PHP Coupé . Aqui é possível definir a extensão dos arquivos do PHP Coupé para que não seja possível acessá-los diretamente caso se conheça a extrutura de diretórios usada na instalação.
É importante observar que, mesmo que as extensões sejam trocadas, elas devem terminar com '.php'. Se você por acaso renomear suas extensões para algo que não termine com '.php', o Apache irá retornar o conteúdo do arquivo como se fosse um arquivo de texto normal. Revelando TODA programação para o usuário que conhecer a estrura de diretórios de sua instalação.
$config['EXT_CONTENT'] = '.cnt.php'; $config['EXT_TEMPLATE'] = '.tpl.php'; $config['EXT_MODULE'] = '.mdl.php'; $config['EXT_BLOCK'] = '.blk.php'; $config['EXT_CACHE'] = '.html';
O PHP Coupé controla a utilização de templates da seguinte forma: Primeiro verifica o identificado do documento. Se existir algum modelo com o mesmo nome do documento, usa-o para exibir o conteúdo do documento. Caso não ache um modelo com o mesmo nome do documento, verifica se o documento é sublink de outro documento e procura por um modelo do seu "pai". Caso ainda não encontre, utiliza um modelo chamado "default" que já vem com a instalação do PHP Coupé e pode ser alterado para ser o modelo padrão do projeto.
Essa propriedade então permite que você force determinado documento a usar um template que nao seja o mesmo que tenha o seu nome ou o template padrão. Basta colocar no array o ID do documento como chave associativa e no conteúdo da posição o nome do template que você quer usar. Veja um exemplo:
$config['TEMPLATE_FORCE'] = array( 'bemvindo' => 'modelo2', 'hotsite.venda' => 'modelo_hotsite' );
Indique o formato de data que será utilizado em seu projeto. Assim, as validações de data feitas pela classes Coupé utilizarão esse formato para dizer se a data está correta. Por exemplo, caso utilize o metodo 'verifyError()' da classe 'Coupe Form', a verificação do formato de data será usado como base no formato aqui indicado. Utilize formatos de data do PHP. Veja um exemplo:
$config['DATE_FORMAT'] = "dd/mm/YYYY";
Caso você tenha algum módulo que utiliza dados cadastrados no Interface, digite aqui seu código de verificação.
$config['INTERFACE_CODE'] = '555X34367823TREHFSS';
Versão atual: 0.5
Licenciado sob Creative Commons by-nd
Desenvolvido por Samuel Corradi 2008.