Como instalar um site baseado em Laravel

A instalação é feita usando o composer. O domínio usado como exemplo é example.com e o usuário do site é user.

Preparação

Instalando o Composer

Instale o composer no FASTPANEL^® na seção "Aplicações"

Criando um site

Crie um site no FASTPANEL^® e especifique o subdiretório public nas configurações do site na seção "Diretório do site".

Criando um projeto

Para criar um projeto, você precisa se conectar ao servidor via SSH usando os dados do proprietário do site. O proprietário do site é mostrado no cartão do site no FASTPANEL

Após estabelecer a conexão SSH, você deve limpar o diretório do site usando o exemplo de comando a seguir (em vez de example.com, especifique o nome do seu site)

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

Em seguida, vá para o diretório do site

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

E crie um projeto

composer create-project laravel/laravel ./

Exemplo de saída em caso de instalação correta

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.

Instalando uma versão específica do Laravel

Para instalar uma versão específica, ao criar um projeto, você deve especificar a versão no final do comando entre aspas

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

Conexão com o banco de dados

• Para o Artisan, especifique os dados de conexão com o banco de dados no arquivo .env no diretório do site
• Para o site, especifique os dados para conexão com o banco de dados no arquivo ./config/database.php

Para editar o arquivo .env, você pode usar um editor de texto chamado nano via SSH:

nano .env

Exemplo de .env

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=site_db
DB_USERNAME=db_user
DB_PASSWORD=0j9vd3qATwTsXW7C

Para editar o arquivo ./config/database.php via SSH:

nano ./config/database.php

Exemplo 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'),
        ]) : [],
    ],

No editor nano, Ctrl+O é usado para salvar as alterações, Ctrl+X é usado para sair do editor.

Conexão com Memcached (opcional)

Você precisa instalar o módulo PHP memcached para a versão do PHP usada no site, bem como instalar a aplicação.

Instalando o módulo PHP memcached

Instalando a aplicação memcached

Editando um arquivo de configuração

Especifique os dados para conexão com o memcached no arquivo ./config/cache.php

Exemplo 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,
        ],
    ],
],

Usando o Artisan em uma versão não padrão do PHP

Para usar o artisan em uma versão não padrão do PHP, você deve especificar o caminho completo para o arquivo executável. Exemplo de uso de uma versão alternativa do PHP 8.2:

/opt/php82/bin/php artisan list

Comandos básicos do Artisan

Os comandos devem ser executados no diretório raiz do seu projeto (example.com neste exemplo)

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

Para ver uma lista de todos os comandos do Artisan disponíveis, você pode usar o comando

php artisan list

Inicie um servidor de desenvolvimento local do Laravel. Você pode especificar as chaves --host e --port

php artisan serve

Iniciar migração

php artisan migrate

Ativando o modo de manutenção no site, chave --redirect=/ para especificar a página do modo de manutenção

php artisan down

Desativando o modo de manutenção no site

php artisan up