maurouberti / blog
This package is not auto-updated.
Last update: 2025-08-03 10:02:54 UTC
README
Passo 1 - Criar um projeto laravel
composer create-project laravel/laravel {nome_projeto}
Entre na diretório do projeto que acabou de criar.
Passo 2 - Instalar Laravel-Modules
nwidart/laravel-modules é um pacote do Laravel que foi criado para gerenciar módulos.
Instalar
Para instalar através do composer, execute o seguinte comando:
composer require nwidart/laravel-modules
Será criada a paste vendor/nwidart
Registrar
Registre um provedor de serviços e um alias adicionando no arquivo config/app.php as seguintes linhas:
/*
|--------------------------------------------------------------------------
| Autoloaded Service Providers
|--------------------------------------------------------------------------
|
*/
'providers' => [
/*
* Package Service Providers...
*/
Nwidart\Modules\LaravelModulesServiceProvider::class,
],
/*
|--------------------------------------------------------------------------
| Class Aliases
|--------------------------------------------------------------------------
|
*/
'aliases' => [
'Module' => Nwidart\Modules\Facades\Module::class,
],
Publicar
Publique o arquivo de configuração do pacote executando:
php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"
No arquivo config/moduloes.php que foi criado, altere o nomespace:
/*
|--------------------------------------------------------------------------
| Module Namespace
|--------------------------------------------------------------------------
|
| Default module namespace.
|
*/
'namespace' => '{namespace_modulo}',
Autoloading
Por padrão, as classes do módulo não são carregadas automaticamente. Para carregar automaticamente os módulos altere o arquivo composer.json:
"autoload": {
"psr-4": {
"App\\": "app/",
"{namespace_modulo}\\": "Modules/"
}
},
Para gerar o autoload execute o seguinte comando:
composer dump-autoload
Obs.: Para listar os camandos artisan do nwidart/laravel-modules digite:
php artisan module
Passo 3: Criar módulo
Criar módulo usando o comando:
php artisan module:make {nome_modulo}
Será criado uma pasta Modules/{nome_modulo}
Testar
Suba o servidor
php artisan serve
Acesse o novo módulo pelo browser:
http://localhost:8000/blog
Passo 4: Criar banco de dados
Crie um bando de dados:
echo "create database {nome_banco_dados};" | mysql -u root -p
Altere o arquivo .env:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE={nome_banco_dados}
DB_USERNAME={usuario_banco_dados}
DB_PASSWORD={senha_banco_dados}
Passo 5: Criar migrations
Para criar uma migration execute o camando artisan do nwidart/laravel-modules:
php artisan module:make-migration create_{nome_tabela}_table {none_modulo}
Será criado uma migration na pasta Modules/{nome_modulo}/Database/Migrations, altere o arquivo criado com os campos necessários.
Execute a migration com o camando artisan do nwidart/laravel-modules:
php artisan module:migrate {nome_modulo}
Passo7: Criar model
Para criar uma model execute o camando artisan do nwidart/laravel-modules:
php artisan module:make-model {nome_model} {nome_modulo}
Será criado uma model na pasta **Modules/{nome_modulo}/Entities/{nome_model}
Passo 8: Criar seed
Para criar uma seed execute o camando artisan do nwidart/laravel-modules:
php artisan module:make-seed {nome_seed} {nome_modulo}
Será criado uma seed na pasta Modules/{nome_modulo}/Database/Seeders/, altere o arquivo criado e registre ela no arquivoDatabaseSeeder.php do módulo
$this->call("{nome_seed}");
Execute a seed com o camando artisan do nwidart/laravel-modules:
php artisan module:seed {nome_modulo}
ou individualmente pelo comando:
php artisan module:seed --class={nome_seed} {nome_modulo}
Passo 9: Criar controller
Para criar uma controller execute o camando artisan do nwidart/laravel-modules:
php artisan module:make-controller {nome_controller} {nome_modulo}
Será criado um controller na pasta Modules/{nome_modulo}/Http/Controllers
Passo 10: Arquivo de rota
O arquivo route do módulo:
Modules/{nome_modulo}/Http/routes.php
Passo 11: Publicar com git
Alterar o arquivo Modules/{nome_modulo}/composer.json do módulo:
{
"name": "{usuario_git}/blog",
"description": "",
"authors": [
{
"name": "{nome_autor}",
"email": "{email_autor}"
}
],
"extra": {
"laravel": {
"providers": [
"{spacename_modulo}\\{nome_modulo}\\Providers\\{service_provider}"
],
"aliases": {
}
}
},
"autoload": {
"psr-4": {
"{spacename_modulo}\\{nome_modulo}\\": ""
}
}
}
Entrar no diretório do módulo {projeto}/Modules/{nome_modulo}, e executar o comando do git para inicializar o repositório do git:
git init
Execute o comando git status
Para adicionar arquivos, executar o comando:
git add .
Dar um Commit nos arquivos:
git commit -m "{descricao}"
Talvez não tenha registrado as credenciais no git git config --global user.name "{nome}" git config --global user.email "{email}" git checkout -b "master"
Entrar na conta do github
Criar um repositório
Enviar os arquivos com os camandos do git
git remote add origin https://github.com/{usuario_git}/{repositorio_git}.git
git push -u origin master
Para colocar versão no github, abrir a opção releases, clicar no botão createa new realise, no campo tag version colocar v1.0.0 e clicar no botão Publish realise
Passo 12: Criando pacote com packagist
Entre na conta do packagist
Na opção submit coloque o link do seu projeto no git
Repository URL (Git/Svn/Hg) ex.: https://github.com/{usuario_git}/{repositorio_git}
Clique em check, e se der tudo certo clicque em submit
Agora ir na opção profile e no botão show api token para gerar o token do packagist
No github, para ativar o auto-update, selecione settings, depois Integrations & services, clique no botão add service e localize packagist, no campo token cole o token gerado no packagist e clique no botão add service, na tela que aparecer clique no botão edit do packagiste depois no botão Test service, aparecera a seguinte mensagem:
Okay, the test payload is on its way. Note que no site do packagist a mensagem:
This package is not auto-updated. Please set up the GitHub Service Hook for Packagist so that it gets updated whenever you push!
vai desaparecer, e note o comando do composer para instalar
composer require maurouberti/blog
Passo 13: Instalar módulo criado em outro projeto
Repita o Passo 1 e Passo 2 para criar um novo projeto
Altere o arquivo config/modules.php, altere o enabled do scan para true:
'scan' => [
'enabled' => true,
'paths' => [
base_path('vendor/*/*'),
],
],
Para instalar módulo criado através do composer, execute o seguinte comando:
composer require maurouberti/blog
ou pelo github:
php artisan module:install maurouberti/laravel_modules --type=github
ou se tiver feito o packagist:
php artisan module:install maurouberti/blog
Para listar os modulos:
php artisan module:list
Execute as migrations e seeder:
php artisan module:migrate {nome_modulo}
php artisan module:seed {nome_modulo}
Observação: não sera criada a pasta Modules no projeto, esta localizada na pasta vendor
Sequência
Comandos:
composer create-project laravel/laravel projeto1
cd projeto1
composer require nwidart/laravel-modules
Registrar provedor de serviço e um alias no arquivo config/app.php :
'providers' => [
Nwidart\Modules\LaravelModulesServiceProvider::class,
],
'aliases' => [
'Module' => Nwidart\Modules\Facades\Module::class,
],
Comandos:
php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"
Alterar namespace no arquivo config/moduloes.php:
'namespace' => 'Son',
Adicionar no arquivo composer.json:
"autoload": {
"psr-4": {
"App\\": "app/",
"Son\\": "Modules/"
}
},
Comandos:
composer dump-autoload
php artisan module:make Blog
echo "create database laravel_modules;" | mysql -u root -p
Alterar arquivo .env:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_modules
DB_USERNAME=root
DB_PASSWORD=123456
Comandos:
php artisan module:make-migration create_posts_table Blog
php artisan module:migrate Blog
php artisan module:make-model Post Blog
php artisan module:make-seed Posts Blog
php artisan module:seed Blog
php artisan module:make-controller PostsController Blog
Alterar arquivo composer.json
{
"name": "maurouberti/blog",
"description": "",
"authors": [
{
"name": "Mauro Uberti",
"email": "mauro.uberti@gmail.com"
}
],
"extra": {
"laravel": {
"providers": [
"Son\\Blog\\Providers\\BlogServiceProvider"
],
"aliases": {
}
}
},
"autoload": {
"psr-4": {
"Son\\Blog\\": ""
}
}
}
Comandos:
cd Modules
cd Blob
git init
git add .
git commit -m "Primeiro commit"
git remote add origin https://github.com/maurouberti/laravel_modules.git
git push -u origin master