# Dosya Yöneticisi

Kaynak: <https://deckpa.com/docs/files>

> Sitenin dosyalarını tarayıcıdan gezin, düzenleyin, yükleyin ve izinlerini onarın; tüm işlemler site kullanıcısının yetkisiyle yapılır.

## Erişim ve kapsam

Dosya Yöneticisi'ni iki yoldan açabilirsiniz: kenar menüde **Site Merkezi → Dosya Yöneticisi** sayfasından ya da bir sitenin içindeki **Dosyalar** sekmesinden (bkz. [Site Merkezi](https://deckpa.com/docs/site-hub)). Sayfanın üstündeki **Site** listesinden hangi sitenin dosyalarına bakacağınızı seçersiniz; liste yalnızca yetkili olduğunuz siteleri içerir. Henüz site yoksa sayfa, önce **Siteler** sayfasından bir site oluşturmanızı ister.

Erişim sitenin ev dizini ile sınırlıdır (örneğin `/home/example.com/`). Belge kökü bu dizindeki `public_html` klasörüdür; alt alan adlarının belge kökleri de varsayılan olarak aynı ev dizininin içinde durur. Sitenin dışına işaret eden kısayollar (günlük ve yedek dizinleri gibi) listede gösterilmez. Yedekleri ve logları bu ekranda değil, **Yedek** ve **Loglar** bölümlerinde bulursunuz.

> Dosya Yöneticisi'ndeki her işlem, sunucu yöneticisi (root) olarak değil, sitenin kendi Linux kullanıcısı olarak yapılır. İstenen yol sitenin kökünün dışına çıkamaz; kısayollar çözülerek de denetlenir. Burada oluşturduğunuz dosyalar da otomatik olarak site kullanıcısına ait olur.

## Gezinme ve arama

Ekran üç bölümlüdür: solda **Klasörler** ağacı, ortada açık klasörün listesi, sağda editör. Listede **Ad**, **Boyut** ve **Değiştirilme** başlıklarına tıklayarak sıralamayı değiştirirsiniz; üstteki yol çubuğundaki bölümlere tıklayarak üst klasörlere dönersiniz.

Bir satıra sağ tıkladığınızda o öğenin işlem menüsü açılır: **Aç** ya da **Düzenle**, **İndir**, **Yeniden adlandır**, **Kopyala**, **Arşivi aç**, **Sıkıştır**, **İzinler** ve **Sil**. Bir klasörü indirdiğinizde klasör **İndir (.tar.gz)** olarak tek arşivde gelir.

Arama kutusunun yanındaki **İçerik** ve **Ad** düğmeleri aramanın türünü seçer: ilki dosyaların içindeki metni, ikincisi dosya ve klasör adlarını arar. Arama için en az 2 karakter girip Enter'a basın. Arama yalnızca o anda açık olan klasörde yapılır; tüm sitede aramak için önce kök klasöre dönün. Sonuç listesi en çok 300 satır gösterir, bir dosyada en çok 40 eşleşme listelenir ve arama 12 saniyeyle sınırlıdır; çok büyük sitelerde aramayı bir alt klasöre daraltın. İçerik araması arşivleri, görselleri, ses ve video dosyalarını, yazı tiplerini ve çalıştırılabilir dosyaları atlar. Aramadan çıkmak için **Temizle** düğmesini kullanın.

## Düzenleme

Bir metin dosyasına tıkladığınızda dosya sağdaki kod editöründe açılır. Editör `.php`, `.js`, `.css`, `.html`, `.yml` ve `.sql` gibi dosyalarda sözdizimini renklendirir. **Kaydet** düğmesi ya da Ctrl+S ile kaydedersiniz; Ctrl+F dosya içinde arama kutusunu açar. **Değişiklikler** düğmesi, dosyanın son kaydedilmiş hâliyle şu anki hâlini yan yana gösterir; kaydetmeden önce neyi değiştirdiğinizi buradan kontrol edebilirsiniz.

- **Sözdizimi uyarısı** — parantez ya da tırnak eksik kaldıysa ya da bir `json` dosyası geçersizse editör kaydetmeden önce uyarır. **Yine de kaydet** ile devam edebilirsiniz.
- **Kaydedilmemiş değişiklik** — başka bir dosya açarken ya da siteyi değiştirirken kaydedilmemiş değişiklik varsa panel sizi uyarır.
- **Görseller** — görsel dosyaları (`.png`, `.jpg`, `.gif`, `.webp`, `.svg` gibi) editör alanında önizlenir.
- **.htaccess** — bu dosyayı kaydettiğinizde panel, web sunucusunun kuralları yeniden okumasını kendisi tetikler.

Editörde yalnızca metin dosyaları açılır. İkili bir dosya ya da 768 KiB'dan büyük bir metin dosyası açılmaz; bunları indirip bilgisayarınızda düzenleyin ve yeniden yükleyin.

## Yükleme, arşiv ve toplu işlemler

Araç çubuğundaki **Yeni dosya** ve **Yeni klasör** boş bir öğe oluşturur. **Yükle** düğmesiyle bir ya da birden çok dosya seçebilir, dosyaları doğrudan liste alanına sürükleyip bırakabilirsiniz; dosyalar o anda açık olan klasöre yüklenir. Arama sonuçları açıkken yükleme yapılamaz, önce aramadan çıkmanız gerekir. Tek bir dosya en çok 512 MiB olabilir; yükleme sırasında ilerleme çubuğu görünür.

- **Sıkıştır** — bir dosya ya da klasörü `.zip` veya `.tar.gz` olarak, kaynağın yanına `<ad>.zip` ya da `<ad>.tar.gz` adıyla yazar. Aynı adda bir dosya varsa işlem reddedilir; önce onu taşıyın ya da silin. Sitenin kök klasörü sıkıştırılamaz.
- **Arşivi aç** — `.zip`, `.tar.gz`, `.tgz` ve `.tar` arşivlerini arşivin bulunduğu klasöre açar. Aynı adda dosyalar varsa üzerine yazılmaz, mevcut olanlar korunur. Arşivin açılmış boyutu 20 GiB'ı aşıyorsa ya da diskte açılmış boyutun yaklaşık 1,3 katı kadar boş yer yoksa işlem başlamadan reddedilir.
- **Toplu işlemler** — satırların başındaki kutularla birden çok öğe seçtiğinizde üstte **{n} öğe seçili** çubuğu görünür. Buradan seçilenleri **Taşı** (klasör seçici açılır), **Arşivle** (açık klasörde zaman damgalı tek bir `.tar.gz` oluşturur), **İzinler** ya da **Sil** ile işleyebilirsiniz. Tek seferde en çok 300 öğe seçilebilir. Her öğe ayrı denetlenir; bazıları reddedilirse panel kaç öğenin başarılı olduğunu bildirir.

## İzinler

Bir satırın **İzinler** menüsü, **Sahip**, **Grup** ve **Diğerleri** için **Oku**, **Yaz** ve **Çalıştır** kutularını ve eşdeğer sekizlik değeri (örneğin 644) gösterir. Kutularla ya da sekizlik alanla değer verebilirsiniz; 000 ile 777 arasındaki değerler kabul edilir. Dosya ve klasörü birlikte seçip toplu izin verirken panel iki ayrı ızgara gösterir, çünkü klasöre dosya izni vermek çalıştırma bitini siler ve klasörün içine girilemez hâle gelir.

Araç çubuğundaki **İzinleri Onar** düğmesi tüm siteyi tek adımda düzeltir: dosyalar 644, klasörler 755 olur ve sahiplik site kullanıcısına verilir. Siteyi dışarıdan kopyaladıysanız ya da bir yükleme sonrası 403 veya 500 hatası almaya başladıysanız ilk denenecek işlem budur.

> Silme geri alınamaz: panelde çöp kutusu yoktur ve onaydan sonra öğe kalıcı olarak silinir. Büyük bir temizlikten önce bir yedek alın (bkz. [Yedekleme ve geri yükleme](https://deckpa.com/docs/backup)).

## Sınırlar ve korunan öğeler

- **Korunan öğeler** — sitenin kök klasörü ve `public_html` silinemez, taşınamaz ve yeniden adlandırılamaz; menüde **korumalı** olarak işaretlenir. Bir alt alan adının belge kökü ya da onu içeren klasör de silinemez ve taşınamaz; önce alt alan adını panelden silmeniz gerekir.
- **Hassas dosyalar** — `.env`, `wp-config.php`, `.htaccess` ve `.htpasswd` silinirken panel ek bir onay ister, çünkü bunların silinmesi sitenin çalışmasını bozabilir.
- **Liste sınırı** — bir klasörde en çok 5000 öğe listelenir.
- **Süre sınırları** — klasör kopyalama 60 saniyeyle, sıkıştırma ve arşiv açma 5 dakikayla sınırlıdır. Çok büyük işlemler zaman aşımına uğrarsa daha küçük parçalara bölün.
- **Yetki** — dosyaları görüntüleme, düzenleme ve silme ayrı yetkilerdir. Hesabınızın düzenleme yetkisi yoksa listeyi görür ama kaydedemez ve yükleyemezsiniz.
