Tutorials

Suporte a Drupal no PhpStorm 8

Drupal 8 logoSalve Pessoal

Está saindo do forno mais um tutorial em português do PhpStorm. Desta vez vamos abordar o suporte ao Drupal. Drupal é uma plataforma de gerenciamento de conteúdo open source que, a partir da versão 8 do PhpStorm, tem suporte nativo.

Este tutorial abrange os seguintes tópicos da integração do IDE com o Drupal:

Habilitando a Integração

O PhpStorm pode identificar quando está trabalhando com um projeto Drupal, e vai exibir uma notificação quando isso acontecer. Basta seguir os diálogos a seguir para habilitar a integração.

snapshot13

Você também pode iniciar o desenvolvimento de um módulo do zero. Ao criar um novo projeto, selecione o tipo como “Drupal Module”.

snapshot12

No próximo diálogo você deve indicar onde está a instalação do Drupal para a qual pretende desenvolver, a versão da API e voilá.

snapshot13

O PhpStorm já vai configurar, com os passos acima, os include paths di Drupal para você. Caso você queira adicionar mais diretórios com código que você precise basta adicioná-los em Settings  PHP.

O IDE também vai sugerir que você associe arquivos .theme, .module e .install como do tipo PHP e .info como INI, caso não esteja trabalhando para um módulo Drupal 8.

Você pode também configurar o PhpStorm para que ele formate seu código pelo estilo do Drupal. Você pode fazer esta configuração acessando Settings →Code Style →PHP →Set From … → Drupal ou automaticamente pela notificação.

snapshot26-a

Hooks

Com a integração habilitada você já conta com os Hooks do Drupal para seu módulo. Ao invocar o auto acabamento você já verá listados os possíveis hooks para sua declaração.

Você também conta com facilidades na navegação para a declaração do Hook no qual está trabalhando e voltando para a função que estava escrevendo.

Você também conta com a possibilidade de visualizar a documentação de um hook sem muito esforço. Com [Ctrl] + [Q], ou [F1] no Mac, você acessa rapidamente as informações que deseja.

snapshot32

Ferramentas para Drupal

Como Ambiente de Desenvolvimento Integrado, o PhpStorm não poderia deixar de fora integrações cruciais para o desenvolvimento.

Buscas na API do Drupal: Se estiver em dúvida sobre qualquer elemento do Drupal, selecione o termo, abra o menu de contexto (botão esquerdo do mouse), e selecione Search in Drupal API. Esse termo será aberto diretamente na busca do site do Drupal.

Issue Tracker do Drupal.org: se você utiliza o issue tracker do Drupal.org você pode acessar suas tarefas, criando um contexto de desenvolvimento para cada uma delas, diretamente no PhpStorm. No tutorial você confere o passo a passo para habilitar essa funcionalidade.

Coder e PHP Code Sniffer: Você pode receber alertas de inspeção com relação ao estilo de código do Drupal, que está na ferramenta Coder, através do PHP Code Sniffer. O tutorial explica como proceder obter mais essa análise.

snapshot44-a

Drush: a interface de linha de comando do Drupal também é suportada nativamente pelo PhpStorm. Acessando Settings →Command Line Tool Support, basta adicionar uma ferramenta, selecionar seu tipo como Drush, mapeá-la e você já pode utilizá-la diretamente do IDE.

snapshot48

Drupal 8 e Symfony 2

A partir de sua versão 8, o Drupal tem em sua base diversos componentes do Symfony2. O suporte a este framework é concedido através de um excelente plugin de código aberto mantido por Daniel Espendiller. Este mesmo desenvolvedor também é autor do plugin Drupal Symfony2 Bridge, além de vários outros. Este plugin por sua vez garante ainda mais facilidades trabalhando com Drupal 8 no PhpStorm.

Nesta seção do tutorial mostramos como fazer a instalação e configuração dos plugins, passo a passo. Há ainda diversos plugins que também podem te ajudar no desenvolvimento, como o PHP Annotations, também mantido por Daniel.

Uma das facilidades que este plugin trás é o auto acabamento de parâmetros em arquivos YAML. Desde de completar declarações como “description” ou “version” até mesmo encontrando alguns serviços declarados.

snapshot10

Outra valiosa adição é o acabamento de strings de tradução na função t() do Drupal. Strings declaradas no projeto são indexadas para uso no auto acabamento.

snapshot11

O Tutorial

Sim, você já pode acessar o tutorial Desenvolvimento com Drupal no PhpStorm. Confira o tutorial completo, comente e compartilhe!

Develop with Pleasure!

image description