Anotações dos cursos de Symfony e Drupal 8.

sym3_notes.md

• https://symfonycasts.com/screencast/symfony3/start-project
  • symfony cria um server próprio, interessante.
• https://symfonycasts.com/screencast/symfony3/phpstorm-git#play
  • phpStorm não é de graça. Parece bem pesadinho também.
• https://symfonycasts.com/screencast/symfony3/first-page#play
  • Interessante como o Symfony usa as annotations para definir a route.
• https://symfonycasts.com/screencast/symfony3/routing-wildcards#play
  • php bin\console debug:router -> Lista todas as rotas.
• https://symfonycasts.com/screencast/symfony3/services-useful-objects#play
  • A versão do symfony do curso é a 3.0, quanto a minha é 3.4.
  • Deu umas diferenças na implementação de uma versão para a outra, mas a conversação do vídeo me ajudou a resolver a diferença.
• https://symfonycasts.com/screencast/symfony3/listing-services#play
  • O ubuntu é o console mais colorido de todos para usar. Mas dá para colocar os comandos no console do phpStorm também.
• https://symfonycasts.com/screencast/symfony3/hello-twig#play
  • Verificar a documentação do twig para saber as possibilidades do script.
  • Interessante o dump sem parâmetros.
• https://symfonycasts.com/screencast/symfony3/twig-layouts#play
  • Então esses scripts twig são as frontend do symfony.
  • Interessante essa parada de herança de leiaute.
• https://symfonycasts.com/screencast/symfony3/layout-assets#play
  • A instalação do projeto não trouxe a pasta tutorial, que é usada neste vídeo. Daí eu tive que baixa-la clicando-se no botão de download na página do vídeo.
  • O diretório web é o DocumentRoot. Tudo aí é acessível publicamente. O que está fora, não está acessível.
  • Sempre que se referir a um arquivo estático, embala o caminho na função {{ asset() }}.
• https://symfonycasts.com/screencast/symfony3/json-api#play
  • Mais uma vez, problemas de métodos depreciados, e diferenças da versão 3.0 do tutorial para a 3.4 que estou usando.
• https://symfonycasts.com/screencast/symfony3/url-generation#play
  • A prática de dar nomes às rotas.
• https://symfonycasts.com/screencast/symfony3/reactjs-api#play
  • {{ parent() }} -> herança de conteúdo dos blocos.
  • Dá para passar as informações de twig para o JS via props.

FIM DO CURSO.

sym4_notes.md

CURSO DE SYMFONY 4: https://symfonycasts.com/screencast/symfony

• https://symfonycasts.com/screencast/symfony/setup#play
  • O tutorial é do Symfony 4.0, mas o composer já baixou o 4.1. Vamos ver se há muitas diferenças ao logo do curso.
• https://symfonycasts.com/screencast/symfony/micro-app-phpstorm#play
  • Aqui a pasta public é o DocumentRoot.
  • O comando composer require server, na minha versão, recomendou o parâmetro --dev.
  • O plugin do symfony para o phpStorm deve ser habilitado para cada um dos projetos que o usa.
• https://symfonycasts.com/screencast/symfony/route-controller#play
  • Atalhos de teclado do phpStorm: https://resources.jetbrains.com/storage/products/phpstorm/docs/PhpStorm_ReferenceCard.pdf
  • Neste vídeo, ele mostra que as rotas podem ficar em um arquivo yaml.
  • Além de mostrar como usar as rotas na anotação do método.
  • Interessante essa parada de passar a url no parâmetro do método.
• https://symfonycasts.com/screencast/symfony/flex-recipes#play
  • https://symfony.sh/
  • Este Symfony realmente usa o composer de uma maneira mais profunda do que eu imaginava.
• https://symfonycasts.com/screencast/symfony/twig-recipe#play
  • Os Bundles são os plugins do Symfony.
• https://symfonycasts.com/screencast/symfony/twig-love#play
  • {{ }} -> retorna expressão
  • {% %} -> executa código
  • {# #} -> comentário (serverside)
  • Interessante como você passa um array com variáveis para a view.
  • https://twig.symfony.com/doc/2.x/ -> documentação do twig.
• https://symfonycasts.com/screencast/symfony/debug-toolbar-profiler#play
  • composer require profiler --dev
  • De longe, a parte mais interessante do curso até agora.
  • dump($a, $b, $c); -> nos controllers.
  • {{ dump() }} -> nos twigs. Aqui, os parâmetros são opcionais.
• https://symfonycasts.com/screencast/symfony/debugging-packs#play
  • composer require debug --dev
  • Pelo que está ficando entendido no vídeo, não dá para manipular as versões das dependências dos pacotes do symfony.
  • Por isso há a alternativa de desempacotar o pacote, por exemplo: composer unpack debug. Quando isso acontece, o pacote 'symfony/debug' some, e é colocado os outros pacotes dependentes no lugar lá no composer. Com isso, podemos controlar as versões dos pacotes dependentes, ou até mesmo remover um ou outro.
• https://symfonycasts.com/screencast/symfony/css-assets#play
  • Atualização de cache do Symfony usa a data de modificação do arquivo como referência. Então, se você substituir um arquivo novo por um antigo, você terá que resetar os caches do Symfony manualmente rm -rf var/cache/dev*.
  • Webpack cuida de minification, etc. Será conversado sobre isso em um outro curso.
  • Sempre que referenciar arquivos estáticos, sempre envelopar a referência dentro da função asset().
  • composer require asset
• https://symfonycasts.com/screencast/symfony/generating-urls#play
  • Nunca linkar as páginas diretamente. Sempre usar as rotas.
  • Dar nomes às rotas manualmente também é melhor para evitar problemas.
  • Interessante passar parâmetros para o path do twig.
• https://symfonycasts.com/screencast/symfony/javascript#play
  • Mostra um pouco do javascript em ação, e herança de blocos no twig.
• https://symfonycasts.com/screencast/symfony/javascript-api#play
  • Exemplo de montagem de um api endpoint bem de boa.
  • Exemplo de como fazer a requisição ao api via JS usando uma promisse. (Nostalgia de AngularJS agora, lol).
  • Eita pega. O Symfony pega cada uma das requisições ajax na toolbar de debug, e você consegue puxar o profiler de cada uma delas. Impressionante.
• https://symfonycasts.com/screencast/symfony/services#play
  • Resumindo, Symfony é uma coleção de pacotes para facilitar o desenvolvimento do site.
  • Serviço: qualquer objeto que faz alguma coisa.
  • O Symfony percebe o tipo declarado do objeto que o método do controller espera, e injeta uma instância do objeto sozinho. Eles chamam isso de Aurowiring.
  • ./bin/console debug:autowiring

FIM DO CURSO.

symcast_drupal8.md

Curso https://symfonycasts.com/screencast/drupal8-under-the-hood

• https://symfonycasts.com/screencast/drupal8-under-the-hood/installation-web-server#play
  • O curso é com o Drupal 8.0.0-rc3+15-dev, e eu estou usando o 8.6.1 já. Também, o cara usa o php 5.6, enquanto eu já estou no 7.2. Irei anotando neste documento as diferenças de procedimento que eu detectar entre as versões;
  • Na instalação do drupal que o cara está rodando no curso, o drupal reclamou de um parâmetro xdebug incorreto, onde deveria estar xdebug.max_nesting_level = 256. Na minha instalação, não rolou nada disso.
  • No curso ele, obviamente, selecionou o idioma inglês. No meu, estou instalando em português, e a instalação já está baixando e instalando as traduções do drupal e dos módulos, sozinho.
  • Warning que sobrou da instalação das traduções: "2 translation strings were skipped because of disallowed or malformed HTML. See the log for details".
  • Coisas interessantes da instalação do Drupal 8:
    • Ele já coloca as pastas core, modules, themes, profiles, e sites, em subpastas diferentes na raiz do projeto;
    • O arquivo oficial já vem com o composer.json configurado. Nem precisa mexer;
    • Já vem com um .gitignore de exemplo com a grande maioria das coisas necessárias já ignoradas. No caso, a única modificação que eu tive que fazer é descomentar para ignorar a pasta core, já que ela é geranciada pelo composer.
    • Já vem com dependência do phpUnit, do phpCodeSniffer, do php-code-coverage, e várias outras ferramentas bem interessantes para o ambiente de desenvolvimento.
  • Já que estou usando o phpStorm em um tutorial, não estou ignorando o commit da pasta .idea, o que eu acho que seria recomendado ignorar em um repositório de produção.
  • Tive que rodar o composer install para instalar as dependências. O vídeo não fala disso.
  • O phpStorm já recomendou aplicar o padrão de código drupal para o projeto, o qual eu aceitei.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/modules-routes-controllers#play
  • O cara disse que hoje em dia, criar uma página é basicamente criar uma rota e um controller.
  • A importância do namespace bater com o que você coloca no arquivo de routing. (Agora gostei!)
  • Todo namespace tem que começar com Drupal\{nome do módulo}\{subdiretórios dentro da pasta src};
  • O phpStorm sugere várias classes Response para se usar. A classe correta para esta caso é daqui: Symfony\Component\HttpFoundation\Response;
• https://symfonycasts.com/screencast/drupal8-under-the-hood/modules-routes-controllers#play
  • composer require drupal/console:~1.0 --prefer-dist --optimize-autoloader
  • composer update drupal/console --with-dependencies
  • vendor/bin/drupal list -> lista os comandos.
  • vendor/bin/drupal router:rebuild ou vendor/bin/drupal rr -> reseta os caches das rotas.
  • vendor/bin/drupal cache:rebuild ou vendor/bin/drupal cc -> limpa os caches.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/routing-wildcards#play
  • O arquivo de rota pode ter wildcards na rota, que serão passados no argumento do método da controller.
  • WRAAAAAAAAAAAAAAAAA!!!
• https://symfonycasts.com/screencast/drupal8-under-the-hood/debugging#play
  • vendor/bin/drupal dr ou debug:router -> lista as rotas
• https://symfonycasts.com/screencast/drupal8-under-the-hood/webprofiler#play
  • composer require 'drupal/devel:^1.2'.
  • Na lista de módulos, no módulo desenvolvimento, ativar o WebProfiler. Daí liga a barrinha de debug no rodapé do site todo. Na configuração do WebProfiler dá para adicionar mais coisa ainda.
  • A instalação do devel vem incompleta, faltando 2 scripts, que ficam disparando warning no profiler. Este post me ajudou a resolver: https://www.drupal.org/project/devel/issues/2635734 (https://www.drupal.org/project/webprofiler)
  • Dá para ver que a orientação a classes simplificou HORRORES o código drupal.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/what-is-the-service-container#play
  • Olhaí... chegou a hora de falar de injeção de dependência.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/create-service#play
  • Só separando código, mas mantendo classes atreladas.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/configure-service#play
  • O mapeamento das instâncias é carregado através de um yaml chamado {nome do módulo}.services.yml.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/get-service-from-container#play
  • Agora está rolando a injeção de dependência.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/shortcuts-use-services#play
  • $this->keyValue('');
• https://symfonycasts.com/screencast/drupal8-under-the-hood/service-arguments#play
  • drupal container:debug | grep nome_do_troço -> pra pegar o nome da instância para se injetar nas outras classes.
  • Bem básico de como passar argumentos para a instanciação da classe injetada.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/config-parameters#play
  • Variáveis dentro do yml é %nome_da_variável%.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/override-core-drupal#play
  • Interessante. Sobrecarga de parâmetros para o ambiente de desenvolvimento.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/events-versus-hooks#play
  • Bom. Mudaram as hooks para eventos. Estou mais familiarizado assim.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/event-subscriber-tags#play
  • EventSubscriberInterface
  • Toda vez que mexemos no services.yml, temos que resetar os caches.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/event-arguments-request#play
  • Dá para fazer altas paradas orientadas a aspecto usando o recurso de eventos.
• https://symfonycasts.com/screencast/drupal8-under-the-hood/render-array-events#play
  • Se o método da controller retornar um array ao invés de um response, ele mantém o tema, e mostra o array na página.

FIM DO CURSO.

symfony-journey.md

Curso https://symfonycasts.com/screencast/symfony-journey

• https://symfonycasts.com/screencast/symfony-journey/event-subscriber#play
  • Eu baixei o código do tutorial, conforme instruído, mas parece que o tutorial é meio antigo, e deu alguns pau no composer install. Tentei arrumar, mas só piorou. Vou ficar sem escrever código por ora.
    • Isso acontece porque o cara está usando Symfony 2.6, e eu já estou no 4.
  • Criação de um EventSubscriber, e registro dele no app/config/services.yml, para o sym registrar o evento.
• https://symfonycasts.com/screencast/symfony-journey/httpkernel-handle#play
  • Interessante. O método handle() do kernel faz tudo. Toda a aplicação se resume neste método. Se chamar 2 vezes, com 2 requests diferentes, e mandar mostrar, aparece as duas páginas, uma depois da outra. LOL.
• https://symfonycasts.com/screencast/symfony-journey/httpkernel-router-listener#play
  • Sempre será: Request -> router -> Controller -> Response.
• https://symfonycasts.com/screencast/symfony-journey/determine-the-controller#play
  • Ele mostra como é passado o container para o controller.
• https://symfonycasts.com/screencast/symfony-journey/kernel.controller-and-getarguments#play
  • Ele mostra como o Symfony usa o reflection do php para passar os parâmetros para o controller.
• https://symfonycasts.com/screencast/symfony-journey/kernel.view-event#play
  • Se seu controller não retornar uma response, é disparado o evento kernel.view, ao invés do evento kernel.request.
• https://symfonycasts.com/screencast/symfony-journey/httpkernel-handle-finishing-up#play
  • Como esperado, há eventos para cada etapa do processo de mostrar a página, assim como possíveis erros, etc.
• https://symfonycasts.com/screencast/symfony-journey/magically-replace-_controller#play
• https://symfonycasts.com/screencast/symfony-journey/magically-add-controller-args#play
  • @ParamConverter
• https://symfonycasts.com/screencast/symfony-journey/sub-requests#play
  • O twig pode chamar outros contrller através do {{ render(controller('WRA')) }}. E ele faz isso de forma separada, tipo outra tread. Muito bom.
• https://symfonycasts.com/screencast/symfony-journey/sub-request-internals#play
  • Em subrequests, não se deve depender de informações do request principal.

FIM DO CURSO.

@zoiosilva legal! Siga atualizando o documento e me dando uns alôs lá no Slack, por gentileza. Valeu! 👏