web application starter kit

Readme

Kit de partida de aplicativo da web

NOTA IMPORTANTE: Com o lançamento do SF4, a equipe do Symfony decidiu se aposentar Silex. Isso significa que não suportará mais novos recursos do SF4. Então, a partir de agora, sugiro usar o novo SF4 para projetos de longo prazo, pois não poderei adicionar novos recursos (SF4) a este kit de boilerplate/starter. No entanto, posso preparar um kit inicial semelhante para o SF4 em um futuro próximo, portanto, fique atento.

Um simples caldeira de aplicativos da Web para aplicações de pequena ou média escala. Incluído:

• Sistema de usuários
  • Conecte-se
  • Logout
  • Registrar
  • Redefinir senha
  • Perfil básico
  • Perfil de configurações / edição
  • Alterar a senha
• Sistema Básico de Funções do Usuário - Capacidade de atribuir funções para cada usuário
• Administração
  • Usuários
    • Visualizar
    • Editar
    • Switch / Personage
    • Remover
  • Ações do usuário
  • Postagens
• Ferramentas
  • Antevisão por e -mail - Você pode visualizar os modelos de e -mail enquanto trabalha neles (sem a necessidade de enviar e -mails de teste para todas as alterações)
  • Backup de banco de dados - backup e restaure seu esquema de banco de dados
• Erros / exceções Rastreamento - Salve as exceções / erros diretamente no banco de dados e / ou envie e -mails quando um erro ocorrer
• Estatística
• Configurações

Requisitos e ferramentas e ajudantes

• PHP> 7.0
• Compositor
• Bower
• Fixador de padrões de codificação PHP (opcional)

Configuração / desenvolvimento

• Navegue seu diretório da sua web: cd /var/www
• Crie um novo projeto: composer create-project bobalazek/web-application-starter-kit myapp --no-scripts
• Navegue dentro do aplicativo cd myapp
• Configure o banco de dados (e talvez outras coisas, se desejar)-copiar/clone app/configs/global-cal.example.php em app/configs/global-local.php e defina a configuração lá. Como alternativa, você também pode fazer o mesmo com .env.example, se desejar alterar apenas o básico (Configuração e ambiente do banco de dados).
• Execute os seguintes comandos:
  • composer install
  • bin/console orm:schema-tool:update --force (para instalar o esquema do banco de dados)
  • bower update (para instalar as dependências do front -end - você precisará instalar o Bower primeiro - se ainda não o fez)
  • bin/console application:database:hydrate-data (para hidratar alguns dados)
• Você terminou! Comece a desenvolver!

Banco de dados

• Usamos o banco de dados da doutrina
• Navegue até o diretório do seu projeto: cd /var/www/myapp
• Verifique as entidades: bin/console orm:info (Opcional)
• Atualize o esquema: bin/console orm:schema-tool:update --force
• Banco de dados atualizado!

Implantação

• Usamos o implementador
• Defina sua configuração dentro deployer/config.php e deployer/hosts.php
• dep deploy qa (ou qualquer ambiente que você queira)
• O aplicativo foi implantado no seu servidor!

Nome do aplicativo

Você deve substituir o nome do seu aplicativo real dentro dos seguintes arquivos:

• Readme.md
• Bower.json
• composer.json
• phpunit.xml
• app/configs/global.php

Login do administrador

Com o bin/console application:database:hydrate-data , você, de acordo com os usuários de hidrate 2 padrão (que você pode alterar dentro do arquivo app/fixtures/users.php ):

• Usuário administrador (com permissões de administrador)
  • Nome de usuário: admin ou [email protected]
  • Senha: test
• Usuário de teste (com as permissões de usuário padrão)
  • Nome de usuário: test ou [email protected]
  • Senha: test

Comandos

• bin/console application:environment:prepare -Criará os arquivos global-local.php e desenvolvimento-local.php (se eles não existirem)
• bin/console application:database:hydrate-data [-r|--remove-existing-data] -Hidratará as tabelas com alguns dados básicos, como: 2 usuários e 6 papéis (a bandeira --remove-existing-data irá truncar todas as tabelas antes de re-hidratá-las)
• bin/console application:storage:prepare - Preparará todas as pastas de armazenamento (var/), como: cache, logs, sessões, etc.
• bin/console application:translations:prepare - Prepara toda a sequência não traduzida em um arquivo separado (App/Locales/{Locale} /messages_unntranslated.yml). Aceita um argumento de localidade (padrão para 'en_us' -Uso: bin/console application:translations:prepare --locale de_DE ou bin/console application:translations:prepare -l de_DE )

Outros comandos

• php-cs-fixer fix . - Se você deseja que seu código seja corrigido antes de cada confirmação. Você precisará instalar o fixador de padrões de codificação PHP
• bin/simple-phpunit - Execute seus testes de phpunit

Módulos / componentes

Caso você queira criar um novo componente / módulo neste sistema, faça o seguinte (neste caso, as postagens dentro da área dos membros):

• Crie um novo provedor de controladores (como SRC/Application/ControllerProvider/Membersarea/PostscontrollerProvider.php - Plural)
  • Vincular -se às seguintes rotas:
    • Visão geral / lista:
      • Nome da rota: membros-area.posts
      • Padrão de rota / URL: (em branco)
      • Método do Controlador de Rota: Postscontroller :: Indexaction
    • Novo:
      • Nome da rota: membros-eae.posts.new
      • Padrão de rota / url: / novo
      • Método do controlador de rota: PostScontroller :: NewAction
    • Detalhe:
      • Nome da rota: members-area.posts.detail
      • Padrão de rota / url: /{id}
      • Método do Controlador de Rota: PostsController::detailAction
    • Editar:
      • Nome da rota: membros-eae.posts.edit
      • Padrão de rota /url: /{id} /editar
      • Método do Controlador de Rota: Postscontroller :: EditAction
    • Remover:
      • Nome da rota: membros-eae.posts.remove
      • Route Pattern /URL: /{id} /Remover
      • Método do controlador de rota: PostScontroller :: Removeation
• Crie um novo controlador (SRC/Application/Controller/Membersarea/Postscontroller.php - Plural)
  • Com os seguintes métodos:
    • PostScontroller :: ListAction
    • PostScontroller :: NewAction
    • PostsController::detailAction
    • PostScontroller :: EditAction
    • PostScontroller :: Removeation
• Monte as rotas do provedor do controlador para as rotas (app/core/rotas.php)
• Crie uma nova entidade (SRC/Application/Entity/Postentity.php - Singular)
• Crie um novo repositório (SRC/Application/Repository/Postrepository.php - Singular)
• Crie um novo tipo de formulário (src/aplicativo/form/type/posttype.php - singular)
• Crie modelos:
  • aplicativo/modelos/conteúdo/membros-area/posts/(plural)
    • list.html.twig
    • detail.html.twig
    • new.html.twig
    • edit.html.twig
    • remova.html.twig
    • _form.html.twig (basta incluir isso dentro da edição e novo modelo, para que você não precise escrever o mesmo formulário duas vezes - se for mais complexo)

Estrutura de arquivo

• app/
  • Configs/ => All Basic Config Stuff (+ Validação)
  • núcleo/ => os arquivos principais, como provedores, rotas, utensílios médios e definições
  • acessórios/ => usado para hidratar o banco de dados
  • Locais/ => Usado para traduções
  • modelos/ => Todos os modelos de galhos
• bin/
  • console
• src/
  • Aplicativo/
    • Comando/
    • Controlador/
    • ControllerProvider/
    • Doutrina/ => Algumas correções de doutrina para Silex
    • Entidade / => todas as entidades / modelos
    • Forma/
    • Provedor/
    • Repositório/
    • Ferramenta/
    • Galho/
• web/
  • ativos/
    • imagens/
    • JavaScripts/
    • uploads/ => usado para uploads
    • Fornecedor/ => Dependências de Bower
  • index.php

Visualização

Conecte-se

Registrar

Redefinir senha

Painel

Perfil

Configurações de perfil

Estatística

Usuários

Editar usuários

Licença

O kit inicial de aplicativos da web está licenciado sob a licença do MIT.