Skip to content

Commit

Permalink
Update italian.md
Browse files Browse the repository at this point in the history
  • Loading branch information
@trippo
trippo authored Sep 19, 2022
1 parent 0c3c634 commit 511b3d9
Showing 1 changed file with 42 additions and 42 deletions.
84 changes: 42 additions & 42 deletions italian.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ Translations:

Una classe e un metodo dovrebbero avere una sola responsabilità.

Male:
Sbagliato:

```php
public function getFullNameAttribute()
Expand All @@ -97,7 +97,7 @@ public function getFullNameAttribute()
}
```

Buono:
Giusto:

```php
public function getFullNameAttribute()
Expand Down Expand Up @@ -127,7 +127,7 @@ public function getFullNameShort()

Inserisci tutta la logica legata al DB nei Model Eloquent oppure nei Repository a seconda che tu stia usando il Query Builder o le query SQL raw.

Male:
Sbagliato:

```php
public function index()
Expand All @@ -142,7 +142,7 @@ public function index()
}
```

Buono:
Giusto:

```php
public function index()
Expand All @@ -169,7 +169,7 @@ class Client extends Model

Sposta le logiche di validazione dai controller alle Request class.

Male:
Sbagliato:

```php
public function store(Request $request)
Expand All @@ -184,7 +184,7 @@ public function store(Request $request)
}
```

Buono:
Giusto:

```php
public function store(PostRequest $request)
Expand All @@ -211,7 +211,7 @@ class PostRequest extends Request

Un controller deve avere una sola responsabilità, quindi sposta la logica di business dai controller alle classi di servizio.

Male:
Sbagliato:

```php
public function store(Request $request)
Expand All @@ -224,7 +224,7 @@ public function store(Request $request)
}
```

Buono:
Giusto:

```php
public function store(Request $request)
Expand All @@ -251,7 +251,7 @@ class ArticleService

Riutilizzare il codice quando è possibile. Il Principio di Singola Responsabilità (SRP) ti aiuta a evitare la duplicazione. Inoltre, riutilizza i template blade, usa gli eloquenti scopes, ecc.

Male:
Sbagliato:

```php
public function getActive()
Expand All @@ -267,7 +267,7 @@ public function getArticles()
}
```

Buono:
Giusto:

```php
public function scopeActive($q)
Expand All @@ -294,7 +294,7 @@ public function getArticles()

Eloquent ti consente di scrivere codice leggibile e manutenibile. Inoltre, Eloquent ha ottimi strumenti integrati come eliminazioni soft, eventi, scopes, ecc.

Male:
Sbagliato:

```sql
SELECT *
Expand All @@ -311,7 +311,7 @@ AND `active` = '1'
ORDER BY `created_at` DESC
```

Buono:
Giusto:

```php
Article::has('user.profile')->verified()->latest()->get();
Expand All @@ -321,7 +321,7 @@ Article::has('user.profile')->verified()->latest()->get();

### **Assegnazione di massa**

Male:
Sbagliato:

```php
$article = new Article;
Expand All @@ -333,7 +333,7 @@ $article->category_id = $category->id;
$article->save();
```

Buono:
Giusto:

```php
$category->article()->create($request->validated());
Expand All @@ -343,15 +343,15 @@ $category->article()->create($request->validated());

### **Non eseguire query nei template Blade e utilizzare l'eager loading (problema N + 1)**

Male (per 100 utenti, verranno eseguite 101 query DB):
Sbagliato (per 100 utenti, verranno eseguite 101 query DB):

```php
@foreach (User::all() as $user)
{{ $user->profile->name }}
@endforeach
```

Buono (per 100 utenti, verranno eseguite 2 query DB):
Giusto (per 100 utenti, verranno eseguite 2 query DB):

```php
$users = User::with('profile')->get();
Expand All @@ -367,7 +367,7 @@ $users = User::with('profile')->get();

### **Commenta il tuo codice, ma cerca anche di rendere autoesplicativi i nomi di metodi e variabili**

Male:
Sbagliato:

```php
if (count((array) $builder->getQuery()->joins) > 0)
Expand All @@ -380,7 +380,7 @@ Meglio:
if (count((array) $builder->getQuery()->joins) > 0)
```

Buono:
Giusto:

```php
if ($this->hasJoins())
Expand All @@ -390,7 +390,7 @@ if ($this->hasJoins())

### **Non inserire JS e CSS nei templte Blade e non inserire HTML nelle classi PHP**

Male:
Sbagliato:

```php
let article = `{{ json_encode($article) }}`;
Expand Down Expand Up @@ -418,7 +418,7 @@ Il modo migliore è utilizzare il pacchetto PHP-JS specializzato per trasferire

### **Usa file di configurazione e lingua, costanti anziché testo nel codice**

Male:
Sbagliato:

```php
public function isNormal()
Expand All @@ -429,7 +429,7 @@ public function isNormal()
return back()->with('message', 'Your article has been added!');
```

Buono:
Giusto:

```php
public function isNormal()
Expand All @@ -448,24 +448,24 @@ Favorisci l'utilizzo delle funzionalità integrate in Laravel e i pacchetti dell

Task | Strumenti standard | Strumenti di terze parti
------------ | ------------- | -------------
Autorizzazione | Politiche | Affida, Sentinel e altri pacchetti
Compiling assets | Laravel Mix, Vite | Grunt, Gulp, 3rd party packages
Ambiente di sviluppo | Laravel Sail, Fattoria | docker
Autorizzazione | Policies | Entrust, Sentinel e altri pacchetti
Compiling assets | Laravel Mix, Vite | Grunt, Gulp, pacchetti terzi
Ambiente di sviluppo | Laravel Sail, Homestead | Docker
Distribuzione | Laravel Forge | Deployer e altre soluzioni
Test unitari | PHPUnit, Mockery | Phpspec, Pest
Test del browser | Laravel Dusk | Codeception
DB | Eloquente | SQL, Doctrine
Modelli | Lama | Ramoscello
Lavorare con i dati | Collezioni Laravel | Array
Convalida del modulo | Richiedi classi | Pacchetti di terze parti, convalida nel controller
Test dal browser | Laravel Dusk | Codeception
DB | Eloquent, Query Builder | SQL, Doctrine
Template | Blade | Twig
Lavorare con i dati | Laravel collection | Array
Validazione form | Form Request | Pacchetti di terze parti, convalida nel controller
Autenticazione | Incorporato | Pacchetti di terze parti, la tua soluzione
Autenticazione API | Laravel Passport, Laravel Sanctum | Pacchetti JWT e OAuth di terze parti
Creazione dell'API | Incorporato | API Dingo e pacchetti simili
Lavorare con la struttura DB | Migrazioni | Lavorare direttamente con la struttura DB
Localizzazione | Incorporato | Pacchetti di terze parti
Interfacce utente in tempo reale | Laravel Echo, Pusher | Pacchetti di terze parti e funzionamento diretto con WebSocket
Generazione di dati di test | Classi di seminatrice, Fabbriche modello, Faker | Creazione manuale dei dati di test
Pianificazione delle attività | Utilità di pianificazione Laravel | Script e pacchetti di terze parti
Generazione di dati di test | Seeder, Model Factories, Faker | Creazione manuale dei dati di test
Pianificazione delle attività | Laravel Task Scheduler | Script e pacchetti di terze parti
DB | MySQL, PostgreSQL, SQLite, SQL Server | MongoDB

[Torna ai contenuti](#contents)
Expand All @@ -476,13 +476,13 @@ DB | MySQL, PostgreSQL, SQLite, SQL Server | MongoDB

Inoltre, segui le convenzioni di denominazione accettate dalla comunità Laravel:

Cosa | Come | Buono | Male
Cosa | Come | Giusto | Sbagliato
------------ | ------------- | ------------- | -------------
Controller | singolare | ArticleController |~~ArticlesController~~
Route | plurale | articles / 1 | ~~article/1~~
Route | plurale | articles/1 | ~~article/1~~
Named route | snake_case con notazione punto | users.show_active | ~~users.show-active, show-active-users~~
Model | singolare | User | ~~Users~~
hasOne o appartiene alla relazione | singolare | articleComment |~~articleComments, article_comment~~
Relazioni hasOne o belongsTo | singolare | articleComment |~~articleComments, article_comment~~
Tutte le altre relazioni | plurale | articleComments | ~~articleComment, article_comments~~
Tabella | plurale | article_comments | ~~article_comment, articleComments~~
Tabella pivot | nomi di modelli singolari in ordine alfabetico | article_user | ~~user_article, articles_users~~
Expand Down Expand Up @@ -510,14 +510,14 @@ FormRequest | singular | UpdateUserRequest | ~~UpdateUserFormRequest~~, ~~UserF

### **Utilizzare una sintassi più breve e più leggibile ove possibile**

Male:
Sbagliato:

```php
$request->session()->get('cart');
$request->input('name');
```

Buono:
Giusto:

```php
session('cart');
Expand Down Expand Up @@ -551,14 +551,14 @@ Common syntax | Shorter and more readable syntax

La sintassi new Class crea un accoppiamento stretto tra le classi e complica i test. Utilizzare invece il container IoC o i Facades.

Male:
Sbagliato:

```php
$user = new User;
$user->create($request->validated());
```

Buono:
Giusto:

```php
public function __construct(User $user)
Expand All @@ -577,13 +577,13 @@ $this->user->create($request->validated());

Passa i dati presenti nell'.env file ai file di configurazione e quindi usa l'helper `config ()` per prelevare i dati all'interno dell'applicazione.

Male:
Sbagliato:

```php
$apiKey = env('API_KEY');
```

Buono:
Giusto:

```php
// config/api.php
Expand All @@ -597,14 +597,14 @@ $apiKey = config('api.key');

### **Memorizza le date nel formato standard. Utilizza gli accessors e i mutators per modificare il formato della data**

Male:
Sbagliato:

```php
{{ Carbon::createFromFormat('Y-d-m H-i', $object->ordered_at)->toDateString() }}
{{ Carbon::createFromFormat('Y-d-m H-i', $object->ordered_at)->format('m-d') }}
```

Buono:
Giusto:

```php
// Model
Expand Down

0 comments on commit 511b3d9

Please sign in to comment.