Skip to main content

Inphinit é um framework simples escrito em PHP para criação de rotas com suporte a expressões regulares, trabalhar HTTP (cache, requisições, respostas), DOM, arquivos e pastas, depuração, etc. Tem suporte para servidores Apache, Nginx, IIS e HHVM (HipHop Virtual Machine)

Requisitos do servidor

  • PHP 5.3.0+
  • Multibyte String (GD provavelmente também) (opcional, somente necessário se usar Inphinit\Helper::toAscii)
  • libiconv (opcional, somente necessário se usar Inphinit\Helper::toAscii)
  • fileinfo (opcional, somente necessário se usar Inphinit\File::mime)
  • Apache ou Nginx ou IIS para ambiente de produção

Instalando

Instale primeiro o composer se não tiver, após isso navegue até a pasta onde ficam os seus projetos via terminal/cmd:

  • Se estiver usando um servidor Unix-like provavelmente deverá acessar assim cd /var/www
  • Se for o Xampp deve ser algo como cd c:/xampp/htdocs
  • Se for Wamp deve ser algo como cd c:/wamp/www
  • Se for usar o servidor built-in escolha o lugar que desejar

Então no terminal/cmd execute o seguinte comando (troque [nome do projeto] pelo nome que deseja que a pasta tenha, um exemplo seria blog):

composer create-project inphinit/inphinit [nome do projeto]

Se o composer não estiver instalado globalmente use assim:

php composer.phar create-project inphinit/inphinit [nome do projeto]

Então pelo navegue até a pasta [nome do projeto] pelo explorer (Windows) ou finder (Mac OSX) ou Terminal, assim:

cd [nome do projeto]

Se não for usar Apache, Nginx ou IIS você pode usar o servidor built-in com o server.bat ou server.sh. Se for Windows edite o server.bat e troque os valores das variaveis PHP_BIN e PHP_INI pelo caminho da instalação do seu PHP:

set PHP_BIN="C:\php\php.exe"
set PHP_INI="C:\php\php.ini"
set HOST_PORT=9000

Para iniciar o servidor basta dar um duplo clique server.bat ou digitar no CMD ou PowerShell isto (aperte Enter após):

C:\Users\User> server.bat

Se o seu sistema for Unix-like (Linux, BSB, Mac OSX) edite as variáveis PHP_BIN e PHP_INI (dependendo do sistema talvez tenha que trocar o caminho do bash em #!/bin/bash):

#!/bin/bash
PHP_BIN="/usr/bin/php"
PHP_INI="/etc/php5/cli/php.ini"
HOST_PORT=9000

No terminal digite isto:

$ ./server.sh

Configurações

No index.php existem 4 constantes:

define('INPHINIT_START', microtime(true));
define('INPHINIT_ROOT', rtrim(strtr(dirname(__FILE__), '\\', '/'), '/') . '/');
define('INPHINIT_PATH', INPHINIT_ROOT . 'system/');
define('INPHINIT_COMPOSER', false);

A única que você precisará ajustar INPHINIT_COMPOSER, se definir true você irá usar o composer-autoload, se false você irá o inphinit-autoload (este é mais recomendo por ser mais rápido e eficiente)

No ./system/application/Config/config.php existem 3 variáveis:

'appdata_expires' => 86400, //Usado para definir o tempo de vida limite dos arquivos na pasta ./system/storage/temp
'developer'      => true,  //Define se o ambiente é de produção ou desenvolvimento
'maintenance'    => false  //Se `true` irá desativar as Routas e o evento 'ready'

No arquivo ./system/dev.php você pode adicionar eventos, funções e criar rotas que serão disponiveis apenas no ambiente de desenvolvimento, um exemplo para uma View exibir erros que ocorrem:

<?php

use Inphinit\Experimental\Debug;

Debug::view('error', 'debug.error');

Não é necessário configurar error_reporting ou display_errors manualmente, o framework configura isto sozinho conforme o tipo de ambiente que você estiver

Apache

Depois de criar o seu projeto na pasta do Apache (exemplo: /var/www, c:/wamp/www, c:/xampp/htdcos, etc), acesse no seu navegador web este endereço http://localhost/[nome do projeto]/generate-htaccess.php (troque [nome do projeto] pelo nome que você digitou no momento de instalar via composer).

Se estiver em "produção" você pode navegar para algo como http://meu-site.com/generate-htaccess.php ou estiver em outra máquina na mesma rede navegue pelo IP http://10.0.0.20/generate-htaccess.php. Isto irá gerar o .htaccess adaptado para o servidor atual, não é necessário copiar o conteúdo gerado na tela, se estiver em um ambiente de produção você pode deletar o generate-htaccess.php.

Nginx

Navegue neste endereço http://localhost/[nome do projeto]/generate-ngix.php ou acesse o seu terminal Terminal, CMD ou PowerShell (CLI), se estiver em produção poderá fazer isto através do SSH, então navegue até a pasta aonde está o seu projeto:

cd /var/www

E em seguida digite:

php generate-nginx.php

O conteúdo gerado ou via navegador quanto via CLI deve ser copiado para sua área de transferência (Ctrl+C) por exemplo

E então você deve editar o arquivo nginx.conf na pasta do Nginx, para mais detalhes veja https://www.nginx.com/resources/wiki/start/topics/examples/full/

IIS e IIS Express

Se você usa IIS ou IIS Express para produção e deseja desenvolver em um ambiente semelhante pode seguir as orientações em PHP com IIS

Testando o seu servidor

Para simplificar a verificação dos requisitos descritos no começo você pode acessar o check.php via HTTP, por exemplo http://localhost/[nome do projeto]/check.php

Mais detalhes em: https://github.com/inphinit/inphinit/wiki