Ves al contingut principal

Com instal·lar un lloc basat en Laravel

La instal·lació es fa amb composer. El domini utilitzat com a exemple és example.com i l'usuari del lloc és user.

Preparació​

Instal·lació de Composer​

Instal·leu composer a FASTPANEL® a la secció "Aplicacions"

Menú de gestió d'aplicacions a FASTPANEL

Instal·lació de composer a FASTPANEL

Creació d'un lloc web​

Creeu un lloc web a FASTPANEL® i especifiqueu el subdirectori public a la configuració del lloc, a la secció "Directori del lloc".

Especificació del subdirectori public

Creació d'un projecte​

Per crear un projecte, heu de connectar-vos al servidor mitjançant SSH utilitzant les dades del propietari del lloc. El propietari del lloc es mostra a la targeta del lloc a FASTPANEL

Comprovació del propietari del lloc a FASTPANEL

Un cop establerta la connexió SSH, heu de netejar el directori del lloc utilitzant l'exemple d'ordre següent (en lloc de example.com especifiqueu el nom del vostre lloc)

rm -rf /var/www/user/data/www/example.com/*

A continuació, aneu al directori del lloc

cd /var/www/user/data/www/example.com

I creeu un projecte

composer create-project laravel/laravel ./
Exemple de sortida en cas d'instal·lació correcta
73 package suggestions were added by new dependencies, use `composer suggest` to see details.
Package fruitcake/laravel-cors is abandoned, you should avoid using it. No replacement was suggested.
Package swiftmailer/swiftmailer is abandoned, you should avoid using it. Use symfony/mailer instead.
Generating optimized autoload files
> Illuminate\Foundation\ComposerScripts::postAutoloadDump
> @php artisan package:discover --ansi
Discovered Package: facade/ignition
Discovered Package: fruitcake/laravel-cors
Discovered Package: laravel/sail
Discovered Package: laravel/sanctum
Discovered Package: laravel/tinker
Discovered Package: nesbot/carbon
Discovered Package: nunomaduro/collision
Package manifest generated successfully.
76 packages you are using are looking for funding.
Use the `composer fund` command to find out more!
> @php artisan vendor:publish --tag=laravel-assets --ansi --force
No publishable resources for tag [laravel-assets].
Publishing complete.
No security vulnerability advisories found
> @php artisan key:generate --ansi
Application key set successfully.

Instal·lació d'una versió específica de Laravel​

Per instal·lar una versió específica, en crear un projecte, heu d'especificar la versió al final de l'ordre entre cometes

composer create-project laravel/laravel ./ "5.8.*"

Connexió a la base de dades​

  • Per a artisan, especifiqueu les dades per connectar-vos a la base de dades al fitxer.env al directori del lloc
  • Per al lloc, especifiqueu les dades per connectar-vos a la base de dades al fitxer ./config/database.php

Per editar el fitxer .env, podeu utilitzar un editor de text anomenat nano mitjançant SSH:

nano .env
Exemple de .env
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=site_db
DB_USERNAME=db_user
DB_PASSWORD=0j9vd3qATwTsXW7C

Per editar el fitxer ./config/database.php mitjançant SSH:

nano ./config/database.php
Exemple de ./config/database.php
    'mysql' => [
        'driver' => 'mysql',
        'url' => env('DATABASE_URL'),
        'host' => env('DB_HOST', 'localhost'),
        'port' => env('DB_PORT', '3306'),
        'database' => env('DB_DATABASE', 'site_db'),
        'username' => env('DB_USERNAME', 'db_user'),
        'password' => env('DB_PASSWORD', '0j9vd3qATwTsXW7C'),
        'unix_socket' => env('DB_SOCKET', ''),
        'charset' => 'utf8mb4',
        'collation' => 'utf8mb4_unicode_ci',
        'prefix' => '',
        'prefix_indexes' => true,
        'strict' => true,
        'engine' => null,
        'options' => extension_loaded('pdo_mysql') ? array_filter([
            PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
        ]) : [],
    ],

A l'editor nano, Ctrl+O s'utilitza per desar els canvis i Ctrl+X s'utilitza per sortir de l'editor.

Connexió a Memcached (opcional)​

Heu d'instal·lar el mòdul PHP memcached per a la versió de PHP utilitzada al lloc, així com instal·lar l'aplicació.

Instal·lació del mòdul PHP memcached​

Menú de gestió de PHP a FASTPANEL

Instal·lar el mòdul PHP memcached a FASTPANEL

Instal·lació de l'aplicació memcached​

Menú de gestió d'aplicacions a FASTPANEL

Instal·lar l'aplicació memcached a FASTPANEL

Edició d'un fitxer de configuració​

Especifiqueu les dades per connectar-vos a memcached al fitxer ./config/cache.php

Exemple de ./config/cache.php
'memcached' => [
    'driver' => 'memcached',
    'persistent_id' => env('MEMCACHED_PERSISTENT_ID'),
    'sasl' => [
        env('MEMCACHED_USERNAME'),
        env('MEMCACHED_PASSWORD'),
    ],
    'options' => [
        // Memcached::OPT_CONNECT_TIMEOUT => 2000,
    ],
    'servers' => [
        [
            'host' => env('MEMCACHED_HOST', '127.0.0.1'),
            'port' => env('MEMCACHED_PORT', 11211),
            'weight' => 100,
        ],
    ],
],

Ús d'Artisan en una versió no del sistema de PHP​

Per utilitzar artisan en una versió no del sistema de PHP, heu d'especificar la ruta completa al fitxer executable. Exemple d'ús d'una versió alternativa de PHP 8.2:

/opt/php82/bin/php artisan list

Ordres bàsiques d'Artisan​

Les ordres s'han d'executar al directori arrel del vostre projecte (example.com en aquest exemple)

cd /var/www/user/data/www/example.com

Per veure una llista de totes les ordres d'Artisan disponibles, podeu utilitzar l'ordre

php artisan list

Inicia un servidor de desenvolupament local de Laravel. Podeu especificar les claus --host i --port

php artisan serve

Inicia la migració

php artisan migrate

Activació del mode de manteniment al lloc, clau --redirect=/ per especificar la pàgina del mode de manteniment

php artisan down

Desactivació del mode de manteniment al lloc

php artisan up