dancer_introducao.pod

Dancer Framework Perl - Introdução

Nesse artigo de introdução, vou mostrar como instalar, como criar uma aplicação, como configurar o Template Toolkit e como configurar o Modulo DBI para acessar o banco de dados.

Descrição

Dancer é uma framework para o desenvolvimento de aplicações web escritas em Perl, é uma framework leve, fácil e flexivel. O Dancer é inspirado pela framework Sinatra.

Instalação

$ perl -MCPAN -e 'install Dancer'

ou

$ cpan Dancer

Criando a aplicação

$ dancer -a MyApp

Diretórios e arquivos

+ MyApp
+ MyApp/bin
+ MyApp/bin/app.pl
+ MyApp/config.yml
+ MyApp/environments
+ MyApp/environments/development.yml
+ MyApp/environments/production.yml
+ MyApp/views
+ MyApp/views/index.tt
+ MyApp/views/layouts
+ MyApp/views/layouts/main.tt
+ MyApp/MANIFEST.SKIP
+ MyApp/lib
+ MyApp/lib/
+ MyApp/lib/MyApp.pm
+ MyApp/public
+ MyApp/public/css
+ MyApp/public/css/style.css
+ MyApp/public/css/error.css
+ MyApp/public/images
+ MyApp/public/500.html
+ MyApp/public/404.html
+ MyApp/public/dispatch.fcgi
+ MyApp/public/dispatch.cgi
+ MyApp/public/javascripts
+ MyApp/public/javascripts/jquery.js
+ MyApp/t
+ MyApp/t/002_index_route.t
+ MyApp/t/001_base.t
+ MyApp/Makefile.PL

Arquivo app.pl executa nossa aplicação.

Arquivo config.yml contém as configurações de nossa aplicação.

Arquivo development.yml contém as configurações para ambiente de desenvolvimento.

Arquivo production.yml contém as configurações para ambiente de produção.

Diretório lib contém controles e módulos.

Arquivo MyApp.pm é o controle raiz de nosso aplicação.

Diretório public contém os arquivos públicos de nossa aplicação, como css, javascript, imagens e arquivos para Deploy.

Diretório views contém os templates (html).

Para mais informações sobre os diretórios, leia a documentação do Dancer, Documentação

Executando sua aplicação

$ cd MyApp
$ bin/app.pl

Para visualizar sua aplicação acesse o endereço:

http://localhost:3000

Configurando o Template Toolkit

Abra o arquivo config.yml com o editor de sua preferencia, depois apague a linha:

template: "simple"

Agora temos que descomentar algumas linhas, para fazer é só apagar o # do início das linhas:

template: "template_toolkit"
engines:
    template_toolkit:
        encoding:  'utf8'
        start_tag: '[%'
        end_tag:   '%]'

Configurando o DBI

Por padrão o DBI já vem instalado no Perl, mas vamos usar um plugin do Dancer para facilitar as coisas, instalando o plugin:

$ cpan Dancer::Plugin::Database

Agora no arquivo config.yml coloque as seguintes configurações:

plugins:
    Database:
        driver: 'mysql'
        database: 'test'
        host: 'localhost'
        port: 3306
        username: 'myusername'
        password: 'mypassword

Obs: sempre deixe no final do arquivo no mínimo uma linha vazia sem espaçamento ou tabulação.