Перейти до основного вмісту

Як встановити сайт на базі Laravel

Встановлення виконується за допомогою composer. Як приклад використовується домен example.com, а користувачем сайту є user.

Підготовка​

Встановлення Composer​

Встановіть composer у FASTPANEL® у розділі "Applications"

Меню керування Applications у FASTPANEL

Встановлення composer у FASTPANEL

Створення вебсайту​

Створіть вебсайт у FASTPANEL® і вкажіть підкаталог public у налаштуваннях сайту в розділі "Site Directory".

Указання підкаталогу public

Створення проєкту​

Щоб створити проєкт, потрібно підключитися до сервера через SSH, використовуючи дані власника сайту. Власник сайту відображається в картці сайту у FASTPANEL

Перевірка власника сайту у FASTPANEL

Після встановлення SSH-з’єднання слід очистити каталог сайту, використовуючи такий приклад команди (замість example.com вкажіть ім’я вашого сайту)

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

Потім перейдіть до каталогу сайту

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

І створіть проєкт

composer create-project laravel/laravel ./
Приклад виводу у разі правильного встановлення
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.

Встановлення певної версії Laravel​

Щоб установити певну версію, під час створення проєкту потрібно вказати версію в кінці команди в лапках

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

Підключення до бази даних​

  • Для Artisan вкажіть дані для підключення до бази даних у файлі .env у каталозі сайту
  • Для сайту вкажіть дані для підключення до бази даних у файлі ./config/database.php

Щоб відредагувати файл .env, можна використовувати текстовий редактор nano через SSH:

nano .env
Приклад .env
DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=site_db
DB_USERNAME=db_user
DB_PASSWORD=0j9vd3qATwTsXW7C

Щоб відредагувати файл ./config/database.php через SSH:

nano ./config/database.php
Приклад ./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'),
        ]) : [],
    ],

У редакторі nano для збереження змін використовується Ctrl+O, для виходу з редактора — Ctrl+X.

Підключення Memcached (необов’язково)​

Потрібно встановити модуль PHP memcached для версії PHP, яка використовується на сайті, а також установити застосунок.

Встановлення модуля PHP memcached​

Меню керування PHP у FASTPANEL

Встановлення модуля PHP memcached у FASTPANEL

Встановлення застосунку memcached​

Меню керування Applications у FASTPANEL

Встановлення застосунку memcached у FASTPANEL

Редагування файла конфігурації​

Вкажіть дані для підключення до memcached у файлі ./config/cache.php

Приклад ./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,
        ],
    ],
],

Використання Artisan із несистемною версією PHP​

Щоб використовувати artisan із несистемною версією PHP, потрібно вказати повний шлях до виконуваного файла. Приклад використання альтернативної версії PHP 8.2:

/opt/php82/bin/php artisan list

Основні команди Artisan​

Команди слід виконувати в кореневому каталозі вашого проєкту (у цьому прикладі — example.com)

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

Щоб переглянути список усіх доступних команд Artisan, можна використати команду

php artisan list

Запуск локального сервера розробки Laravel. Можна вказати ключі --host і --port

php artisan serve

Запуск міграції

php artisan migrate

Увімкнення режиму обслуговування на сайті, ключ --redirect=/ для вказання сторінки режиму обслуговування

php artisan down

Вимкнення режиму обслуговування на сайті

php artisan up