VOpenScript
Excel Import Paketi

Paket Hakkında

VOpenScript ExcelImport, Dokuz Sistem'in kurumsal ERP entegrasyon projelerinde kullandığı Excel aktarım modüllerinin PHP 8 uyumlu, güvenlik sıkılaştırılmış ve açık kaynak olarak yayınlanmış versiyonudur. Pakette iki ayrı script bulunur: Stok Aktarım ve Müşteri Aktarım.

Script Detayları

CREATE TABLE stok (
  id         INT AUTO_INCREMENT PRIMARY KEY,
  stokkod    VARCHAR(50)   NOT NULL UNIQUE,
  stokad     VARCHAR(255)  NOT NULL,
  grupkod    VARCHAR(50)   DEFAULT '',
  ekgrupkod  VARCHAR(50)   DEFAULT '',
  birim      VARCHAR(20)   DEFAULT '',
  kdvoran    DECIMAL(5,2) DEFAULT 0,
  aciklama   TEXT,
  alisfiyat  DECIMAL(10,2) DEFAULT 0,
  satisfiyat DECIMAL(10,2) DEFAULT 0,
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
) ENGINE=InnoDB CHARSET=utf8mb4;

CREATE TABLE musteri (
  id            INT(11) NOT NULL AUTO_INCREMENT,
  musterikod    VARCHAR(50)  DEFAULT NULL,
  musteriunvan  VARCHAR(100) DEFAULT NULL,
  grupkod       VARCHAR(100) DEFAULT NULL,
  ekgrupkod     VARCHAR(100) DEFAULT NULL,
  ilgilikisi    VARCHAR(100) DEFAULT NULL,
  vd            VARCHAR(50)  DEFAULT NULL,  -- vergi dairesi
  vn            VARCHAR(11)  DEFAULT NULL,  -- vergi numarası
  telno         VARCHAR(20)  DEFAULT NULL,
  adres         VARCHAR(250) DEFAULT NULL,
  aciklama      VARCHAR(250) DEFAULT NULL,
  PRIMARY KEY (id)
) ENGINE=InnoDB CHARSET=utf8 COLLATE=utf8_turkish_ci;

Hızlı Kurulum

1. Repoyu klonla

   GitHub'dan projeyi yerel ortamınıza indirin.

   terminal

   git clone https://github.com/DSOpenServer/VOpenScript_ExcelImport.git
   cd VOpenScript_ExcelImport

2. Veritabanı tablolarını oluştur

   Yukarıdaki iki SQL bloğunu (stok + musteri) phpMyAdmin'de çalıştırın.

3. Bağlantı bilgilerini güncelle

   classes/dbClass.php

   private string $host    = "localhost";
   private string $user    = "root";         // kullanıcı adı
   private string $pass    = "";            // şifre
   private string $db      = "veritabani";  // db adı
   private string $charset = "utf8mb4";

4. uploads/ klasörünü oluştur (her iki script için)

   terminal

   mkdir excelimport/uploads
   chmod 755 excelimport/uploads

5. Tarayıcıdan aç

   URL

   http://localhost/VOpenScript_ExcelImport/excelimport/stokimport.php
   http://localhost/VOpenScript_ExcelImport/excelimport/musteriimport.php

Klasör Yapısı

URL Referansı

POST Parametreleri (her iki script için aynı)

Kod Örnekleri

Excel Okuma Döngüsü (her iki script aynı yapıyı kullanır)

$Reader     = new SpreadsheetReader($targetPath);
$sheetCount = count($Reader->sheets());

for ($i = 0; $i < $sheetCount; $i++) {
    $Reader->ChangeSheet($i);
    $satir = 0;

    foreach ($Reader as $Row) {
        if ($satir === 0) { $satir++; continue; } // başlık atla

        $alan = trim((string)($Row[N] ?? '')); // PHP 8 null-safe okuma
        $satir++;
    }
}

Prepared Statement — Müşteri INSERT

        $dba->safeQuery(
            "INSERT INTO musteri
             (musterikod,musteriunvan,grupkod,ekgrupkod,ilgilikisi,vd,vn,telno,adres,aciklama)
             VALUES (?,?,?,?,?,?,?,?,?,?)",
            [$musterikod,$musteriunvan,$grupkod,$ekgrupkod,
             $ilgilikisi,$vd,$vn,$telno,$adres,$aciklama]
        );

Prepared Statement — Stok INSERT

        $dba->safeQuery(
            "INSERT INTO stok
             (stokkod,stokad,grupkod,ekgrupkod,birim,kdvoran,aciklama,alisfiyat,satisfiyat)
             VALUES (?,?,?,?,?,?,?,?,?)",
            [$stokkod,$stokad,$grupkod,$ekgrupkod,
             $birim,$kdvoran,$aciklama,$alisfiyat,$satisfiyat]
        );

Mükerrer Kontrol — Müşteri

$stmt  = $dba->safeQuery(
    "SELECT COUNT(id) AS sayi FROM musteri WHERE musterikod = ?", [$musterikod]
);
$sonuc = $dba->fetch_object($stmt);

if ((int)$sonuc->sayi > 0) {
    $message .= htmlspecialchars($musterikod, ENT_QUOTES, 'UTF-8')
        . ' kodlu müşteri zaten var, atlandı.<br>';
}

dbClass API Referansı

PDO tabanlı veritabanı sınıfı. Her iki script bu sınıfı kullanır.

Güvenlik Notları

SQL Injection Koruması

Tüm kullanıcı girdileri ? placeholder ile bağlanır, PDO otomatik kaçışlar.

XSS Koruması

Her HTML çıktısı htmlspecialchars($val, ENT_QUOTES, 'UTF-8') ile temizlenir.

Dosya Yükleme Güvenliği

MIME tipi whitelist kontrolü, basename() ile dizin geçişi engeli, işlem sonrası unlink() ile geçici dosya silme.

PHP 8 Geliştirmeleri