OpenCart Kurulumu: cPanel ile Adım Adım OpenCart 4.1 Kurulum Rehberi

Güncel OpenCart sürümü hangisi?

1 Kasım 2026 itibarıyla OpenCart GitHub sürümler sayfasındaki en yeni kararlı sürüm 4.1.0.4'tür (11 Ağustos 2026). Aynı gün eski 3.x serisi için de 3.0.5.1 yayımlandı. 3.x serisi, yalnızca 3.x için yazılmış eski modüllere bağımlı mevcut mağazalar için güncellenmeye devam ediyor; yeni bir mağaza kuruyorsanız 4.1 serisiyle başlamanız mantıklıdır.

OpenCart sürüm numaraları MAJOR.MINOR.FEATURE.PATCH düzenindedir. Depodaki README'ye göre son hanedeki (PATCH) artışlar hata düzeltmesidir ve güncellemesi güvenli kabul edilir; FEATURE artışlarında ise üçüncü parti modüllerin bozulma riski düşüktür ama sıfır değildir.

Sistem gereksinimleri (OpenCart 4.1.0.4)

Aşağıdaki liste, 4.1.0.4 kurulum sihirbazının ikinci adımda yaptığı kontrollerden alındı. Sihirbaz bu koşullardan biri sağlanmazsa ilerlemenize izin vermez.

Bunlara ek olarak bir MySQL/MariaDB veritabanı ve bu veritabanına atanmış bir kullanıcı gerekir. Veritabanı kavramına yabancıysanız MySQL nedir rehberimize bakabilirsiniz.

1. Adım: SSL'i kurulumdan önce hazırlayın

OpenCart 4 kurulum sihirbazı mağaza adresini, kurulumu başlattığınız adresten otomatik üretir ve config.php ile admin/config.php dosyalarına HTTP_SERVER sabiti olarak yazar. Sihirbazı https:// ile açarsanız adres baştan https olarak kaydedilir. Bu yüzden önce alan adınız için SSL sertifikasının aktif olduğundan emin olun; ücretsiz sertifika için Let's Encrypt SSL kurulumu rehberine bakabilirsiniz.

2. Adım: Dosyaları indirin ve yükleyin

• İndirin: GitHub sürümler sayfasından opencart-4.1.0.4.zip dosyasını indirin.
• Doğru klasörü bulun: Zip içinde geliştirici dosyalarının yanında bir upload klasörü vardır. Sunucuya yüklenecek olan yalnızca bu klasörün içeriğidir.
• Yükleyin: cPanel Dosya Yöneticisi ile upload klasörünün içindekileri public_html/ dizinine (veya mağazanın açılacağı alt klasöre) koyun. En pratik yol, zip'i sunucuya yükleyip Dosya Yöneticisinde çıkarmak ve upload içindekileri hedef dizine taşımaktır.
• Gizli dosyayı kaçırmayın: .htaccess.txt nokta ile başladığı için Dosya Yöneticisinde gizli dosyalar gösterilmiyorsa görünmeyebilir. Ayarlardan gizli dosyaları göstermeyi açın.

Büyük zip yüklerken limit hatası alırsanız upload_max_filesize rehberimiz sorunu açıklıyor; alternatif olarak dosyaları FTP ile de gönderebilirsiniz.

3. Adım: Config dosyalarını yeniden adlandırın

OpenCart'ın resmî INSTALL.md dosyasına göre kurulumdan önce iki dosyanın adı değiştirilmelidir:

config-dist.php        ->  config.php
admin/config-dist.php  ->  admin/config.php

Sihirbaz bu iki dosyaya yazabilmelidir. INSTALL.md Linux için bu dosyalara 0777 izni verilmesini önerir. Birçok cPanel sunucusunda PHP sizin kullanıcınızla çalıştığı için varsayılan 644 izni yeterli olur; sihirbaz "writable" uyarısı verirse izni geçici olarak yükseltin ve kurulum biter bitmez 644'e geri çekin.

4. Adım: Veritabanı ve kullanıcı oluşturun

• cPanel'de MySQL Databases (veya Database Wizard) bölümünü açın.
• Yeni bir veritabanı oluşturun; cPanel adın başına hesap kullanıcı adınızı ön ek olarak ekler.
• Güçlü parolalı yeni bir veritabanı kullanıcısı oluşturun ve bu kullanıcıya veritabanı üzerinde tüm yetkileri verin.
• Veritabanı adını, kullanıcı adını ve parolayı not alın.

INSTALL.md açıkça uyarır: root kullanıcısını ve parolasını kullanmayın. Her mağaza için ayrı veritabanı ve ayrı kullanıcı tercih edin.

5. Adım: Kurulum sihirbazını çalıştırın

Tarayıcıda mağaza adresinizi açın (örneğin https://alanadiniz.com/). OpenCart kurulmamışsa sizi otomatik olarak kurulum sihirbazına yönlendirir.

• Lisans: GPLv3 lisansını okuyup devam edin.
• Ön kontrol: PHP sürümü, eklentiler ve dosya izinleri listelenir. Kırmızı satır varsa hosting panelinizden düzeltip sayfayı yenileyin.
• Yapılandırma: DB Driver olarak MySQLi veya mPDO seçin; Hostname çoğu cPanel hesabında localhost'tur, Port genellikle 3306'dır. Veritabanı bilgilerini, tablo ön ekini ve yönetici kullanıcı adı, parola ve e-postasını girin.
• Bitiş: Sihirbaz tabloları oluşturur ve config dosyalarını yazar.

6. Adım: Kurulum sonrası güvenlik

Yönetim paneline ilk girişte OpenCart, Important Security Notification! başlıklı bir pencere gösterir. Bu pencere üç işi panelden yapmanızı sağlar:

Storage klasörünün yeni adı storage ile başlamalıdır (örneğin storage_) ve web kökünün dışında olmalıdır. cPanel'de web kökü public_html olduğundan, ev dizininiz (/home/kullanici/) doğal hedeftir. Taşıma için PHP'nin bu dizine yazabilmesi ve open_basedir kısıtının ev dizinini kapsaması gerekir. Taşıma bitince panel eski storage klasörünü silmenizi de önerir.

Panel /install/ klasörünü silemezse Dosya Yöneticisi ile elle silin. INSTALL.md ayrıca şunu belirtir: içinde vendor klasörü olan derlenmiş bir paket indirdiyseniz bu klasör web kökünün bir üst dizinine, yani public_html ile aynı seviyeye yüklenmelidir.

Mağaza yayına hazır olduğunda hata mesajlarının ziyaretçilere görünmemesi için system/config/default.php dosyasındaki şu satırı değiştirin:

// Önce
$_['error_display'] = true;

// Sonra (canlı mağaza)
$_['error_display'] = false;

7. Adım: Türkçe dil ve TL para birimi

OpenCart 4.1.0.4 çekirdeğinde yalnızca İngilizce (en-gb) ve Fransızca (fr-fr) dil dosyaları bulunur; resmî bir Türkçe paket çekirdekle gelmez. Türkçe çeviriler üçüncü taraf geliştiricilerin OpenCart Marketplace'te yayımladığı dil eklentileriyle sağlanır.

• Marketplace'te bir Türkçe dil paketi seçerken OpenCart 4.1 uyumluluğunu, son güncelleme tarihini ve yorumları kontrol edin. 3.x için yazılmış paketler 4.x'te çalışmaz.
• Paket .ocmod.zip biçimindeyse Extensions > Installer sayfasından yükleyin ve kurun.
• Dili System > Localisation > Languages sayfasında etkinleştirin. Locale alanına örneğin tr_TR.UTF-8,tr_TR,tr-tr,turkish biçiminde değer girilir.
• Varsayılan dili System > Settings içindeki Local sekmesinden seçin.
• TL fiyatlandırma için System > Localisation > Currencies sayfasından ISO kodu TRY olan para birimini ekleyip varsayılan yapın.

8. Adım: SEO uyumlu URL'leri açın

OpenCart varsayılan olarak index.php?route=product/product&product_id=42 gibi adresler üretir. Okunabilir URL için iki şey gerekir: Apache mod_rewrite desteği ve .htaccess dosyası. LiteSpeed Web Server da Apache'nin .htaccess rewrite kurallarını okur.

• Web kökündeki .htaccess.txt dosyasının adını .htaccess olarak değiştirin.
• Mağaza alt klasördeyse dosyadaki RewriteBase / satırını klasöre göre düzenleyin.
• System > Settings içindeki Server sekmesinde Use SEO URLs seçeneğini açın.
• Ürün, kategori ve bilgi sayfalarının anahtar kelimelerini Design > SEO URL sayfasından veya ilgili kaydın SEO sekmesinden girin.

# .htaccess.txt dosyasından ilgili satırlar (mağaza /magaza/ altındaysa)
RewriteEngine On
RewriteBase /magaza/
RewriteRule ^system/storage/(.*) index.php?route=error/not_found [L]

Dosyanın başındaki açıklamaya göre Options +FollowSymlinks satırı bazı sunucularda hata verebilir; site açılmazsa satırın başına # koyarak devre dışı bırakın. Https yönlendirmesinden sonra döngü oluşursa ERR_TOO_MANY_REDIRECTS çözüm rehberine bakın.

9. Adım: CRON görevini kurun

OpenCart 4'te Extensions > Cron Jobs adında bir sayfa vardır; para birimi kurlarının güncellenmesi ve abonelik işlemleri gibi zamanlanmış görevler buradan yönetilir. Sayfadaki talimata göre CRON görevinin saatte bir çalışması gerekir. Örnek CRON adresi index.php?route=cron/cron biçimindedir. cPanel'deki Cron Jobs bölümüne şuna benzer bir satır ekleyebilirsiniz:

0 * * * * curl -s "https://alanadiniz.com/index.php?route=cron/cron" > /dev/null 2>&1

Ödeme ve kargo: sonraki adımlar

iyzico'nun resmî dokümanında OpenCart 4.x için iki ayrı modül (iyzico Ödeme Formu ve iyzico ile Öde) bulunur ve ikisinin de kurulması istenir; modüller Extensions > Installer ile yüklenir. PayTR'nin geliştirici sayfası da OpenCart 1.5.x, 2.x, 3.x ve 4.x sürümleri için .ocmod.zip modülü sunar. Her iki sağlayıcı da modüllerinin eklentisiz, sade OpenCart üzerinde geliştirildiğini belirtir; yoğun özelleştirilmiş temalarda önce test ortamında deneyin. API anahtarları, test modu ve 3D Secure mantığı için iyzico ödeme entegrasyonu rehberimize, kargo tarafı için kargo entegrasyonu rehberimize bakabilirsiniz.

Yasal sayfalar (mesafeli satış sözleşmesi, ön bilgilendirme formu, cayma hakkı) hangi platformu seçerseniz seçin zorunludur; listesi için e-ticaret sitesinde zorunlu sayfalar yazımıza bakın.

Sık yapılan hatalar

Karışık içerik sorununun genel çözümü için mixed content rehberimize bakabilirsiniz.

Sık Sorulan Sorular

OpenCart paylaşımlı hostingde çalışır mı?

Evet. Kurulum sihirbazının istediği PHP 8.1+, gerekli eklentiler ve bir MySQL/MariaDB veritabanı varsa cPanel'li paylaşımlı hostingde çalışır. Storage klasörünü web kökünün dışına taşıyabilmek için ev dizinine yazma izni olması önemlidir.

OpenCart 3.x mi 4.x mi kurmalıyım?

Yeni mağaza için 4.1 serisi önerilir. 3.x serisi hâlâ güncelleme alıyor, ancak asıl amacı eski modüllere bağımlı mevcut mağazaları ayakta tutmaktır. Kullanmak istediğiniz modülün 4.1 desteğini satın almadan önce kontrol edin.

Kurulumdan sonra install klasörünü silmezsem ne olur?

Panel her girişte güvenlik uyarısını göstermeye devam eder ve INSTALL.md silinmesini açıkça ister. Klasör yerinde kalırsa kurulum betikleri sunucuda erişilebilir durur; silmek birkaç saniyelik bir iştir.

Resmî bir Türkçe OpenCart paketi var mı?

4.1.0.4 çekirdeğinde Türkçe dil dosyası yoktur. Türkçe çeviriler üçüncü taraf dil eklentileriyle gelir; sürüm uyumluluğunu kontrol ederek Marketplace üzerinden seçmeniz gerekir.

Hosting panelimde tek tıkla kurulum varsa kullanabilir miyim?

Panelinizde bir uygulama yükleyici varsa kullanabilirsiniz; ancak yükleyicinin hangi OpenCart sürümünü kurduğunu kontrol edin. Bu rehberdeki kurulum sonrası güvenlik adımları (install klasörü, storage, admin adı) her iki yöntemde de geçerlidir.

Yazılım, eklenti ve hizmet adları sahiplerine aittir. Bu yazı bağımsız bir teknik rehberdir; adı geçen şirketlerle bayilik veya ortaklık ilişkisi bulunduğu anlamına gelmez.

İlgili içerikler: WooCommerce, OpenCart ve PrestaShop karşılaştırması · PrestaShop kurulumu · WooCommerce kurulumu · E-ticaret sitesi nasıl kurulur · iyzico ödeme entegrasyonu · Let's Encrypt SSL kurulumu