Joan: /* Tutorial ràpid */

2020-05-08T17:17:52Z

Tutorial ràpid

Pàgina nova

=Introducció=
*https://laravel.com/docs/7.x/
=Instal·lació=

<pre>
$ php -v
PHP 7.2.24-0ubuntu0.18.04.4 (cli)
</pre>
Instal·lo les dependències que es comenten: php-bcmath, php-gd, etc

Primer de tot, es necessita ''composer'' com a sistema d'instal·lació i resolució de dependències a PHP:
<pre>
$ sudo apt-get install composer
</pre>
i ara ja puc instal·lar Laravel, de forma global:
<pre>
$ composer global require laravel/installer

$ export PATH=$PATH:$HOME/.config/composer/vendor/bin
</pre>
I ara ja puc crear un projecte de Laravel. Ho faig amb ''composer'':
<pre>
$ composer create-project --prefer-dist laravel/laravel blog
</pre>
Local Development Server:

If you have PHP installed locally and you would like to use PHP's built-in development server to serve your application, you may use the serve Artisan command. This command will start a development server at http://localhost:8000:
<pre>
$ cd blog
$ php artisan serve
Laravel development server started: http://127.0.0.1:8000
</pre>
i efectivament ja tinc l'aplicatiu funcionant a:
*http://127.0.0.1:8000

'''Public Directory: public/'''

After installing Laravel, you should configure your web server's document / web root to be the public directory. The ''index.php'' in this directory serves as the front controller for all HTTP requests entering your application.

Tanmateix, si mirem dins del fitxer ''public/index.php'' no s'entén res. La clau està en el directori ''routes/web.php'', on es defineixen les rutes que té l'aplicatiu.
=Tutorial ràpid=
[[Fitxer:Laravel_tutorial.png | thumbnail]]
Seguim aquest video de Youtube de 45 minuts i reproduim els exercicis, '''LARAVEL essentials you need to know in 45 minutes''':
*https://www.youtube.com/watch?v=ubfxi21M1vQ&t=612s
<pre>
$ joe .env
</pre>
aquí és on hi ha la informació de la connexió a la base de dades.

Per arrencar el servidor:
<pre>
$ php artisan serve
Laravel development server started: http://127.0.0.1:8000
</pre>
I compte! El Laravel funciona amb el seu propi servidor web. Si tinc l'Apache tancat, també funciona.

El primer fitxer important és el ''routes/web.php'', on hi ha la línia:
<pre>
Route::get('/', function () {
return view('welcome');
});
</pre>
La vista ''welcome'' éstà a ''resources/welcome.blade.php'', i aquí puc veure tot el contingut de la pàgina de presentació de Laravel.

Si afegeixo aquestes línies:
<pre>
Route::get('/about', function () {
echo "hola";
});
</pre>
*http://localhost:8000/about

Per tant, el web.php funciona com una llista de totes les pàgines que tinc en l'aplicació.

==Controladors==
<pre>
$ php artisan make:controller HomeController
Controller created successfully.
</pre>
El trobem a ''App/Http/Controllers/HomeController.php''
<pre>
<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class HomeController extends Controller
{
//
}
</pre>
Defineixo la funció ''index'' que retorna la vista ''welcome'',
<pre>
class HomeController extends Controller
{
public function index() {
return view('welcome');
}
}
</pre>
i ara, a ''web.php'', com a punt d'entrada posem:
<pre>
Route::get('/','HomeController@index');
</pre>
El resultat és el mateix, però estem visualitzant la portada a través d'un controlador.

==Models (accés a bases de dades)==
<pre>
$ php artisan make:model Message
Model created successfully.
</pre>
El trobem a ''app/Message.php'':
<pre>
<?php

namespace App;

use Illuminate\Database\Eloquent\Model;

class Message extends Model
{
//
}
</pre>
''Eloquent'' és el sistema que fa servir Laravel per accedir a les bases de dades. Si vull crear taules per guardar la informació dels missatges que crearé en la meva mini-aplicació, he de fer una ''migration'':
<pre>
$ php artisan make:migration create_messages_table
Created Migration: 2020_05_08_134106_create_messages_table
</pre>
Aquesta migració la trobem a ''blog/database/migrations''. Tenim dues funcions: ''up()'' és per crear les taules; i ''down()'' és per esborrar les taules.

En la funció ''up()'' definirem tots els camps de la taula. Queda de la següent manera:
<pre>
public function up()
{
Schema::create('messages', function (Blueprint $table) {
$table->increments('id');
$table->string('title');
$table->string('content');
$table->timestamps();
});
}
</pre>
Ja podem fer el ''migrate'', i ja podem veure la taula en el mysql:

Una coseta abans. Si vull connectar-me al mysql com a ''joan'' i no com a ''root'', primer hauré de fer:
<pre>
GRANT ALL PRIVILEGES ON *.* TO 'joan'@'localhost' IDENTIFIED BY 'password';
</pre>
i ara ja puc connectar-me:
<pre>
joan@joanHP:~$ mysql -u joan -p jbalmes
mysql>
</pre>
Això és important perquè la comanda següent s'executa com a ''joan'' (recordar que llegeix les credencials per accedir a la base de dades de .env)

Faig la migració:
<pre>
$ php artisan migrate
Migration table created successfully.
Migrating: 2014_10_12_000000_create_users_table
Migrated: 2014_10_12_000000_create_users_table (0.68 seconds)
Migrating: 2019_08_19_000000_create_failed_jobs_table
Migrated: 2019_08_19_000000_create_failed_jobs_table (1.26 seconds)
Migrating: 2020_05_08_134106_create_messages_table
Migrated: 2020_05_08_134106_create_messages_table (1.39 seconds)
</pre>
Ja tinc la taula creada:
<pre>
mysql> desc messages;
+------------+---------------------+------+-----+---------+----------------+
| Field | Type | Null | Key | Default | Extra |
+------------+---------------------+------+-----+---------+----------------+
| id | bigint(20) unsigned | NO | PRI | NULL | auto_increment |
| created_at | timestamp | YES | | NULL | |
| updated_at | timestamp | YES | | NULL | |
+------------+---------------------+------+-----+---------+----------------+
</pre>
Si vull eliminar les taules farem:
<pre>
$ php artisan migrate:reset
</pre>
Creo la vista ''master'' (script ''master.blade.php'') per mostrar els meus missatges
<pre>
<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">

<title>@yield('title')</title>


<link href="https://fonts.googleapis.com/css?family=Nunito:200,600" rel="stylesheet">

</head>
<body>
@yield('content')
</body>
</html>
</pre>
i també la vista ''home'' (script ''home.blade.php'')
<pre>
@extends('master')
@section('title','Homepage')
@section('content')
<h1>Content</h1>
@endsection
</pre>
i ara com a punt d'entrada (''HomeController.php'') retorno la vista ''home'' que acabo de crear, que tindrà per missió mostrar els missatges.
<pre>
class HomeController extends Controller
{
public function index() {
return view('home');
}
}
</pre>

Necessito un parell de dades:
<pre>
mysql> insert into messages(title,content,created_at) values('mis1', 'content mis 1',now());
mysql> insert into messages(title,content,created_at) values('mis2', 'content mis 2',now());
</pre>
i ara ja puc recuperar els missatges:
<pre>
class HomeController extends Controller
{
public function index() {
$messages = Message::all();
foreach ($messages as $message) {
echo $message->title;
}die;

return view('home');
}
}
</pre>
A la vista home li puc passar tots els missatges que retorna el controlador:
<pre>
class HomeController extends Controller
{
public function index() {
$messages = Message::all();

return view('home', [
'messages' => $messages
]);
}
}
</pre>
i la manera com els processa la vista ''home'' és:
<pre>
@extends('master')
@section('title','Homepage')
@section('content')
Recent messages:
<ul>
@foreach($messages as $message)
<li><strong>{{$message->title}}</strong>
<br />
{{$message->content}}
<br />

{{$message->created_at->diffForHumans()}}
</li>
@endforeach
</ul>
@endsection
</pre>
Ara creem el formulari per introduir nous missatges:
<pre>
<form action="/create" method="post">...</form>
</pre>
creo un controlador per a processar els missatges
<pre>
$ php artisan make:controller MessageController
</pre>
i creo una nova pàgina (ruta) on s'executarà el codi del controlador:
<pre>
Route::post('/create','MessageController@create');
</pre>
(fixem-nos que utilitza el mètode post)

El tutorial s'acaba aconseguint que es creïn els missatges en el submit del formulari, i retorna a la pàgina principal (''/'') on es veu l'últim missatge creat.

Finalment, es podem visualitzar els missatges amb la vista ''message/{id}'', i es crea un link per visualitzar aquesta vista.

{{Autor}}, maig 2020

Framework Laravel - Historial de revisió

Joan: /* Tutorial ràpid */