codificio/carpentree-boilerplate

The Carpentree Framework.

v1.0.2 2019-03-06 14:29 UTC

Requires

• php: ^7.1.3
• codificio/carpentree-blog: ~0.1.0
• codificio/carpentree-core: ~0.1.0
• fideloper/proxy: ^4.0
• laravel/framework: 5.7.*
• laravel/tinker: ^1.0
• predis/predis: ^1.1

Requires (Dev)

• beyondcode/laravel-dump-server: ^1.0
• filp/whoops: ^2.0
• fzaninotto/faker: ^1.4
• mockery/mockery: ^1.0
• nunomaduro/collision: ^2.0
• phpunit/phpunit: ^7.0

MIT

• framework
• laravel
• carpentree

README

Getting started

Ambiente di sviluppo - Docker

Copiare il file env-example dentro la cartella laradock e nominarlo .env.

Aprire il file .env, cercare la seguente riga ed inserire il nome del proprio progetto (deve essere univoco):

DATA_PATH_HOST=~/.laradock/{nome-del-progetto}/data

Analogamente, modificare la seguente riga. Al posto di laradock inserire il nome del proprio progetto.

COMPOSE_PROJECT_NAME=laradock

Avvio dei container

Avviare i container Docker come spiegato qui.

Installazione dipendenze

NPM

ATTENZIONE! Questo comando si consiglia di eseguirlo nella console della macchina locale per questioni di performace. Se si eseguissero gli script npm all'interno del container Docker infatti, la velocità di esecuzione sarebbe gravemente compromessa.

$ npm install

Composer

Accedere alla bash del container come spiegato qui.

$ composer update

Inizializzazione Laravel

File ENV

Copiare il file .env.carpentree.example e rinominarlo in .env, quindi modificarne i parametri in base alle necessità.

Accedere alla bash del container come spiegato qui.

Migrazioni e seeding del database

$ php artisan migrate --seed

Inizializzazione Passport

Passport è la componente che si occupa dell'autenticazione, questo comando inizializza i dati nel database:

$ php artisan passport:install

Inizializzazione permessi

I permessi in Carpentree sono impostati in un file di configurazione, per trasferire le informazione nel database, eseguire:

$ php artisan carpentree:refresh-permissions

Link simbolico allo storage pubblico

php artisan storage:link

Docker

L'infrasttruttura Docker è basata su Laradock.

In questo boilerplate, i file di Docker sono nella directory laradock.

Avvio dei container

Con il seguente comando vengono avviati solamente i container indispensabili per far girare Carpentree.

Dalla cartella laradock:

$ docker-compose up -d nginx mysql workspace redis

Se dovessero servire altri servizi, fare riferimento alla documentazione di Laradock per maggiori informazioni.

Accesso alla bash

Dalla cartella laradock:

$ docker-compose exec --user=laradock workspace bash

Stop dei container

Dalla cartella laradock:

$ docker-compose stop