Laravel portál alapbeállítása shared hostingon (.env, composer.phar, .htaccess)

1. Függőségek

Shared hostingon gyakran nincs globális composer, ezért a composer.phar-t használjuk (lásd „composer.phar letöltése és alias”):

php composer.phar install --no-dev --optimize-autoloader

Ha a composer nem a jó PHP verzióval fut, add meg a teljes útvonalat:

/opt/cpanel/ea-php83/root/usr/bin/php composer.phar install --no-dev

(Lásd: „Rendszer-PHP eltér a MultiPHP-ben beállítottól”.)

2. .env

cp .env.example .env
nano .env

Minimum:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com

DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=...
DB_USERNAME=...
DB_PASSWORD="..."

Speciális karaktert tartalmazó jelszót tegyél idézőjelbe. A .env UTF-8 legyen, BOM nélkül.

3. App key

php artisan key:generate

4. Adatbázis

php artisan migrate --force
# tesztkörnyezetben, mintaadatokkal:
php artisan migrate:fresh --seed

SQL hibák: „SQLSTATE 1071: Specified key was too long”, „SQLSTATE 1045: Access denied”.

5. Storage link

php artisan storage:link

Ha nem megy: „storage:link nem működik (Linux és Windows)”.

6. .htaccess

Ha a document root nem állítható a public mappára, a public_html/.htaccess irányítson át (lásd „Laravel almappában shared hostingon”). cPanelen ellenőrizd a PHP handlert is:

<IfModule mime_module>
  AddHandler application/x-httpd-alt-php83 .php .php8 .phtml
</IfModule>

7. Admin user (Filament)

php artisan make:filament-user

Élesben a User modell canAccessPanel() metódusa dönti el, ki léphet be — enélkül 403-at kapsz.

8. Cache élesítéskor

php artisan optimize

Ha valami furcsán viselkedik: php artisan optimize:clear.