Adianti - Nginx rewrite rules

Marcelo Barreto Nees — Fri, 21 Jul 2023 14:49:12 +0000

No tutorial de "Serviços RESTful no Adianti Framework 7 ", especificamente no item "Configurando as rotas" podemos encontrar as configurações que devem ser aplicadas no servidor Apache.

#RESTFUL routes
RewriteRule ^contacts/([A-Za-z0-9]*)$ rest.php?class=ContactRestService&method=handle&id=$1&%{QUERY_STRING} [NC]
RewriteRule ^contacts/([A-Za-z-_0-9]*)/([A-Za-z-_0-9]*)$ rest.php?class=ContactRestService&method=$2&id=$1&%{QUERY_STRING} [NC]
RewriteRule ^contacts$ rest.php?class=ContactRestService&method=handle&%{QUERY_STRING} [NC]

Com a regra acima, podemos fazer chamadas como http://localhost/sistema/contacts/1 ao invés de http://localhost/sistema/rest.php?class=ContactRestService&method=handle&id=1.

Muito legal, não é mesmo?

Sim, é legal, mas perceba que para cada serviço Rest do seu sistema você terá que repetir essas regras.

Mas, como fazer se nosso webserver for o Nginx?

Edite o arquivo de configuração do seu domínio hospedado no nginx e procure pelo bloco location.

Ex:

location / {

    # First attempt to serve request as file, then
    # as directory, then fall back to displaying a 404.
    try_files $uri $uri/ =404;

    #
    # Adianti REST services
    #
    rewrite ^/auth$                          /rest.php?class=ApplicationAuthenticationRestService&method=getToken last; # Autenticar usando método POST (Recomendável)
    rewrite ^/api/([\w]+)/([\w]+)$           /rest.php?class=$1RestService&method=handle&id=$2&$args              last;
    rewrite ^/api/([\w]+)/([\w]+)/([\w]+)$   /rest.php?class=$1RestService&method=$3&id=$2&$args                  last;
    rewrite ^/api/([\w]+)$                   /rest.php?class=$1RestService&method=handle&$args                    last;
  }

Verifique se está tudo configurado corretamente e reinicie ser servidor nginx.

Agora a grande sacada é o fato de utilizarmos expressões regulares para identificar o nome do serviço Rest.

Ex:

Se você tiver um Modelo chamado Contact, basta criar o arquivo rest com o nome ContactRestService.php e o serviço já estará funcionando.

Se tiver outro model chamado Product, crie o arquivo rest com o nome ProductRestService.php.

Prático, não?

Apresentando adicli - Adianti Command Line Interface

Marcelo Barreto Nees — Fri, 22 Apr 2022 13:55:44 +0000

adicli

Adianti CLI (Command Line Interface)

A intenção de criar esta ferramenta de linha de comando não é substituir o Adianti Studio, que é uma ferramenta incrível e que aumenta em muito a produtividade, desenvolvido por Pablo Dall'oglio.

Ocorre que o Adianti Studio foi descontinuado, em favor do novo Adianti Builder.

Dessa forma, o adicli pretende ser uma interface rápida para criação de telas baseadas em templates, que podem ser customizados para atender necessidades específicas do desenvolvedor.

Os templates inclusos no adicli são os mesmos disponíveis no Sourceforge do Adianti.

Segundo o site do Framework Adianti:

A missão da Adianti é aumentar a produtividade de sua comunidade.
Queremos ser vistos como os melhores parceiros de TI para o seu negócio.

Sistemas Operacionais (testados):

Debian Gnu/Linux 11 (bullseye)

Suporte aos seguintes bancos de dados:

PostgreSQL (psql)
MySQL (mysql)
MariaDB (mysql)
Firebird (isql-fb)

🚀 Como instalar

Logado como usuário root, faça:

git clone https://github.com/marcelonees/adicli.git
cd adicli
./install.sh

☕ Como usar

O adicli é intuitivo, basta passar os parâmetros solicitados e ele irá gerar o arquivo php.

adicli -c database.conf \
       -t Table \
       -T Template \
       -M Model \
       -C ClassName \
       -O [tables|templates|examples]

Exemplos de uso

Veja outros exemplos de uso à seguir.

Criar o Model de Customers

adicli -c /etc/adicli/databases/mysql.conf  \
       -T /usr/share/adicli/framework/templates/model/Model.php \
       -A "Full Name <your_email@domain" \
       -t customers \
       -M Customers \
       -C Customers > Customers.class.php

Criar um formulário de Customers

adicli -c /etc/adicli/databases/mysql.conf  \
       -T /usr/share/adicli/framework/templates/form/StandardForm.php \
       -A "Full Name <your_email@domain" \
       -t customers \
       -M Customers \
       -C CustomersForm > CustomersForm.class.php

Criar uma listagem de Customers

adicli -c /etc/adicli/databases/mysql.conf  \
       -T /usr/share/adicli/framework/templates/list/StandardList.php \
       -A "Full Name <your_email@domain" \
       -t customers \
       -M Customers \
       -C CustomersList > CustomersList.class.php

Listando as tabelas de um banco de dados

adicli -c database.conf -O tables

Listando as templates disponíveis

adicli -O templates

Listando alguns exemplos de uso

adicli -O examples

Mais informações, você encontra no GitHub do Adicli.

Forem: Marcelo Barreto Nees