Springy

A micro framework for smart PHP developers.

Table of content

• Sobre
• Guia de instalação * Pré-requisitos * Primeiros passos * Configuration
• Models
• Views
• Controllers

Sobre

O Springy foi projetado para ser um framework de desenvolvimentos de aplicações web em PHP no formato MVC, leve, de fácil aprendizado, rico em recursos, adaptável e de rápida execução.

Guia de instalação

Para sermos objetivos nessa documentação, iremos considerar que você já configurou o servidor web para responder no endereço de seu projeto e focar como fazer para desenvover sua primeira página.

Se você não usa o Apache HTTP Server ou seu servidor web não entende o arquivo .htaccess, como o NGINX Plus, verifique quais configurações são necessárias para ter o mesmo efeito.

Pré-requisitos

• Ter o Composer Dependency Manager for PHP instalado;
• Ter um servidor web e o PHP instalados e configurados para seu projeto;

Primeiros passos

• Faça o download do pacote do framework e o descompacte num diretório temporário;
• Copie o conteúdo da pasta www para o diretório document root de seu projeto;
• Edite o arquivo composer.json e escolha as bibliotecas que irá usar: * Escolha entre as classes de template Smarty e Twig para processar as views de seu projeto; * Escolha entre as classes PHPMailer e SendGrid para o sistema de envio de e-mails.
• Rode o Composer para fazer o download e a instalação das dependências;
• Edite os arquivos de configuração;
• Crie suas controladoras (controller), visões (view) e modelos (model).

Configuração

O script sysconf.php é o arquivo de configuração geral do sistema. Nele estão entradas de definição como nome e versão do sistema, ambiente, árvore de diretórios da aplicação, charset e timezone. Mais detalhes aqui.

As demais configurações da aplicação deverão estar no diretório e sub-diretórios definidos pela entrada 'CONFIG_PATH'.

Arquivos de configuração

A classe Configuration irá buscar por arquivos contendo o sufixo ".conf.php", dentro dos sub-diretórios do ambiente em que o sistema estiver sendo executado. Além disso, o arquivo de mesmo nome e sufixo ".default.conf.php" também será carregado previamente, caso exista na raíz do diretório de configurações, independete do ambiente, como sendo entradas de configuração padrão para todos os ambientes. As entradas padrão serão sobrescritas por entradas específicas do ambiente.

Os arquivos de configuração devem definir a variável de nome $conf como um array contendo um conjunto chave-valor.

É possível sobrescrever as configurações para determinados hosts de sua aplicação, utilizando a variável $over_conf, que é um array contendo no primeiro nível de índices o nome do host para o qual se deseja sobrescrever determinada(s) entrada(s) de configuração, que por sua vez, receberá um array contendo cada entrada de configuração a ser sobrescrita.

Os arquivos pré-distribuídos com o framework são de uso interno das classes e não podem ser renomeados ou omitidos.

Seu sistema poderá possuir arquivos de configuração específicos, bastando obedecer o formato e a estrutura de nomes e diretórios.

• system

Models

Views

Controllers