Manual de Usuário - NEOS PHP Framework
Contents
1. Para Instalar apenas descompacte o arquivo em seu servidor web e rode o site com o seu navegador NEOS PHP FRAMEWORK Jsu rio A92D001 Pagina 15 de 49 A aplica o de exemplo usa um banco de dados MySql para armazenar alguns dados na verdade apenas para mostrar como o NEOS acessa bancos de dados Ent o crie um banco de dados com as seguintes especifica es Usu rio neos Senha 123456 Agora use o script de instala o contido na raiz do site neos sgl para criar o banco e a tabela Se a aplica o n o conseguir acessar seu banco de dados verifique as configura es no arquivo site 1 app config php Voc pode configurar a aplica o de exemplo para outro banco de dados outro usu rio e senha e at mesmo outro tipo de banco de dados ex Oracle bastando reconfigurar o arquivo sute 1 app config php Compartilhado Para a instala o de um nico Core que ser compartilhado por todas as aplica es no mesmo servidor siga Os passos abaixo Baixe o arquivo core zip descompacte o em uma pasta qualquer do sistema de arquivo do servidor N o precisa ser na pasta root do servidor web Voc tamb m poder optar pelo arquivo core phar mais compacto e seguro pois usa o modelo de Arquivo do PHP PHAR este ltimo caso n o necess rio descompactar basta colocar o arquivo dentro da pasta escolhida 2 Abra o arquivo php ini2. rw Use um editor qualquer para adicionar o seguinte conte do lt php EScfg gt app dirname FILE Include NEOS core php Se voc ignorou o item 2 da instala o do n cleo do NEOS ou seja n o configurou o include path use o conte do mostrado abaixo para o arquivo index php Onde caminho da instala o deve ser substitu do pelo caminho completo da pasta onde esta o Core compartilhado do NEOS NEOS PHP FRAMEWORK Jsu rio A92D001 Pagina 19 de 49 lt php EScfg gt app dirname FILE Include caminho da instala o NEOS core php 3 Acesse a pasta criada no primeiro passo usando o seu navegador Se voc n o configurou um virtual host para a aplica o estar digitando algo parecido com isso em seu navegador htip localhost site Localhost deve ser substitu do pelo endere o adequado em seu servidor ex Mito 192 168 3 34 site 4 Uma tela da Ajuda Din mica do NEOS aparecer informando que o controller inicial n o encontrado Isso ocorre porque ainda n o criamos um controller de inicializa o para a NE Procure nesta tela uma referencia ao CORE SERVICE e clique neste link Voc tem que configurar o acesso Scfg gt admin url Scfg gt admin user etc no arquivo config php do Core do NEOS antes veja o quadro abaixo Por seguran a este item vem comentado 5 Fa a login e siga as instru es que a
3. do seu servidor localize o item include path e inclua a pasta criada anteriormente Por exemplo se a pasta tiver o nome de Framework e estiver usando um servidor Windows seria assim include path c NFramework Veja mais detalhes sobre include path na documenta o do PHP ou no pr prio arquivo php ini Caso voc pretenda fazer refer ncia direta ao core do NEOS sem usar o include path pode ignorar o passo 2 O include path facilita as referencias aos componentes do core do NEOS pois desta forma n o precisamos saber exatamente onde o NEOS esta instalado cada vez que acessarmos seus recursos Por exemplo Vamos supor que configuramos o include path com CAWebNFrameworks PHP Com o include path include NEOS core php Sem o include path include C Web Frameworks PHP NEOS core php NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 16 de 49 Aten o Para evitar confus o com um poss vel arquivo com um mesmo nome recomend vel sempre incluir uma subpasta quando for usar o include_path Veja este quadro baseado no exemplo anterior C AWeblFrameworksYPHPANEOSicore php para arquivo PHAR C Web Frameworks PHP NEOS core neos No php ini configuramos o include path include path C WeblFrameworksYPHPN phar C Web Frameworks PHP NEOS core neos Quando for usar include NEOS core php para arquivo PHAR inclu
4. o nome do a O Core do NEOS deve preferencialm por quest o de seguran a e referenc acesso indesejado aos subpasta da pr pria aplica o ou ain mais a frente Aplica o ivo que contenh rquivo deve ser o mesm letras min sculas seguido pela exten scripts do n c o nome do recurso q S ente ser Instalado em lado pelo inc eo Apesar disso nad u fun o deve ter seu nome igualado ao nome do recurso ido da extens o php a a Classe Email deve ser nomeado com email php ou seja ue contem por m com os caracteres em o php mesmo em sistemas Unix Linux uma pasta fora do root do servidor web ude path do PHP para evitar um eventual a impede que o Core seja instalado numa da misturado aos rec ursos do bloco Aplica o como veremos Toda a l gica PHP da aplica o deve ser encontrada neste bloco O NEOS usa o modelo de desenvolvimento MVC onde uma aplica o estar dividida em tr s partes Model View Control NEOS PHP FRAMEWORK Manual de Usu rio A92D modelagem de transa o de dados a parte visual e de integra o com o usu rio da aplica o toda a l gica de controle da aplica o 001 Na pr tica para n o aprofundarmos no assunto e considerando que existem muitas referencias sobre o modelo MVC dispon veis no Model criamos os objetos que formam os modelos de transa o da aplica
5. gt Campol Srow gt campol echo lt br gt Campo2 Srow gt campo2 Jelse echo N o foi poss vel mostrar os campos ou a TABELA est vazia mostramos os resultados fun o default query ON disponiveis al m da poss Voc deve instalar suas p de terceiros E necess rio conven es comum chamando os m os uma consulta checamos se teve algum resultado e em seguida O conector de banco de dados o default configurado no config php e a consulta simples EOS tras conectores pre instalados compreendendo fun es basicas para os bancos de dados bilidade de usar o PDO PHP Data Object atrav s da classe NEOS DBO do m todo r prias classes de conex o baixar do site do NEOS ou usar qualquer classe somente que a classe usada tenha alguma compatibilidade com as db Em ltimo caso voc poder usar sua classe como uma biblioteca todos de sua classe diretamente sem usar o m todo db Para cada metodo ou fun o disponivel os par metros s o diferentes Isso tanto para as classes de conex o do NEOS quanto para a classe NEOS DBO que usa o PDO M todo Par metro Par metro 2 Par metro 3 query Script SOL E insert O nome da tabela Array com os dados update O nome da tabela Array com os dados Cl usula WHERE prepare Script SOL Nome da pilha de execu o
6. muito xito os objetivos e do grande sucesso do framework quando c pias do Simple foram usadas por v rios outros programadores e at grupo de programadores em empresas nos sentimos motivados a prosseguir no desenvolvimento e aperfei oamento que nos levaram a publica o de um site espec fico para o Simple At aqui o Simple era considerado um projeto em desenvolvimento um BETA Quando resolvemos dar ao Simple o merecido status de pronto para uso fizemos um longo e minucioso trabalho de pesquisa em seus componentes acrescen erros sugest es de outros programadores padroniza o da distri tando as atualiza es corre es de bui o etc Depois de um rduo trabalho encontramos em nossas m os um projeto realmente maduro transpassando em muito as espectativas originais por m conservando os objetivos de rapidez pouco consumo de recursos do servidor e principalmente facilidade de uso e aprendizado Neste momento resolvemos trocar o nome uma aplica o inicial de exemplo Outra quest o importante sobre o NEOS a de q para facilitar pri provis rio Simple para NEOS que significa Novo neo Simple Dentre os aperfei oamentos adicionados o NEOS conta agora com uma rotina de Instala o de ova Aplica o Esta rotina pode ser chamada com apenas duas linhas de instru es e cria todos os arquivos e pastas necess rios al m dos dados de conex o a banco de dados A rotina tamb
7. neos Exemplo 1 Sxhtml file get contents arquivo da view a ser analisado 2 Sarray pegatag Sxhtml 3 print r Sarray Carregamos o conte do do arquivo a ser analisado uma view ou arquivo de template 2 Chamamos o m todo pegatag 3 Neste exemplo usamos o comando print_r do PHP para visualizar o resultado Mai DB O NEOS ve superiores a ACXxx possui um banco de dados sqlite que pode opcionalmente ser usado tanto para O as configura es e dados do framework quanto para sua aplica o Para usar o banco de dados necess rio que sua vers o do PHP seja maior ou iguala 5 1 e que as extens es PDO e SOLITE sejam habilitadas no arquivo php ini O NEOS procurar o banco de dados arquivo neos db na pasta da aplica o atual Scfg gt app Caso n o encontre tentar criar o banco de dados neste local Se estiver criando o banco de dados todas as configura es default ser o copiadas para tabelas deste banco uma forma a quente de reconfigurar o DB Se o arquivo j existir e tiver as tabelas de configura o do NEOS estas ser o usadas prioritariamente Mesmo que exista um arquivo config php para esta aplica o NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 38 de 49 A vantagem para o NEOS de usar um banco de dados em lugar de um arquivo config php a de que os dados alterados podem ser recuperados em uma nova sess o Por outr
8. o precisa ser indicada e retorna Se for FALSE ou n o estiver indicado default false o m todo retorna o model Caso contr rio retornar TRUE e o model indicado ser criado na vari vel model da superclasse Exemplos meu model Sthis gt model meu model meu model gt meu metodo argumentos Primeiro carregamos o model meu model Em seguida chamamos o m todo meu metodo da classe model rec m adicionada Sthis gt model meu model TRUE Sthis gt model gt meu metodo argumentos O mesmo exemplo acima por m agora o NEOS fara referencia ao model atrav s da vari vel model Neste caso somente um model pode ser carregado por vez M todo controller Pode parecer estranho a principio mas o NEOS admite o carregamento de mais de um controller ao mesmo tempo Isto se d pela forma aberta como o NEOS trabalha com sua estrutura Para o NEOS uma classe apenas uma classe n o importando se estamos tratando de um controller um model ou qualquer outra classe Isso tamb m amplia as possibilidades de cria o de controllers dando ao desenvolvedor a op o de criar controllers com m todos fun es gen ricos utiliz veis para outros controllers importante notar que um controller normal deve entender a superclasse class Controller extends NEOS 5 j um Sintaxe Sthis gt controller nome do controller nome do control
9. o seria uma tarefa dificil Por m imagine que seja um menu din mico dependente de v rios fatores como em que p gina est em que regi o que tipo de usu rio etc NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 36 de 49 Para facilitar a vida do desenvolvedor e at mesmo melhor a organiza o e visualiza o do c digo por outros desenvolvedores seria melhor separar o menu em um m dulo e fazer a sua programa o apenas uma vez O m todo modulo chama ent o a classe responsavel que retorna o bloco j processado A classe de m dulo tem total acesso ao framework m todos objetos configura es banco de dados etc Este m todo foi projetado para funcionar com a neosTag modulo e ou uma classe de template O uso do m todo fora deste contexto n o tem muito sentido Sintaxe modulo modulo nome do modulo start nome do modulo nome do arquivo que contenha o m dulo desejado em letras min sculas Este tamb m ser o nome do m dulo classe para o NEOS start Se n o for indicado ou for FALSE default o NEOS somente carrega o arquivo do m dulo Se for TRUE o NEOS carrega o arquivo cria a classe new modulo chama e retorna os valores da fun o start do m dulo T Smodulo recebe o m dulo se start for TRUE Exemplo modulo menu mod new Smodulo echo S mod gt start argumentos Para a classe de template default
10. PDO NEOS DBO ropci nalL Setg gt db gt my pdo zariver pdo S cfg gt db gt my pdo gt dsn mysql host localhost dbname site Scfg gt db gt my pdo gt user neos cfg gt db gt my pdo gt pass 1123456 Fazendo uma Consulta Para fazermos uma simples consulta podemos usar o comando db do NEOS Este comando pode ser chamado dentro de um controller um model ou qualquer classe carregada pelo NEOS Para exemplificar podemos analisar o seguinte trecho de c digo NEOS PHP FRAMEWORK Jsu rio A92D001 Pagina 26 de 49 1 if Sq db SELECT FROM TABELA 2 foreach q as row 3 echo Campo row gt CAMPO else echo A consulta resultou vazia Nesta linha fazemos uma consulta simples ao banco de dados e a vari vel q armazena o resultado A classe de conex o padr o do NEOS retorna o resultado como um array contendo um objeto para cada campo da tabela consultada O ndice do array indexa cada inha do resultado Fazemos uma checagem if para saber se houve algum resultado 2 Uma fun o foreach faz a varredura dos resultados 3 Mostramos o conte do do campo de nome CAMPO Uma forma mais simples e direta caso eu tenha certeza de que a consulta retornar algo seria assim 1 Sq db SELECT FROM TABELA 2 echo Campo q 0 gt CAMPO 3 echo Campo q n gt CAMPO Como no exemplo acima fazemos a consulta 1 Mostramos o
11. armazenada como um helper na pasta Helpers de minha instala o do Core Para acessar essa fun o eu deveria seguir os seguintes passos 1 Antes de usar a fun o eu precisaria saber onde est o arquivo com a fun o 2 Incluir o arquivo com um comando include 3 Finalmente chamar a fun o If file exists caminho para o arquivo com o recurso desejado include caminho para o arquivo com o recurso desejado variavel _escape _POST dados Com o NEOS voc precisa apenas chamar a fun o mesmo que n o tenha sido incluida O NEOS inclui para voc automaticamente Svariavel Sthis gt escape _POST dados Al m de fun es tamb m possivel carregar classes de forma autom tica Para isso procedemos normalmente como se todas as classes de que precisamos j estivessem dispon veis incluidas carregando a classe Mail e chamando o m todo enviar Smail new Mail Smail gt enviar Sargumentos Entre a primeira e a segunda linha o NEOS localiza o arquivo que contenha a classe solicitada carrega o e processa a pr xima linha O programador n o precisa se preocupar com mais nada Isso muito interessante tamb m para a optimiza o do consumo de recursos do servidor O NEOS trabalha de forma inteligente adicionando somente o que realmente necess rio e no momento oportuno Pagina 13 de 49 NEOS PHP FRAMEWORK Manual de Usu rio A92D
12. do NEOS por padr o a fun o start do m dulo deve ser a principal Acima carregamos o m dulo menu e mostramos echo diretamente na tela apenas como exemplo T echo modulo menu y TRUE O mesmo efeito do exemplo anterior usando neosTags arquivo da view lt neos type modulo name menu gt M todo pegatag Este outro m todo espec fico para os mecanismos internos do NEOS no tratamento de views e templates Este m todo usado para localizar determinadas TAGs XML nos arquivos de views e templates Se voc pretende criar sua pr pria classe de template este m todo ser de muita utilidade Sintaxe Sarray pegatag xhtml ponteiro tipo tag NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 37 de 49 array um array com os dados encontrados o Sarray tamanho tamanho bytes total do conte do xhtml xml o Sarray inicio ponteiro para o inicio do bloco encontrado o Sarray final ponteiro para o final do bloco encontrado o Sarra y y y y atributos todos os atributos da tag xhtml uma string contendo os dados xhtml ou xml a ser pesquisado conte do do arquivo da view ponteiro a posi o em bytes a partir da qual o conte do xhtml ser pesquisado O default o inicio do conte do tipo RESERVADO n o usado nesta vers o do NEOS tag o nome da tag XML pesquisada A tag default
13. m traz ncipalmente os que est o come ando a usar o framework al m da possibilidade da cria o de suas pr prias Aplica es Iniciais ue seu n cleo pode ser modificado para atender a qualquer necessidade do programador e essa modifica o CoreMod pode ser publicada no site do framework para acesso pelos outros programado uso acompanham a CoreMod para facilitar a utiliza o Acreditamos que voc ao ler esse pequeno manual e fazer as primeira notar o grande e positivo investimento que fez Depois disso a ado framework ser a escolha natural NEOS PHP FRAMEWORK Manual de Usu rio A92D001 res livremente Uma documenta o e exemplo de s experi ncias com o NEOS o do NEOS como seu principal Estrutura Antes de come armos a usar o framework vamos conhecer melhor a sua estrutura O NEOS pode ser dividido em tr s blocos distintos Core Aplica o e Webroot Aplica o Webroot Library DB Helpers Imagens etc Javascripts core php etc ia config php index php Devido a grande flexibilidade esperada de um framework esses blocos podem estar reunidos em uma nica pasta ou espalhados em locais diferentes sem qualquer prejuizo para a aplica o desenvolvida NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 5 de 49 Blocos Estruturais Vamos ver o que cada um desses blocos representa para o funcionamento do framewo
14. resultado para o primeiro CAMPO 2 Mostramos os demais CAMPOS n 1 2 3 etc Podemos saber quantos resultados a consulta retornou da seguinte forma 1 echo count Sa ou 2 echo Sthis gt db gt num rows Podemos usar o comando count do PHP ou 2 Obtemos o mesmo valor consultando o conector de banco de dados Obtenha mais informa es sobre bancos de dados consultando o t pico sobre o m todo db NEOS PHP FRAMEWORK Mar de Usu rio A92D001 ual Pagina 27 de 49 Fun es e Objetos Um pequeno n mero de fun es e alguns objetos podem ser usados pelo desenvolvedor para acessar e controlar alguns par metros do framework O NEOS foi projetado para ser o mais simples possivel assim sendo utiliza este conjunto bem resumido de comandos pr prios deixando o mais para os comandos da pr pria linguagem PHP Isto tamb m economiza muitas paginas de manual melhorando a curva de aprendizado do framework Objetos Configura o Todas as configura es necess rias ao funcionamento do NEOS podem ser encontradas no objeto com o nome Scfg Este objeto pode ser acessado de tr s formas Diretamente usando a sintaxe Sthis gt cfg de dentro de um controller Fazendo o objeto virar global com a sintaxe global Scfg no inicio de uma fun o ou m todo de uma classe qualquer Usando o m todo global neos cfg que retorna o objeto em qualquer pa
15. 001 O carregador autom tico procura novas fun es na pasta de helpers de sua aplica o e em seguida na pasta Helpers do core Para as classes primeiro o NEOS procura o recurso na pasta Library ou o nome que voc configurou para esta pasta da aplica o Se n o encontrar procura na pasta Library do core Assim poss vel que uma fun o ou classe seja alterada para atender a uma especifica o da aplica o corrente o recurso alterado ser armazenado na pasta correspondente da aplica o e ser chamado prioritariamente Alternativamente voc pode carregar os helpers e classes da forma antiga usando os m todos apropriados mostrados na se o Fun es e Objetos de Usu rio A92D001 Pagina 14 de 49 NEOS PHP FRAMEWORK Manual Instala o O NEOS muito f cil de instalar Os par metros de configura o pr configurados devem estar de acordo com a maioria dos servidores e aplica es mais comuns s descompactar e usar Pr requisitos O NEOS foi otimizado para funcionar com os seguintes itens Servidor web com m dulo rewrite Apache ou IIS com Isapi Rewrite PHP5 2ou superior 5 3 para usar vers es PHAR Banco de dados atualizado Oracle Mysql Postgres etc Dependendo das necessidades de sua aplica o algumas bibliotecas e m dulos extras devem ser ativados Tanto para o PHP quanto para o Servidor Web Zlib oci8_1 1g MySql gd 2 Tamb
16. NEOS PHP FRAMEWORK NeOs PHP Framework Manual de Usuario ref A92D001 Manual de Usu rio A92D001 Introdu o Estrutura Blocos Estruturais Outros Conceitos Carregamento Autom tico Instala o Pr requisitos Aplica o de Exemplo Compartilhado Criando uma Aplica o Automaticamente Manualmente Usando Banco de Dados Fun es e Objetos Objetos todos Sglite DB Expansibilidade Templates Estrutura dos Templates ounan A lo O lUw lw NI N N NN o Co OO O 00 Co NEOS Tags Tags Atributos NeosTags Pack Sobre o Manual Contatos Publica o NEOS PHP FRAMEWORK Manual de Usu rio A92D001 O OND OS OwNAN Introdu o No princ pio foi criado um framewo facilidade de uso rapid aprendizagem do pr prio framewor tinham pouca ou at nenhuma expe em termos de sugestivamente Simple sim ria emas O Simple foi c diversos prob Tempod Alta complexidade di de bancos Framework s ES Esses outros frameworks v m de muitos anos de desenvolvimentos e procuram se m mentos Isto n o t o bom quanto parece A os princ pios inic pr prio PHP as novas tecno vers es destes frameworks tentando manter a compatibilidade com ifica es s o verdadei sempre ruim pois essas mod do depois de muita
17. Normalmente no final do processo o framework retorna uma view ou outra a o de sa da Outros Conceitos Al m da estrutura organizacional do framework estudada no t pico anterior precisamos conhecer mais alguns conceitos importantes do funcionamento do NEOS Vamos aprender como o NEOS trabalha com as URLs e tamb m das v rias possibilidades de organiza o dos diret rios e da localiza o dos blocos estruturais em seus projetos O NEOS devido a sua grande flexibilidade nos proporciona uma variedade de LAYOUTS que visam atender as necessidades espec ficas de cada projeto Url O NEOS usa um formato de acesso em suas urls baseado em segmentos Isto facilita os mecanismos de busca e ao pr prio usu rio em detrimento ao habitual query string Note que tanto o arquivo index php quanto o arquivo htaccess com o m dulo rewrite s o igualmente importantes neste processo Se o seu servidor n o tiver um m dulo de redirecionamento rewrite o funcionamento correto do framework n o ocorrer Voc ser obrigado a incluir o index php nas solicita es de p ginas ao servidor Uma url como http meusite minha pagina teria que ser digitada assim nttp meusite index php minha pagina sso n o deve te preocupar pois atualmente praticamente todos os servidores possuem algum recurso de redirecionamento compativel com o rewrite do Apache uma url os segmentos ser o interpreta
18. a e indicar o atributo multiple da seguinte forma lt neos type select var array multiple gt O convencional seria indicar apenas multiple sem um valor Mas para a neosTags se for deixado sem um valor sinal de igual e aspas ocorrer um erro de interpreta o no XML Exemplo o controller Sarray home p gina inicial Sarray download array baixar arquivos Sarray contato fale conosco Na view lt neos type select var array class pages multiple gt Depois de renderizado NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 47 de 49 lt select class pages multiple gt lt option value home gt p gina inicial lt option gt lt option value download selected selected gt baixar arquivos lt option gt lt option value contato gt fale conosco lt option gt lt select gt NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 48 de 49 Sobre o Manual Este manual foi escrito para dar uma pequena ideia da simplicidade e facilidade de uso deste framework Se voc pensava que seria muito dif cil usar o NEOS espero que estas poucas linhas tenham lhe mostrado o contr rio Se voc est acostumado a programar em PHP j pode instalar e usar o NEOS em seus pr ximos projetos sem a necessidade de aprender mais nada Mas se ainda estiver com d vidas ou deseja fazer coment rios sugest es e criticas entre em c
19. a o funcionamento do template Imagens javascript folhas de estilo arquivos flash e muito mais Quando um template esta configurado Scfg gt default gt template ou voc definiu um template usando o m todo view o NEOS procurar pelo arquivo index php da pasta do template selecionado Se este arquivo n o existir o NEOS aciona a classe template padr o do NEOS caso contr rio chama a classe contida neste arquivo que deve ter o nome de template O m todo invocado pelo NEOS get layout para um ou outro caso Um arquivo nomeado como layout html deve conter o template propriamente dito Este arquivo cont m o html b sico desenvolvido por um designer por exemplo contendo tamb m algumas tags especificas do NEOS as neosTags Outros arquivos de layout podem ser criados por m a classe de template do NEOS usar somente o layout html ignorando os outros Para usar outros layouts no mesmo template necessario algum seletor na classe do arquivo index php ou usar outra classe de template que suporte NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 42 de 49 NEOS Tags Tanto nos templates como nas views o NEOS reconhece um conjunto de tags especiais usadas para uma s rie de comandos pr prios do framework dedicados ao tratamento de views Os comandos PHP ainda estar o ativos por m n o recomendado o seu uso em arquivos de visualiza o As neosTa
20. al do framework no arquivo do Core do NEOS e arquivos setado true lista os arquivos carregados at o momento no arquivo de logs default false e vari veis voc pode indicar uma vari vel ou array que ter seu valor amostrado neste momento no script Este m todo depende de dois fatores para funcionar da classe NEOS Status inclu da no Core do NEOS e da configura o do item Scfg gt status Somente a quantidade de mem ria a m moria de pico e o tempo gasto at este momento ser o mostrados na barra de status do framework Os demais itens arquivos e vari veis ser o indicados num arquivo de log da sua aplica o se tiver configurado o item Scfg gt logfile Configure o item Scfg gt status com as palavras file e display para respectivamente gravar um arquivo de log e mostrar os dados na barra de status Exemplo Scfg gt status display default do NEOS Scfg gt status file Scfg gt status displayfile ou Scfg gt status filedisplay M todo modulo Este um m todo espec fico para trabalhar com CMS e Templates Quando invocado chama uma classe especialmente criada para pequenas tarefas de c digo auxiliar e rotineiro Para entendermos melhor imagine um site que possua um menu e este deve aparecer em todas as p ginas do site Normalmente voc deveria criar este menu repetidamente para cada p gina Se este menu for est tico at que n
21. ando voc n o precisa criar um controller para apenas chamar uma view onde n o se pretenda a execu o de qualquer c digo PHP uma view est tica este caso a view apenas um arquivo html simples que pode conter por exemplo um texto com a icen a de uso do site uma tela de abertura uma tela simples de login um formul rio etc Para usar views est ticas voc deve criar um diret rio com o nome statics dentro do seu diret rio de views Salve suas views est ticas neste diret rio com a extens o html Para acessar uma view est tica o usu rio do site deve digitar o nome completo da view est tica com ou sem a extens o que pode ser html htm php ou neos O nome da view n o deve ser igual ao de um controller da sua aplica o pois o NEOS dar prioridade ao controller Finalmente para que a view seja exibida acesse o arquivo config php da sua aplica o e inclua ou modifique o seguinte item Scfg gt static view true Lembre se Views est ticas n o podem conter comandos do PHP e neosTags Estes n o funcionar o e ainda ser o enviados ao navegador do visitante sem altera es 2 Por seguran a o NEOS n o habilita as statics views por default NameSpace Bem n o se trata realmente de namespace como se usa no PHP Acontece que para evitar conflitos entre os recursos intr nsecos do framework e de sua aplica o resolvemos prefixar todas as vari
22. aplica o uma forma r pida de come ar a trabalhar com o NEOS Principalmente se estiver pretendendo usar o NEOS em apenas uma aplica o em seu servidor web as se pretende instalar o framework para v rias aplica es ou sites em um mesmo servidor voc ter duas op es Voc pode usar o Instalador Autom tico somente a partir da vers o A9xx para a cria o de suas aplica es ou criar os arquivos e pastas manualmente Compartilhando o mesmo n cleo as aplica es ter o somente os blocos Web e Aplica o estudados anteriormente tornando a cria o manual um processo vi vel Vamos ver nos pr ximos t picos como proceder em ambos os casos Automaticamente Como j mencionado anteriormente o NEOS possui uma rotina de instala o autom tica de novas aplica es que est dispon vel somente a partir da vers o A9xx em diante e pode ser usada da seguinte forma Crie uma pasta para a sua nova aplica o no root do servidor web Esta pasta deve ter acesso completo de escrita e leitura ou 0777 em servidores Unix Caso contr rio o instalador n o conseguir criar e copiar os arquivos necess rios e apresentar uma mensagem de error No final da instala o recomendo deixar esta pasta e subpastas com as restri es normais Vamos assumir que o nome da pasta criada seja site 2 Nesta pasta crie um arquivo index php tamb m com permiss o 0777 ou
23. ari veis para todas ou uma espec fica view Sintaxe Sthis gt viewVar vari vel valor nome da view Vari vel nome da vari vel como aparecer para a view ou views Tamb m pode ser usado um array aos moldes do m todo view valor o conte do da vari vel indicada no par metro anterior Se pretender usar um array para o par metro anterior este item deve ser ignorado ou preenchido com uma string vazia view o nome da view setado no m todo view Caso n o seja indicado esta variavel estara dispon vel para todas as views Exemplos Sthis gt viewVar titulos Titulo do Site Disponibiliza a vari vel titulo para todas as views carregadas Seu valor ou conte do ser Titulo do site NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 30 de 49 Sthis gt viewVar titulo Titulo do Site header A vari vel titulo estara disponivel somente para a view nomeada como header Sdados titulo Titulo do Site Sdados mensagem Este site est em constru o Sthis gt viewVar Sdados As vari veis armazenadas no array Sdados estar o dispon veis para todas as views Sdados titulo Titulo do Site Sdados mensagem Este site est em constru o Sthis gt viewVar Sdados header O mesmo do exemplo anterior por m a vari vel ser visivel somente na view header M todo helper Carr
24. cada ex query insert update etc O m todo default query conector alias apelido da conex o configurada previamente Caso n o seja indicado sera usado o default indicado no arquivo de configura o do NEOS como Scfg gt default gt db Para os conectores de banco de dados padr es do NEOS estes retornar o um array contendo objetos como resultado de uma consulta Este array ter um ndice num rico representando cada linha do resultado no caso de um SELECT Para cada linha o array conter objetos para cada campo da tabela cujo nome ser exatamente o nome do campo na tabela Exemplos q db SELECT FROM TABELA A vari vel q receber um objeto correspondendo ao resultado da consulta Como o m todo default o query e o conector definido no config php ent o neste exemplo estamos invocando uma consulta simples query no banco de dados default NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 33 de 49 S dados campol valorl Sdados campo2 valor2 query _db TABELA Sdados insert mysql Neste exemplo estamos inserindo dois campos na tabela TABELA usando o conector mysql Os detalhes de conex o est o no arquivo de configura o do NEOS No exemplo acima fazem Sret db SELECT FROM TABELA if Sret foreach ret as Srow echo lt br
25. correspondem ao nome de uma vari vel dispon vel dentro do escopo da pr pria view nome da view voc pode atribuir um nome para essa view usando este par metro caso contr rio ser atribu da uma numera o a partir de zero 0 O nome muito importante quando trabalhamos com templates para indicar em qual lugar dever a view ser mostrada template string com o nome do template desejado NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 29 de 49 retorna se voc quiser apenas obter o conte do do arquivo da view sem visualizar a view indique o valor TRUE para este par metro Somente o par metro nome do arquivo ser considerado nenhum processamento ser feito na view O m todo retornar FALSE em caso de erro e disparar uma mensagem de erro para o mecanismo de tratamento de erro habilitado no momento Exemplos S this gt view splash A view splash ser mostrada no final da execu o do NEOS Sview Sthis gt view splash TRUE O conte do da view arquivo ser carregado na vari vel Sview Sdados titulo Titulo do Site Sthis gt view splash Sdados Splash MeuTemplate A view splash ser mostrada a vari vel titulo se existir esta vari vel na view ser substitu da por Titulo do Site o nome da view para o NEOS ser Splash e usar o template MeuTemplate M todo viewVar Use este m todo para indicar v
26. de core php Arquivos PHAR Este um tipo de arquivo nativo do PHP que possui algumas vantagens em compara o aos scripts convencionais PHAR significa PHP Archive e pode ser usado em vers o TAR ZIP ou como um script convencional texto edit vel Depois de muitos testes com esse tipo de arquivo pudemos notar que a sua utiliza o traz por um ado um consumo levemente maior de mem ria e por outro lado uma enorme compensa o em performance Ambos os efeitos causados pelo mesmo motivo trata se de um arquivo comprimido e que precisa ser descomprimido na mem ria do servidor Mas acontece que o PHP muito inteligente no gerenciamento de mem ria e essa ocupa o a mais de mem ria compensada pelo fato de o PHP reaproveitar o arquivo que j esta na mem ria para todas as futuras solicita es feitas ao mesmo arquivo Ou seja o PHP descompacta somente uma vez e mant m os arquivos na mem ria para futuras utiliza es Usando os arquivos na mem ria que muito mais r pida que o HD estes rodam muito mais rapidamente que os scripts convencionais Al m da velocidade ganhamos em seguran a e espa o no HD Um arquivo TAR ZIPADO gzip tgz ocupa menos espa o em disco e n o pode ser modificado para fazer uma altera o em qualquer arquivo compactado preciso recriar todo o arquivo PHAR Depois de muitos testes optamos por usar a compacta o Tar Gzip tornando o a
27. demos organizar o framework em projeto e a prefer ncia do desenvolvedor Entre v rias possibilidades destacamos tr s ayouts varios layouts distintos conforme a necessidade do layout A O layout A tem todos os blocos descritos nos t picos anteriores D controllers misturados na raiz do site Este layout mais indicado para aqueles up programadores n o acostumados com frameworks ou para aplica es O imagens mais simples E na A vantagem que a visualiza o dos recursos utilizados imediata a prai A desvantagem com rela o a seguran a principalmente por deixar pn expostos os arquivos do core Se voc instalar oN EOS com o n cleo S index php core compartilhado as pastas library helpers os arquivos H confia pho core php e config php n o ser o necess rios Estar o na pasta core php compartilhada do n cleo Neste caso vi vel do ponto de vista da E seguran a a utiliza o deste layout E E layout B D css O imagens javascripts E neos E a E controlers No layout B temos o bloco Webroot disponivel na raiz do site como ES helpers no caso anterior por m o bloco Aplica o e o bloco Core est o library misturados na pasta neos E models B views Se voc estiver usando o core compartilhado em outra pasta config php somente o bloco Aplica o deve ficar na pasta neos T core php ja htaccess ind
28. dos pelo NEOS da seguinte maneira Dada a url http meusite controller fun o argumento argumentoZ argu Os seguintes seguimentos podem ser notados e controller nome do controller que ser carregado pelo NEOS e fun o m todo ou fun o do controller que dever ser invocado e argumentos argumentos ou dados passados ao m todo invocado Se voc preferir as query strings o NEOS tamb m conseguir funcionar da forma esperada NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 8 de 49 Dada a url http meusite index php c controller amp f fun o amp arg argumentos DR s esta vari vel GET passar o nome do Controller e f esta vari vel GET passar o m todo ou fun o do controller e arg ou qualquer outra vari vel GET ser passada ao m todo invocado como um array O nome das vari veis podem ser trocadas no arquivo config php nos itens Scfg gt get ctrl e Scfg gt get func O NEOS ainda pode funcionar com vari veis passadas por POST nas mesmas condi es descritas acima Neste caso quando a url n o contiver seguimentos e n o forem encontradas as vari veis em formato GET o NEOS tentara encontrar o controller fun o e argumentos usando o m todo POST Para configurar o nome das vari veis modifique os itens Scfg gt post ctrl e Scfg gt post func Em todos os casos o NEOS indicar o m todo usado para a decodifica o da u
29. e bind Nome da pilha de execu o Nome do campo Valor execute Nome da pilha de execu o Os itens marcados com asterisco est o presentes somente nas classes nativas do NEOS Para o NEOS DBO como esse retorna um objeto PDO todos os m todos do PDO estar o disponiveis con do que usar o P compativel com o m NEOS PHP FRAMEWORK forme a documenta o do PHP query bind prepare etc Usar a classe NEOS DBO mais facil DO nativo do PHP pois est integrada as configura es do framework e totalmente todo db apresentado neste t pico jsu rio A92D001 Pagina 34 de 49 M todo goto O m todo goto muito til quando queremos redirecionar o framework para uma nova localiza o url interna Sintaxe goto ulr m todo c digonttp ulr aurl de destino Deve ser um seguimento do pr prio site controller fun o argumentos m todo dois m todos est o dispon veis Reflesh e Location O ltimo o default c digo http um c digo de redirecionamento HTTP v lido O default 302 Exemplo goto controller start O NEOS redireciona para a fun o start do controller controller goto redirecionado ofline reflesh 301 Redireciona para o controller e fun o indicados no primeiro par metro usando o metodo reflesn e faz um redirecionamento pro
30. e aprendizado mui jais de seus desenvolvi r ples em ingl s to grande ficultan Documenta o em ingl s ogias m todos norm ros gatilh uma reformula o completa n a cri pr pr pr pri para o PHP e n o o inverso O Simple modula para a Cria o de um ber o Esse mesmo ber o inteligente para do Quando falamos em din m NEOS PHP FRAMEWORK a o do Simple procuramos fug engessar o framework dificu r Sua estrutura pensa ent o ser a tar O framewo para a aplica crescido ica e inteligen esses frameworks mesmo co ir de qualquer conce tando a ado o futura de novas id ias m todos tecn ia evolu o da linguagem PHP Quanto a esse ltimo deve substituir a linguagem ori do a usabilidade as etc s o adap os 0 9 da como um n cleo que p o desenvolvida te queremos dizer que o p Je Usu rio A92D001 m a perda de compatibil ito e padron Padroniza o muito rigida dificultando a inclus o de bibliotecas externas Alto consumo de recursos do servidor mem ria processamento tadas de forma a o modelo inicial ue deveria ser fei bem simples para atender a necessidade dos programadores ez no desenvolvimento e tamb m a redu o do processo de por parte de equipes de programadores com elementos que ri ncia com frameworks O nome desse primeiro
31. e simples que nem mesmo organiza seus recursos em pastas Estamos considerando neste caso que a aplica o esta utilizando uma instala o compartilhada do core do NEOS Ent o somente os blocos Aplica o e Webroot est o representados Na Imagem ao lado vemos Arquivos das views Foi usado um prefixo view para melhorar a organiza o Controller model e o arquivo index bootstrap Pode ser usado um prefixo para organizar os controllers e models Outros recursos do web site Arquivo de seguran a e redirecionamento do servidor Para evitar um acesso indevido direto aos arquivos dos controllers e models coloque o seguinte no inicio de cada arquivo lt php if Idefined URLN exitO gt Manual de Usu rio A92D001 Pagina 12 de 49 Para mais detalhes sobre layouts e configura es leia a publica o Configurando o NEOS que pode ser baixada do site do NEOS Carregamento Autom tico Voc n o precisa se preocupar em carregar CLASSES e FUN ES quando est programando com o NEOS Diferentemente de outros frameworks o NEOS possui um carregador autom tico que procura e carrega as classes e fun es helpers quando forem solicitadas no script Tomamos como exemplo o seguinte caso Eu tenho uma fun o que uso muito em meus scripts e que faz uma s rie de limpezas em dados recebidos de um formul rio ou de uma requisi o em Ajax A fun o escapel ent o foi
32. ega uma fun o armazenada em um arquivo helper de ajuda e disponibiliza no contexto do controller atual Sintaxe Sthis gt helper nome do arquivo argumentos pack nome do arguivo indique o nome do arquivo que contenha a fun o desejada e que esteja armazenada na pasta apropriada para os helpers argumentos opcionalmente voc pode passar argumentos para o helper usando este campo array e obter a sa da do helper chamado packos helpers podem ser agrupados como o caso das neosTags em um pack ou subpasta Se for o caso deve ser indicado o pack aqui Depois de chamar este m todo a fun o estar dispon vel e pode ser acessada com a seguinte sintaxe Sthis gt nome da fun o argumentos Este m todo a forma tradicional autom tica que deve ser usada pr para adicionar um helper ao sistema Veja tamb m a forma M todo _model Para o NEOS os models s o classes comuns por m para facilitar a organiza o de seu projeto os models devem ser armazenados na pasta espec fica para os models Scfg gt model NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 31 de 49 Sintaxe model Sthis gt model nome do model retorna Smodel Se retorna for FALSE ou n o for indicada o model indicado em nome do model ser retornado nesta vari vel Caso contr rio retorna TRUE nomedo arquivo nome do arquivo onde esta armazenado o model A extens o n
33. eos type view name head gt lt div class pagina gt lt hi gt Site em Constru o lt h1l gt lt neos var mensagem style color amp tF00 font weight bold size 12px gt lt div gt lt neos type view name footer gt As demais views n o precisam ser alteradas e o resultado visual ser o mesmo NEOS PHP FRAMEWORK Manual de Usu rio A92D001 font Pagina 25 de 49 Usando Banco de Dados Para usarmos banco de dados numa aplica o necess rio apenas configurar os dados de acesso ao banco de dados e Indicar o gerenciador Para a aplica o criada no t pico anterior podemos proceder da seguinte forma Configurando o Banco de Dados Se voc j configurou corretamente o arquivo config php global que se encontra na pasta do Core do NEOS n o preciso fazer mais nada neste passo Por m se quiser fazer uma configura o especifica para essa aplica o crie o arquivo app config php e adicione as linhas de configura o do seu banco de dados por exemplo lt php Setando o Banco de Dados default cfg gt default gt db mysql Configura es do Banco de Dados S cfg gt db gt mysql gt driver mysql Scfg gt db gt mysql gt host localhost Scfg gt db gt mysqgl gt user neos Scfg gt db gt mysql gt pass 1123456 S cfg gt db gt mysql gt database site 1 S cfg gt db gt mysql gt char latinl swedish ci Outro Banco usando
34. er usando um virtual host descomente o item abaixo fRewriteBase web RewriteCond amp REQUEST E ILENAME d RewriteCond S REQUEST FILENAME f RewriteRule index php S1 QOSA L lt IfModule gt Aplica o controller e view Vamos criar um controller e tr s views bem simples somente para servir de exemplo Crie um arquivo com o nome de inicial php na pasta app controllers e cole o seguinte conte do lt php class Inicial extends NEOS function index titulo Site em Constru o mensagem Para mais informa es acesse Sthis gt viewVar Sthis gt viewVar www neophp tk S this gt view head Sthis gt view site this gt view footer Vamos entender o conte do deste arquivo l A gt w N A classe Inicial deve estender extends a superclasse NEOS A fun o default neste caso index A fun o viewVar cria uma vari vel somente dispon vel para as views A fun o view carrega as views indicadas Crie tamb m tr s arquivos na pasta app views com os seguintes nomes e conte dos head html NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 22 de 49 lt DOCTYPE html PUBLIC W3C DTD XHTML 1 0 Transitional EN http www w3 0rg TR xhtmll DTD xhtmll transitional dtd gt lt html xmlns http www w3 0org 1999 xhtml gt lt head gt lt meta http equiv Con
35. ex o aos bancos de dados etc O bloco Core do NEOS contem um arquivo de configura o padr o para todas as aplica es em um determinado servidor Neste caso onde se estaria usando o bloco Core de forma compartilhada para todas as aplica es um arquivo de configura o em cada aplica o dever conter apenas os itens espec ficos desta aplica o a aplica o corrente Como exemplo se precisamos configurar um banco de dados espec fico para uma aplica o somente o item banco de dados dever ser descrito no arquivo de configura o da aplica o Abra o arquivo config php para um maior entendimento de seus par metros ou leia a publica o Configurando o NEOS que pode ser baixada do site do framework Este bloco do NEOS pode conter tamb m organizados em pastas bibliotecas para expans o do EOS bibliotecas de recursos diversos classes fun es de apoio helpers e outros recursos que o desenvolvedor julgar necess rio voc pode criar diret rios e arquivos sem restri o Estes recursos dispostos neste bloco ser o exclusivos desta aplica o O core do NEOS quando estiver adicionando algum recurso ao n cleo do framework como conectores de banco de dados classes de apoio fun es etc primeiro procurar nas pastas da aplica o N o encontrando o recurso solicitado procurar nas pastas do n cleo Core O mais correto colocar todos os recursos classes etc no Core do framework
36. ex php NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 11 de 49 uma estrutura de diret Para entendermos melh app O controllers E models D views O layout C o mais organizado me Es O bloco Webroot esta na pasta web O arquivo htaccess na raiz ibrary do site na parte inferior da imagem direciona as requisi es para a confio php pasta web Ti core php E O bloco Aplica o est na pasta app E 5 web D O Bloco Core est na pasta neos Caso voc tenha instalado o core O imagens do NEOS em uma pasta separada compartilhada basta eliminar a 2 i pasta neos mostrada na imagem ao lado index php i htaccess E layout simples e view principal html view header html view footer html model php controller php IO index php nc javascript js Eimagem de topo jpg 5 imagem de fundo jpg T folha de estilo css la htaccess NEOS PHP FRAMEWORK Voc est livre para usar um dos layouts propostos ou criar seus pr prios layouts Voc pode ainda modificar o instalador do NEOS para acrescentar seus layouts Basicamente o que voc precisa criar rios adequada e modificar o arquivo config php indicando a localiza o dos diversos componentes do NEOS controllers models views core etc or as possibilidades de estrutura o de uma aplica o com o NEOS vemos abaixo uma aplica o extremament
37. ficando dispon vel para todas as aplica es Webroot Este bloco cont m os arquivos externos de acesso p blico Aqui voc deve encontrar as imagens arquivos Flash swf folhas de estilos CSS arquivos de JavaScript e outros similares Neste bloco temos como elemento predominante um arquivo index php que funciona como bootstrap do framework Isso significa que qualquer solicita o feita por um usu rio ou link ser re direcionada para este arquivo pelo servidor web conforme configurado num arquivo htaccess NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 7 de 49 usando o m dulo rewrite do servidor web Se a solicita o for de um dos recursos listados acima imagens javascript etc o servidor apenas atende a solicita o enviando o arquivo solicitado Caso contr rio atrav s do arquivo index php a solicita o passa para o framework que depois de decodificar a solicita o chamar o controller adequado Se voc nunca usou um framework antes talvez n o esteja entendendo como isso acontece Pense que em um formato normal aqui teriamos um script para cada fun o da sua aplica o Mas no caso do framework o arquivo index php funciona como um funil Todas as solicita es s o redirecionadas m dulo rewrite e arquivo htaccess para este arquivo O que o framework faz detectar qual a o foi solicitada e ent o carregar o controller correspondente
38. gs facilitam muito o trabalho dos designers que est o normalmente acostumados com as tags comuns do HTML e n o com comandos PHP Com as neosTags o designer ter facilidade para carregar vari veis do framework m dulos e definir onde aparecer o as views dentro de um layout usando tags muito parecidas com as tags do HTML convencional Al m disso todos os atributos style align class id etc s o transportados para os blocos carregados pelas neostags Sintaxe lt neos atributo valor atributo2 valor gt Aten o N o se esque a de fechar a tag com gt Caso contr rio o NEOS n o detectar o final da tag juntando o conte do da tag neos ao conte do da tag seguinte no arquivo html analisado Al m disso n o incluir espa os entre o simbolo lt e o nome da tag usar atributos padronizados as tags devem estar em letras min sculas etc Um erro de simplexml load string WARNING 2 pode ser disparado no caso de erro de sintaxe nas neosTags Estas s o as tags especiais disponiveis nesta vers o do NEOS lt neosurl gt o NEOS substitui pela url base do site lt neos charset gt o NEOS substitui pelo valor indicado em Scfg gt charset lt neostemplate gt o NEOS substitui pelo endere o base do template atual lt neos gt o NEOS substitui pelo conte do indicado pelos atributos m dulos vari veis views etc Nas vers es anteriores
39. im poss vel manipular as tabelas de forma O Orientado a Objeto diretamente Para acessar este objeto use o m todo neos acessivel em qualquer elemento do NEOS classes controllers models etc e que retorna diretamente o objeto Antes de usar o banco de dados necess rio setar no config php do CORE do NEOS Scfg gt use db true COMANDOS CAMPO NEOs gt TABELA gt CAMPO ID Retorna o valor do CAMPO da linha atual ID Se ID n o for indicado usar o ultimo ID setado Onde se v CAMPO deve ser trocado pelo nome real do campo requerido assim como em TABELA UPDATE _neos gt TABELA gt CAMPO ID VALUE lt Muda o valor do CAMPO da linha ID para o valor VALUE jal de Usu rio A92D001 Pagina 39 de 49 NEOS PHP FRAMEWORK INSERT _neos gt TABELA gt insert ARRAY Insere uma nova linha na tabela com os dados do ARRAY ARRAYICAMPO VALUE DELETE neos gt TABELA gt delete ID Apaga uma linha da TABELA indicada pelo ID Se n o for indicado usar o ltimo valor de ID CLEAR neos gt TABELA gt clear Limpa a TABELA apaga todos os dados LIST neos gt TABELA gt list LEN START Retorna um array num rico contendo um objeto para cada linha encontrada na TABELA come ando em START e limitado em tamanho P por LEN DESTROY neos gt dest
40. ira que um link seja criado para o item corrente como em um menu indique o aqui Este link sera relativo ao site Em item indicamos o valor a ser exibido na listagem Exemplo No controller definimos o array Sarray home p gina inicial Sarray download baixar arquivos Sarray t sem link Sarray contato fale conosco Na view lt neos type list var array gt Depois de renderizado NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 46 de 49 lt ul gt lt li gt lt a href http site com home gt p gina inicial lt a gt lt li gt lt li gt lt a href http site com download gt baixar arquivos lt a gt lt li gt lt li gt sem link lt li gt lt li gt lt a href http site com contato gt fale conosco lt a gt lt li gt lt ul gt Select Esta uma neosTag para gerar um select automaticamente a partir de um array Sintaxe lt neos type select var array gt Em type definimos o tipo da neosTag select indicamos ent o o array com os dados a serem usados para criar o select A formata o deste array Sarray valor label Se for necess rio indicar uma das options como selecionada selected torne o label em um array com apenas um elemento Assim Sarray valor array label Tamb m possivel tornar o select em list multiple Para isso preciso fugir um pouco a regr
41. ler indica o nome do arquivo que contenha o controller de apoio desejado sem a necessidade de incluir a extens o Convencionalmente o nome do arquivo deve ser o mesmo nome do controller que contiver em letras min sculas e com a extens o php Exemplo NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 32 de 49 this gt controller Utils Sthis gt Utils gt m todo argumentos O NEOS carregara o arquivo que contenha o controller Utils e inicializar a classe automaticamente Em seguida possivel acessar os recursos do controller Utils diretamente M todos Globais Estes m todos est o dispon veis em qualquer escopo do NEOS Isto inclui controllers models helpers ou qualquer classe usada por seu script M todo db Este o m todo usado para acessar e carregar uma classe de conex o a banco de dados No NEOS a classe de conex o a banco de dados somente ser carregada se este m todo for invocado Sintaxe Sobjeto Sthis gt db par metro 1 par metro 2 par metro 3 m todo conector Sobjeto Toda consulta a banco de dados deve retornar um objeto com os dados no formato espec fico da fun o indicada consulte a documenta o do conector Caso n o retorne dados ter o valor FALSE par metros dependendo do m todo invocado pode ser de qualquer tipo PHP v lido string array objeto etc m todo m todo da classe de conex o ao banco de dados indi
42. m baseado nas necessidades de seu projeto novas bibliotecas de expans o para o NEOS podem ser baixadas do site do NEOS ou de qualquer outro reposit rio de classes espalhados pela web ex ww yw phpclasses org Voc pode usar at mesmo bibliotecas de outros framework se estes estiverem instalados em seu servidor Para a maioria dos casos uma pequena modifica o pode resolver algum problema de compatibilidade raro O N cleo ou Core do NEOS pode ser instalado em uma pasta diret rio qualquer em seu servidor Este Core ser acessado por todas as aplica es que usarem o NEOS como framework Existe ainda a possibilidade de instala o do NEOS para uma nica aplica o Neste caso os arquivos que comp em o core do NEOS podem ser alojados em uma pasta espec fica em meio a organiza o de diret rios da aplica o como visto no t pico Layout anteriormente Aplica o de Exemplo Entre os arquivos para download no site voc encontrar uma aplica o de exemplo do NEOS app zip Esta aplica o pode ser usada em conjunto com a video aula Criando uma Aplica o do Zero para estudar o funcionamento do framework e tamb m para iniciar sua pr pria aplica o pois cont m todos os recursos necess rios para o funcionamento do framework Aten o por m para a vers o do CORE AGEN0O 1 que pode ser ligeiramente diferente antiga da vers o tratada por este manual A92D001
43. m seguida criamos mais duas subpastas app e web Respectivamente para os blocos Aplica o e Webroot Dentro da pasta app criamos as subpastas controllers models e views Dentro da pasta web criamos as pastas necess rias para a nossa aplica o imagens css javascript etc Todos estes nomes de pasta s o apenas sugest es Voc pode usar o nome que quiser n o esquecendo de configurar os nomes no arquivo config php da sua aplica o Os nomes sugeridos s o defaults do NEOS n o precisaremos mexer na configura o Deve ficar parecido com isto E O site D app O controllers 5 models O views 5 web B css B imagens B javascript Arquivos htaccess Vamos criar agora os arquivos htaccess para prover seguran a e redirecionamentos adequados para cada pasta Na pasta principal do site raiz o arquivo tem o seguinte conte do lt IfModule mod rewrite c gt RewriteEngine On fse estiver usando um virtual host descomente o item abaixo fRewriteBase RewriteRule S web E RewriteRule web 1 L lt IfModule gt Dentro da pasta app crie um arquivo htaccess com o seguinte conte do Deny From All Na pasta web crie outro arquivo htaccess com o conte do NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 21 de 49 lt IfModule mod rewrite c gt RewriteEngine On se estiv
44. ndo uma nova neosTag carrega automaticamente a fun o correspondente que esteja nesta subpasta Voc pode desenvolver suas pr prias neosTags ou baixar novos packs do site do NEOS Vamos ver algumas neosTags para termos id ia de seu potencial View Carrega uma view em substitui o a neosTag Sintaxe lt neos type view name nome da view gt O type determina o tipo view Em nome da view Indicamos o nome da view a carregar em substitui o a essa neostag Pode ser inclu do o caminho para uma subpasta se necess rio A extens o n o precisa ser indicada Exemplo NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 45 de 49 lt neos type view name header gt lt body gt minha p gina normal lt body gt lt neos type view name footer gt Neste exemplo uma view header e outra footer provavelmente comum a todas as views ser o carregadas automaticamente nos locais respectivos List e Numilist Estas neosTags servem para criar uma lista e uma lista num rica respectivamente a partir de um array fornecido Alternativamente poss vel indicar um link para cada item da lista Sintaxe lt neos type list var array gt O type pode ser list ou numilist respectivamente lista e lista num rica O array tem o seguinte formato Sarray link item Normalmente link deve ser num rico Caso que
45. o todos os procedimentos de acesso aos bancos de dados i O View cont m as visualiza es que a aplica o mostrar ao usu rio do site aplica o E basicamente composto por arquivos html por m alguns desenvolvedores costumam dot os de alguma l gica PHP de apoio A extens o dos arquivos deve ser html para que o NEOS reconhe a e carregue corretamente Voc poder usar as neosTags para carregar dados blocos m dulos etc principalmente pelos designers que n o tem conhecimento em programa o e apesar da extens o html comandos do PHP funcionar o normalmente nestes arquivos o Controller controlamos a aplica o Aqui voc encontrar toda a l gica PHP usada para controlar a aplica o usando os recursos dos models e views al m das bibliotecas helpers e outros recursos dispon veis o NEOS diferentemente de outros frameworks o Controller extends a classe principal do n cleo sso significa que o Controller e consequentemente o programador tem o controle total do framework estendido o Controller passa a ser o n cleo do sistema Isso parece l gico n o Mas at hoje n o entendi porque outros frameworks n o procedem assim Neste bloco do Framework Aplica o destacamos o arquivo config php Este arquivo como o pr prio nome indica tr s todas as configura es do framework Nele determinamos entre outras coisas O layout do framework os dados de con
46. o lado deve se ter um cuidado redobrado para evitar tentativas de acesso indevido invas o hackers ali s como se teria de qualquer forma quando se usa um banco de dados Outra vantagem not ria a de que se sua aplica o precisar de um pequeno banco de dados para manipular um grupo n o muito complexo de tabelas poder usar o banco do NEOS Com isso ganhamos duas vezes n o precisamos configurar nada externo mysql oracle password username host e conseguimos muito mais velocidade para o conjunto O Sglite extremamente r pido As rotinas que trabalham com o banco de dados do NEOS tem por conven o um campo nomeado como ID que deve existir em todas as tabelas que serve de ROWID para todos os processos creat insert update etc Quando estiver criando uma nova tabela n o deve indicar um campo com o mesmo nome ID o NEOS criar este campo automaticamente e este ser auto increment vel Outra conven o a de se usar caracteres em letras mai sculas tanto para as tabelas quanto para os campos e nunca come ar seus nomes com o caractere underline ou sublinhado reservado no NEOS para as fun es globais e da classe NEOS DB TABLE Voc poder usar comandos do SOLITE convencionais para manipular este banco de dados ou usar os comandos listados abaixo O NEOS na inicializa o do BD cria um objeto da classe NEOS DB TABLE para cada tabela do SOLITE Ass
47. ocaliza o da pasta app bloco Aplica o 2 Indicamos a localiza o da pasta web bloco Webroot 3 Incluimos o CORE do NEOS bloco Core se que estam lO O voc n o quiser puder pode indicar a localiza o do CORE diretamente Agora ja temos o m nimo para a nossa aplica o funcionar Abra O seu Navegador e digite http localhost site Como n o foi indicado um controller e fun o na url digitada o NEOS assume o default Voc tamb m poderia ter feito a sele o diretamente na url de duas formas como vimos nos t picos anteriores http localhost site inicial index ou http localhost site index php c inicial amp af index No controller foram chamadas tr s views ou tr s partes fatiamento que formar o o arquivo de visualiza o final Por m poss vel fazer isso de outra forma usando neosTags Desta forma o fatiamento ficara a cargo do designer da pagina html o que mais comum No controller localize as seguintes linhas this gt view head Sthis gt view site S this gt view footer Retire as linhas que chamam as views head e footer deixe somente a principal site Veja S this gt view site Na view site modifique o arquivo site html acrescentando as neosTags para carregamento de views subviews O arquivo ficar assim site html NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 24 de 49 lt n
48. ontato Estamos ansiosos para te conhecer e ajudar no que for possivel Se voc gostou do nosso framework ent o seja um colaborador deste projeto Ajude nos no desenvolvimento colaborando com classes scripts fun es e aperfei oando o NEOS como um todo Todas as modifica es ou colabora es ser o publicadas no site oficial do NEOS juntamente com suas licen as indicadas por voc para que outros usu rios tenham acesso Contatos Site oficial http neophp tk E mail prbrOymail com Publica o Esta publica o disponibilizada mediante a licen a GPL2 Nome da publica o Manual de Usu rio Autor Paulo R B Rocha Data da publica o 09 2010 C digo da publica o A92D001 NEOS PHP FRAMEWORK rio A92D001 Pagina 49 de 49
49. onte do encontrado em substitui o a neosTag lt neos url gt muito til para carregar folhas de estilo javascripts e outros arquivos com endere amento direto Isso porque quando usamos seguimentos nas url O navegador acaba interpretando a url incorretamente Por exemplo a url http meu site controller fun o seria interpretada pelo navegador como o endere o base do site n o considerando que se trata de seguimentos e que o endere o base real http meussite NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 44 de 49 Para uma melhor familiariza o com a forma como o NEOS trabalha com templates aconselhamos dar uma boa olha na classe de template padr o do NEOS assim como os templates de exemplo encontrados nas distribui es do NEOS Uma grande vantagem das neosTags a de que numa implementa o usando c digo PHP convencional na view preciso checar se a vari vel exite e somente depois usar um comando como o echo Com as neosTags se uma vari vel ou outro recurso n o existir o NEOS apenas n o mostra sem dar erro NeosTags Pack Al m das neosTags vistas anteriormente novas neosTags podem ser instaladas sem a necessidade de um upgrade total do framework Voc pode instalar novas fun es para as neosTags na subpasta neostagspack da pasta de helpers do seu NEOS Da mesma forma que os helpers s o carregados autom ticamente o NEOS ao renderizar as views encontra
50. parecer o na tela para definir os par metros necess rios 6 Ao clicar sobre o bot o Salvar o instalador criar os arquivos e pastas necess rios Ent o ao acessar novamente recarregar a p gina ou clicar no link apropriado a aplica o rec m criada aparecer Por quest o de seguran a configure a rota url o controller usu rio e senha para acesso ao CORE SERVICE no arquivo de configura es do Core do NEOS A senha deve ser criptografada em MDS Descomente o item Scfg gt admin url para tornar este servi o dispon vel Scfg gt admin user neosAdmin S cfg gt admin pass MDS 123456 Scfg gt admin url neoscoreadmin Scfg gt admin controller control php Lembre se Sua vers o do NEOS deve ser igual ou superior a A9xx para usar o CORE SERVICE Manualmente Criar manualmente sua aplica o um pouco mais trabalhoso que o processo anterior Por m n o ser t o dificil assim depois de entendermos cada arquivo e pastas necess rios ao funcionamento de uma aplica o com o NEOS Para este dias vamos U layout C como padr o e vamos ni que o k ma pasta externa compartilhado e que voc tenha configurado o jato uma pasta extern 1 do seu PHP para acessar Os s arquivos do NEOS NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 20 de 49 Diret rios Criamos neste passo uma nova pasta no diret rio root de seu servidor web com o nome de site E
51. projeto foi frustra o no uso de outros frameworks que apresentavam Excesso de abstra o em bancos de dados gerando incompatibilidades entre gerenciadores Uso de express es pr prias em substitui o ao PHP que obriga o aprendizado de um anter coesos com evolu o do rcaica nas novas O resultado to realmente iza o que p item pensamos que o fra ginal PHP com outros comandos ou fu a linguagem como acontece na maioria dos outros frameworks linguagem em detrimento as necessidades do framework O framewor n es que ja idade udesse ologias e a mework n o existam na Damos total prioridade deve ser uma ferramenta rov as funcionalidades b sicas de infinitos blocos de expans o de forma din mica e rk de todas as funcionalidades necess rias a mais exigente aplica o rogramador n o deve perder tempo se preocupando com as opera es de inclus o dos m dulos Esta tarefa deve ser do n cleo do Simple ou provido pelo pr prio bloco de expans o Como exemplo disso podemos ci necess rio a conex o e ao banco basta fazer a consulta ao banco d Depois de termos alcan ado com de dados especificado automaticam tar as bibliotecas de conex o banco de dados Quando for solicitado o acesso ao banco de dados o framework somente nesse m omento adiciona o bloco ente Para o programador e dados veja mais sobre isso em Carregamento Autom tico
52. rk Core O core o bloco que cont m o n cleo do NEOS O arquivo core php o cora o do NEOS Este arquivo cont m os mecanis o n cleo onde os demais recursos ser o acoplados para formar uma o praticamente infinito com todos os recursos requeridos pela aplica o E isto mediante a necessidade atual da ap omento o NEOS pode variar de tamanho requeren estrutura de tamanh feito de forma din m G estritamente necess o Core tamb m en expans o do core D ib Todas as bibliotecas NEOS como em n ter qualquer configu contenha uma deter contido e em E PR d m intelig ncia do framewor recursos requeridos no m rio em recursos mem ria processamen con EOS por exemplo he d t O tecas do pr prio desenvolvedor bib pers fun es de ajuda al m dos conectores para ba mos respons veis pela ica o E assim que dependendo dos do somente o que to do sistema onde est rodando ramos organizados em subpastas os recursos ou bibliotecas para a iotecas de terceiros baixados do site do nco de dados asses do n cleo para efeito de organiza o devem come ar com o prefixo eos Template neos Status ou neos Erros por exemplo As demais podem o ou conven o para os nomes com uma nica restri o o arquivo que inada classe o letras min sculas segu um arqu Por exemplo
53. rl na vari vel Sneos metodo Mascaramento Voc pode modificar uma solicita o de endere amento seja por URL GET ou POST usando mascaramentos Para criar um mascaramento crie um novo item de configura o com a seguinte sintaxe S cfg gt mask comando array controller function args args Jg Onde comando O primeiro segmento da URL ou o controller em GET e POST controller O controller de destino function A fun o de destino args Pseudos argumentos passados a fun o de destino Al m dos pseudos argumentos todos os demais segmentos da URL e vari veis ET ou POST quando este for o m todo usado ser o passados em seguida un o de destino mh Q Com o mascaramento podemos criar rotas especificas sem a necessidade de usar a convencional indica o de controller function args Como exemplo vamos considerar a seguinte m scara Scfg gt mask manual array manuals select book Ter o seguinte efeito NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 9 de 49 http www meu site com manual javascript ser interpretado como http www meu site com manuals select book javascript Lembre se que esta apenas uma representa o figurativa na verdade n o sera feito um redirecionamento da url mas sim um roteamento para o controller e fun o configurados Views Est ticas O NEOS aceita um tipo de endere amento est tico qu
54. roy TABELA Deleta destr i a TABELA CREATE neos gt create TABELA CAMPOS Cria uma TABELA com os campos indicados no CAMPOS CAMPOS NOME VALOR Por exemplo NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 40 de 49 Sarray PRIMEIRO varchar 50 Sarray SEGUNDO integer Sarray TERCEIRO text neos gt create TABLE Sarray SOL QUERY neos gt query SOL Roda a query SOL no banco de dados e retorna um array num rico contendo um objeto para cada linha retornada da consulta No exemplo CAMPO o nome do campo retornado como um objeto q neos gt query SELECT FROM TABELA if Sq foreach q as Srow echo S row gt CAMPO echo Srow gt CAMPO 2 echo Nas vers es anteriores o NEOS usar apenas os arquivos config php T Expansibilidade Devido a estrutura modular do NEOS n o possivel dizer que esta se o termina aqui Uma infinidade de recursos podem ser adicionados novas fun es objetos classes conectores de banco de dados m dulos de conex o com Google Maps Facebook etc veja a se o Caregamento Autom tico Todos os novos recursos podem ser instalados como helpers ou libranys sejam os disponibilizados pelos desenvolvedores do NEOS como tamb m pelos outros usu rios do framework temos um se o para divulgar os recursos desenvol
55. rquivo n o execut vel Em nossos testes num servidor bem modesto em termos de mem ria e processamento o resultado foi muito positivo e a diferen a em consumo de recursos foi praticamente nula em rela o a vers o convencional do core do NEOS Por esses e outros motivos recomendamos o uso de arquivos PHAR n o apenas no core do NEOS mas tamb m em seus arquivos PHP da aplica o claro que somente na fase de produ o quando sua aplica o passar por todos os teste e realmente n o precisar mais de modifica es NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 17 de 49 Se voc n o conhece o tipo PHAR do PHP leia o manual do PHP e tenha certeza que sua vers o seja a 5 3 ou superior do PHP Arquivos PHAR funcionam bem a partir da vers o 5 2 com a extens o PHP PHAR ativada por m para manipular os arquivos criar editar etc ser melhor usar a vers o 5 3 em diante sem a necessidade de ativar extens es Al m disso as extens es bibliotecas zlib e bzip podem ser teis para os trabalhos de compress o descompress o dos arquivos At o momento da edi o deste manual tenho visto artigos na internet informando que sites como o Facebook e Yahoo utilizam arquivos PHAR em seus servidores por motivos de velocidade e seguran a NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 18 de 49 Criando uma Aplica o Baixar a aplica o de exemplo e us la para iniciar uma
56. rte do NEOS classes controllers models etc Exemplos no controller S this gt cfg gt app C www site app usando o comando global global Scfg S cfg gt app C www site app usando o m todo global neos cfg gt app C www site app Para uma melhor compreens o dos dados configurados neste objeto consulte a publica o Configurando o NEOS que pode ser baixada do site do NEOS NEOS PHP FRAMEWORK Jsu rio A92D001 M todos Abaixo temos uma listagem dos comandos espec ficos do NEOS Framework M todos da SuperClasse view viewVar helper model controller M todos Globais db goto Load helper Setmark modulo pegatags M todos da SuperClasse Os m todos da Super classe classe NEOS s podem ser chamados a partir do controller usando a sintaxe Sthis gt nome do m todo par metros M todo view O m todo view indica qual view o NEOS dever carregar na sa da no final da execu o do script O m todo pode ser chamado mais de uma vez conforme o n mero de views que se queira mostrar Sintaxe Sthis gt view nome do arquivo vari veis nome da view template retorna nome do arquivo caminho e nome do arquivo da view a partir do diret rio padr o das views Scfg gt view n o preciso indicar a extens o Lhtml vari veis Um array cujos ndices
57. tent Type content text html charset utf 8 gt lt title gt lt neos var titulo gt lt title gt lt link href lt neos url gt css css css rel stylesheet type text css gt lt head gt lt body gt Na sexta linha vemos uma tag XHTML espec fica do NEOS lt neos var titulo gt Durante a renderiza o da view o NEOS substituir esta tag pelo conte do da vari vel indicada O NEOS possui uma variedade de neos Tags que podem ser muito til para o desenvolvimento do design das views e principalmente quando se esta usando uma classe de template A tag lt neos url gt s tima linha tamb m uma neos Tag e cont m o endere o base do site Neste exemplo n o usaremos o arquivo CSS esta linha somente para exemplificar o uso da neosTag e pode ser eliminada site html lt div class pagina gt lt hi gt Site em Constru o lt h1l gt lt neos var mensagem style color F00 font weight bold font size 12px gt lt div gt footer html lt body gt lt html gt Webroot Por ltimo vamos criar o nosso bootstrap Para isso criamos um arquivo com o nome de index php na pasta web Colocamos o seguinte conte do lt php eScfg gt app app cfg gt web dirname FILE include NEOS core php Vamos analisar cada linha deste arquivo NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 23 de 49 Configuramos a l
58. veis librarys helpers etc e demais recursos do NEOS com a palavra neos Ent o evite usar em sua aplica o variaveis constantes classes e outros recursos come ados com neos A menos que pretenda se referir aos recursos do corel Para exemplificar a classe de status do framework se chama NEOS status e n o Status como era de se esperar A vari vel que cont m as defini es das views a serem carregadas no final da execu o do NEOS se chama S neosViews NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 10 de 49 Neste ltimo exemplo vemos uma outra quest o reservamos o caractere underline ou sublinhado para as fun es de apoio helpers do n cleo core do NEOS e vari veis propriedades da superClasse sugest o do Filipe Dutra Este caractere tamb m usado dentro de uma classe controller para indicar uma fun o restrita que n o pode ser chamada externamente por URL GET ou POST Resumindo a menos que queira referenciar recursos do Core do NEOS n o inicie suas vari veis constantes classes fun es etc com a palavra neos ou neos Ainda em suas classes controller n o inicie uma fun o com o caracter _ a menos que queira que o NEOS ignore esta fun o nas requisi es de acesso externo URL segmentos GET ou POST Layouts Considerando os v rios blocos estruturais descritos anteriormente e a capacidade de configura o do NEOS po
59. vidos pelos usu rios no site do NEOS E isto se estende a m dulos templates e at mesmo a aplica es inteiras que podem ser instaladas Junto a sua aplica o controllers models views css javascripts A modularidade e expansibilidade do NEOS realmente infinita NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 41 de 49 Templates O NEOS tr s uma classe de template bem simples por m muito eficiente Voc pode usar esta classe como base para desenvolver sua pr pria classe ou substituHa por uma classe de template qualquer Para usar a classe e desenvolver seus templates voc precisa entender algumas conven es da classe Estrutura dos Templates No arquivo de configura o do NEOS encontramos um item que define a localiza o dos templates Scfg gt template path o template default Scfg gt default gt template e o endere o externo para o template Scfg gt template url A pasta contendo os templates deve estar localizada no bloco Webroot do framework e disponivel externamente E O site E 5 templates O template O template 5 templatez Dess Gimg Dis o index php layouti html amp layout html a figura acima podemos ver que a pasta de templates contem uma s rie de subpastas template template 1 template etc Cada subpasta contem um template diferente Dentro da pasta de cada template encontramos ainda outras subpastas onde armazenamos os recursos necess rios par
60. vis rio indicado pelo c digo HTTP 301 M todo load a forma n o autom tica ou direta de chamar uma classe qualquer Preferencialmente use a forma autom tica Sintaxe Joad nome da classe nome daclasse o nome da classe come ando com letra mai scula Um arquivo que contenha uma classe deve ter seu nome igual ao nome da classe que cont m seguida da extens o php A classe deve ter o primeiro caractere em letra mai scula O m todo load procura a classe nas pastas models librarys drivers core Library e core Librany DB Nesta ordem M todo _helper O m todo helperl a forma n o autom tica e global sem o Sthis gt de carregar um helper Veja o m todo da superclasse de mesmo nome A principal diferen a a de que podemos chamar este m todo de qualquer lugar dentro do framework NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 35 de 49 Prefira sempre a forma autom tica de carregar seus helpers M todo setmark Durante um processo de depura o dos seus scripts talv s voc queira tirar amostras de tempo valor de vari veis e arquivos carregados pelo seu framework Se for esse o caso use esta fun o global para ISSO Sintaxe Ssetmark nome da marca arquivos vari veis nome da marca pode ser dado um nome para ajudar a visualiza o dos dados caso n o seja indicado ser mostrado um n mero sequencial zero 0 o benchmark inici
61. xx as neosTags url e template n o possuiam prefixo Para padroniza o e evitar Las com TER mE Em htm foi ene O Pe neos em todas as neosTags simples as que n o tem atributos NEOS PHP FRAMEWORK Manual de Usu rio A92D001 Pagina 43 de 49 Atributos e var carrega o valor da variavel indicada e type define o tipo de recurso a ser carregado name nome do recurso a ser carregado e style class id title align etc esses atributos ser o transportado para o bloco carregado Exemplos lt neos var titulo gt O NEOS substitui esta tag pelo conte do da vari vel titulo Stitulo Os exemplos a seguir funcionam somente com um template lt neos type modulo name menu class classe menu id menu gt Quando o NEOS interpretar esta tag acima carregar o m dulo menu e colocar o conte do em substitui o a neosTag original Os atributos class e id ser o transportados para o novo conte do numa div lt neos type area name principal gt Carrega a view nomeada como principal em substitui o a esta neosTag Outros type podem ser implementados modificando a classe NEOS Template As tags lt neos url gt e lt neos template gt n o precisam de atributos lt form action lt neos url gt controller fun o gt lt form gt Se o seu site tiver a seguinte url http www meu site com br este ser o c
Download Pdf Manuals
Related Search