cPanel’de Laravel Kurulumu Nasıl Yapılır

Son doğrulama: Eylül 2026 · cPanel 136 test hesabında Softaculous ve menü yolları denendi, Laravel adımları laravel.com resmî dokümanına göre

Laravel paylaşımlı hostingde nasıl çalışır

Laravel isteklerin tamamını public/index.php dosyasından karşılar. Laravel’in yayınlama belgesi projenin kök klasöründen yayın yapmayı açıkça yasaklar; kökte duran .env dosyası veritabanı parolasını ve uygulama anahtarını taşır. Bu yüzden cPanelde Laravel kurulumu yaparken asıl iş, alan adının yalnız public klasörünü göstermesini sağlamaktır.

İkinci fark SSH’tır. Narhost paylaşımlı hosting paketlerinde SSH erişimi yoktur; composer ve php artisan komutlarını bilgisayarınızda çalıştırıp sonucu yüklersiniz. Kalıcı olarak Artisan, kuyruk işçisi ya da SSH gerektiren bir uygulama kuruyorsanız VPS daha uygun bir ortamdır.

Adım adım cPanelde Laravel kurulumu

Yöntem 1 — Softaculous (hazır iskelet)

1. cPanel → Yazılım → Softaculous Apps Installer → Laravel sayfasını açıp Yükle’ye tıklayın. Eylül 2026 itibarıyla listede Laravel 11 ve 10 sürümleri bulunur; en güncel sürüm gerekiyorsa Yöntem 2’yi kullanın.
   

   

   Beklenen sonuç: protokol, alan adı, dizin ve sürüm seçilen kurulum formu açılır.

2. Alan adını seçin, dizini boş bırakın ve Yükle’ye basın. Gelişmiş Seçenekler altındaki veritabanını Softaculous kendisi oluşturur. Genel uygulama kurulumunun ayrıntıları Softaculous kartında.

   Beklenen sonuç: kurulum tamamlanır ve adres verilir. Adres Laravel karşılama sayfası yerine dizin listesi ya da 403 gösteriyorsa Yöntem 2’deki belge kökü adımını uygulayın.

Yöntem 2 — Yerelde hazırlayıp yükleme (önerilen)

1. Projeyi bilgisayarınızda hazırlayın. Yeni proje için:

   composer create-project laravel/laravel proje
   cd proje
   composer install --no-dev --optimize-autoloader

   Beklenen sonuç: vendor klasörü oluşur. create-project uygulama anahtarını kendisi üretir; .env içindeki APP_KEY satırı dolu gelir.

2. ZIP’leyip ana dizine yükleyin. Klasörü vendor dahil sıkıştırın ve Dosya Yöneticisi’nde public_html dışına, ana dizine yükleyip çıkarın; sonuç /home/kullanici/laravel gibi bir klasör olmalı.
   

   

   Beklenen sonuç: laravel klasöründe app, public, storage, vendor ve .env görünür.

3. Belge kökünü public klasörüne bağlayın. Eklenti alan adı ya da alt alan adıysa cPanel → Alan Adları → Alan Adları → Yönet sayfasında belge köküne laravel/public yazıp güncelleyin. cPanel belgesine göre ana alan adının belge kökü değiştirilemez; ana alan adında projeyi public_html/laravel altına koyup public_html/.htaccess dosyasına şunu yazın:
   

   

   RewriteEngine On
   RewriteRule ^(.*)$ laravel/public/$1 [L]

   Beklenen sonuç: alan adı Laravel karşılama sayfasını açar.

4. .env dosyasını üretime göre düzenleyin. Laravel varsayılan olarak SQLite ile gelir; MySQL’e çevirin:

   APP_ENV=production
   APP_DEBUG=false
   APP_URL=https://ornek.com
   DB_CONNECTION=mysql
   DB_HOST=localhost
   DB_DATABASE=kullanici_laravel
   DB_USERNAME=kullanici_laravel
   DB_PASSWORD=parolaniz

   Beklenen sonuç: hata sayfaları ayrıntı göstermez, uygulama veritabanına bağlanır.

5. Tabloları oluşturun. Migration’ları yerelde çalıştırıp veritabanını phpMyAdmin ile içe aktarın ya da Remote MySQL ile IP’nize izin verip php artisan migrate komutunu bilgisayarınızdan sunucu veritabanına yöneltin. Yerelde php artisan config:cache çalıştırmayın; önbellek dosyası bilgisayarınızın klasör yollarını taşır.

   Beklenen sonuç: phpMyAdmin’de migrations ve users tabloları görünür.

Doğrulama

Hâlâ çözülmediyse

• 500 hatası ya da beyaz sayfa.storage ve bootstrap/cache klasörleri yazılabilir değildir ya da PHP sürümü düşüktür; klasörleri 755 yapın ve hata günlüklerine bakın.
• No application encryption key has been specified.APP_KEY boş kalmıştır; yerel .env dosyanızdaki değeri kopyalayın.
• SQLSTATE[HY000] [1045] Access denied. Veritabanı adı ya da kullanıcısı öneksiz yazılmıştır; cPanel’deki tam adı kullanın.
• Ana sayfa açılıyor, diğer sayfalar 404.public/.htaccess dosyası ZIP’e girmemiştir; gizli dosyaları dahil ederek yeniden yükleyin.