ServBay Üzerinde FacturaScripts Projesi Oluşturma ve Çalıştırma

FacturaScripts, özellikle küçük ve orta ölçekli işletmeler ile serbest çalışanların kullanımına uygun, güçlü ve esnek bir açık kaynak ERP (Kurumsal Kaynak Planlama) ve CRM (Müşteri İlişkileri Yönetimi) çözümüdür. ServBay'in sunduğu pratik yerel web geliştirme ortamı sayesinde, macOS sisteminizde FacturaScripts projelerini karmaşık ayarlarla uğraşmadan kolayca oluşturabilir, test edebilir ve çalıştırabilirsiniz.

Bu rehberde, ServBay kullanarak FacturaScripts’in macOS üzerinde yerel olarak kurulması ve yapılandırılması tüm detaylarıyla anlatılmaktadır.

FacturaScripts'e Genel Bakış

FacturaScripts, PHP ve Bootstrap çatısı üzerine inşa edilen açık kaynaklı bir ERP ve CRM yazılımıdır. Şirketlerin temel iş süreçlerini yönetmelerine yardımcı olmayı amaçlar ve şu işlevleri içerir:

• Fatura oluşturma ve yönetimi
• Muhasebe işlemleri
• Stok takibi ve kontrolü
• Müşteri ve tedarikçi yönetimi
• Proje yönetimi
• Modüller ve eklentiler aracılığıyla sunulan daha pek çok özellik...

Aktif bir açık kaynak topluluğu tarafından desteklenen FacturaScripts, işlevselliğini eklentiler yoluyla kolayca geliştirme ve farklı işletme ihtiyaçlarına uygun şekilde özelleştirme imkânı tanır.

FacturaScripts'in Başlıca Özellikleri ve Avantajları

• Açık kaynak ve ücretsiz: Pahalı lisans ücretlerine gerek yoktur; yazılımı özgürce kullanabilir, değiştirebilir ve dağıtabilirsiniz.
• Kapsamlı işlevler: KOBİ'lerin günlük operasyonlarında ihtiyaç duyabilecekleri tüm temel modülleri sunar ve entegre çözümler sağlar.
• Kullanıcı dostu: Arayüzü sade ve anlaşılırdır, öğrenme eğrisi düşük tutulmuştur.
• Yüksek derecede genişletilebilir: Zengin eklenti pazarı ve açık API ile yeni özellikler kolayca eklenebilir veya diğer hizmetlerle entegre edilebilir.
• Platform bağımsız erişim: Web tabanlı mimari sayesinde modern tarayıcıları destekleyen her cihazdan erişilebilir.
• Aktif topluluk: Karşılaşılan problemler için dünya çapındaki geliştirici topluluğundan destek alınabilir.
• Çoklu dil desteği: Farklı bölgelerdeki kullanıcılar için çoklu dil arayüzü desteği sunar.

ServBay ile FacturaScripts Çalıştırmanın Avantajları

ServBay, geliştiriciler için tasarlanmış bir yerel web geliştirme ortamı olarak, PHP tabanlı uygulamalar (örn. FacturaScripts) çalıştırmak için ideal bir platformdur. Apache/Nginx web sunucuları, çoklu PHP sürümleri, MySQL/MariaDB/PostgreSQL veritabanları ve Redis gibi yaygın araçları entegre olarak sunar ve hepsini grafik arayüz üzerinden yönetmenizi sağlar.

ServBay ile yerelde FacturaScripts çalıştırmanın öne çıkan avantajları ve temel adımları şunlardır:

• Entegre ortam: FacturaScripts’in gerektirdiği temel bileşenler (web sunucusu, PHP, veritabanı) önceden kuruludur, her bir yazılımı ayrı ayrı kurmak ve yapılandırmak gerekmez.
• Sürüm yönetimi: Farklı PHP sürümlerini kolayca değiştirerek, FacturaScripts’in gereksinimlerine uyum sağlayabilir veya uyumluluk testleri gerçekleştirebilirsiniz.
• Veritabanı yönetimi: Dahili phpMyAdmin veya Adminer gibi araçlar ile FacturaScripts için ihtiyaç duyulan veritabanı ve kullanıcılar kolayca oluşturulup yönetilebilir.
• Basit site ayarları: ServBay’in grafik arayüzü ile yerel siteler, alan adları, kök dizinleri, web sunucusu ve PHP sürümü hızla yapılandırılabilir.
• Hosts dosyası otomasyonu: ServBay, yerel siteye özel bir alan adını (ör. facturascripts.servbay.demo) otomatik olarak sisteme tanımlar.
• SSL desteği: ServBay, yerel siteler için entegre User CA veya kamuya açık ACME servisleri ile kolayca SSL/HTTPS kurulumu sunar; böylece canlı ortam deneyimi sağlanır.

ServBay ile FacturaScripts kurulumunun başlıca adımları:

1. FacturaScripts kaynak kodunu indirin.
2. ServBay’in web sitesi kök dizininde proje klasörü oluşturun.
3. FacturaScripts’in kullanacağı MySQL veritabanı ve kullanıcıyı oluşturun.
4. Web sunucusunda (Apache ya da Nginx) proje dizinine yönlendirme yapın.
5. Gerekli PHP eklentilerini etkinleştirin.
6. Tarayıcıda yerel domain ile FacturaScripts çevrimiçi kurulum sihirbazını açıp kurulumu tamamlayın.

Ön Koşullar

Başlamadan önce aşağıdaki koşulları sağladığınızdan emin olun:

• macOS sisteminizde ServBay'i başarıyla indirip kurdunuz ve çalıştırıyorsunuz. Güncel sürümü ServBay'in resmi web sitesinden temin edebilirsiniz.
• ServBay arayüzünde tercih ettiğiniz web sunucusu (Apache veya Nginx), kullanmak istediğiniz PHP sürümü ve MySQL veya MariaDB veritabanı yazılımları başlatılmış ve sorunsuz çalışıyor.
• Temel web geliştirme ve veritabanı bilgisine sahipsiniz.

FacturaScripts Projesi Oluşturma (Zip Paketi İle Kurulum)

Yerelde FacturaScripts yüklemenin en yaygın ve kolay yolu şu şekildedir:

1. FacturaScripts’i indirin:

   • FacturaScripts’in resmi indirme sayfasını ziyaret edin: https://facturascripts.com/descargar
   • En güncel kararlı .zip paketini bulun ve bilgisayarınıza indirin.

2. Proje klasörü oluşturun:

   • Finder’ı açın ve ServBay’in yerel web sitesi dosya kökü olan klasöre gidin. Varsayılan ve önerilen dizin: /Applications/ServBay/www/
   • Burada yeni bir klasör oluşturup, örneğin ismini facturascripts_project olarak belirleyin.
   • Örnek tam proje yolu: /Applications/ServBay/www/facturascripts_project

3. Dosyaları çıkarın:

   • İndirdiğiniz FacturaScripts .zip dosyasını bulun ve çift tıklayarak açın.
   • Açılan dosya ve klasörlerin (örn. index.php, Core, Dinamic, Plugins gibi) tümünü az önce oluşturduğunuz /Applications/ServBay/www/facturascripts_project dizinine kopyalayın veya taşıyın.

Başlangıç Yapılandırması (MySQL Veritabanı Ayarı vb.)

FacturaScripts, işletme verilerini, kullanıcıları ve ayarları tutmak için bir veritabanına ihtiyaç duyar. ServBay'in sunduğu MySQL veya MariaDB paketleriyle kolayca bu veritabanı oluşturulabilir. ServBay hem MySQL hem de MariaDB’yi tam olarak destekler.

1. Veritabanı paketinin çalıştığından emin olun:

   • ServBay uygulamasını açın.
   • Sol menüden “Paketler” altında “MySQL” veya “MariaDB”yı seçin.
   • Seçtiğiniz veritabanı paketi çalışıyor olmalı. Çalışmıyorsa, yanındaki anahtar simgesine tıklayarak başlatabilirsiniz.

2. Veritabanı ve kullanıcı oluşturun:

   • Dahili phpMyAdmin (MySQL/MariaDB paketleriyle gelir) veya ServBay’in terminal arayüzünden komut satırı ile veritabanı ve kullanıcı oluşturabilirsiniz. Başlangıç için phpMyAdmin daha pratiktir.
   • phpMyAdmin İle (Önerilen):
     • ServBay arayüzünde “Veritabanı” bölümünü bulun. Kullandığınız veritabanı paketinin (MySQL veya MariaDB) yanındaki phpMyAdmin ikonuna tıklayın. phpMyAdmin giriş ekranı tarayıcınızda açılacaktır.
     • phpMyAdmin’e giriş yapın. Standart olarak root kullanıcısı ve ServBay’i kurarken belirlediğiniz parolayı kullanabilirsiniz. Şifreyi unuttuysanız, paket detaylarında root şifresi sıfırlama seçeneği bulunur.
     • Giriş sonrası üstteki “Veritabanları” sekmesine tıklayın.
     • “Veritabanı oluştur” kısmına bir isim girin. Çakışma olmaması için örn. facturascripts_servbay_db önerilir.
     • Karakter seti olarak utf8mb4_general_ci veya utf8mb4_unicode_ci seçin.
     • “Oluştur”a basın.
     • Veritabanı Kullanıcısı Oluşturma (Tavsiye edilir): Güvenlik için root yerine projeye özel bir kullanıcı açmanız önerilir.
       • Ana ekrana dönüp “Kullanıcı Hesapları” sekmesini seçin.
       • “Kullanıcı Ekle”ye tıklayın.
       • Kullanıcı adı (örn. facturascripts_servbay_user) girin.
       • Sunucu olarak localhost veya 127.0.0.1 seçin.
       • Güçlü bir şifre belirleyin ve mutlaka bir yere not edin.
       • Sayfanın alt kısmında kullanıcıya yetki atayabilirsiniz. En basit yol, “Kullanıcı adı ile aynı adı taşıyan veritabanı oluştur ve tüm yetkileri ver” seçeneğini işaretlemektir. Daha ileri düzeyde ise, az önce oluşturduğunuz veritabanını seçip “Tüm Yetkiler” (ALL PRIVILEGES) kutusunu işaretleyin.
       • “Uygula” butonuna basarak işlemi tamamlayın.

3. Veritabanı bağlantı bilgilerini kaydedin: Kurulum sırasında kullanılacak olan aşağıdaki bilgileri bir kenara not edin:

   • Veritabanı adı (örn. facturascripts_servbay_db)
   • Veritabanı kullanıcı adı (örn. facturascripts_servbay_user)
   • Veritabanı kullanıcı şifresi
   • Veritabanı sunucusu (localhost veya 127.0.0.1)
   • Veritabanı portu (MySQL/MariaDB için varsayılan: 3306. ServBay arayüzünde portu kontrol edebilirsiniz.)

Web Sunucusu Ayarları (Apache veya Nginx Üzerinden)

FacturaScripts projenizin dosyalarına web sunucusu üzerinden erişilebilmesi için ServBay’de uygun ayarların yapılması gerekir. ServBay, Apache ve Nginx’i tam olarak destekler.

1. Web sunucusunun çalıştığından emin olun:

   • ServBay’in “Paketler” bölümünde, kullandığınız web sunucusunun (Apache veya Nginx) başlatılmış olduğundan emin olun.

2. Yeni site ekleyin:

   • Sol menüde “Siteler” sekmesine gelin.
   • Sağdaki liste üzerinde “+” simgesine tıklayarak yeni site oluşturma penceresini açın.
   • Gelen pencerede aşağıdakileri doldurun:
     • İsim: Açıklayıcı bir isim verin. Örn. FacturaScripts Demo Site.
     • Alan Adı: Yerel FacturaScripts sitenize erişmek için kullanmak istediğiniz alan adını yazın. Standart olarak .servbay.demo uzantısı tercih edilir (örn. facturascripts.servbay.demo).
     • Site Tipi: PHP seçin.
     • Kök Dizin: “Gözat” veya “Seç” ile FacturaScripts dosyalarını çıkardığınız klasörü seçin (/Applications/ServBay/www/facturascripts_project). Not: Bazı frameworklerde alt bir klasöre (örn. public veya web) yönlendirme gerekir; FacturaScripts için genelde kök klasör yeterlidir.
     • PHP Sürümü: Kullandığınız FacturaScripts sürümüyle uyumlu bir PHP versiyonu seçin. Genelde PHP 8.1, 8.2 veya daha yenisi önerilir. Sistem gereksinimleri için FacturaScripts’in resmi belgelerine bakabilirsiniz. ServBay çoklu PHP sürümü destekler.
     • Diğer Ayarlar: Varsayılanları genellikle değiştirmeye gerek yoktur. SSL desteği (ServBay User CA veya ACME sertifikaları üzerinden), CORS gibi ek gelişmiş ayarlar ihtiyaca göre yapılabilir.

3. Ayarları kaydedip Hosts dosyasını güncelleyin:

   • Bilgileri doldurup “Ekle” veya “Kaydet” butonuna basın.
   • ServBay seçilen web sunucusu için sanal host ayarlarını otomatik yapar. Ayrıca sizden yönetici parolası isteyerek, belirlediğiniz alan adını (facturascripts.servbay.demo) IP adresi 127.0.0.1 ile eşler. Böylece tarayıcıda yerel domain ile siteye erişebilirsiniz; hosts dosyasını el ile düzenlemenize gerek kalmaz.

4. PHP eklentilerini kontrol edip etkinleştirin:

   • FacturaScripts’in çalışabilmesi için bazı PHP eklentilerinin kurulu ve aktif olması gerekir. Sık kullanılan gereksinimler: pdo_mysql, gd (görsel işleme), intl (uluslararasılaştırma), zip (sıkıştırma), xml, curl (web talepleri) gibi. ServBay, pek çok eklentiyi varsayılan olarak yüklü ve aktif getirir. Yine de yükleme sırasında veya çalıştırırken eksiği bildirilirse aşağıdaki şekilde aktifleştirebilirsiniz:
   • ServBay Üzerinden PHP Eklentisi Etkinleştirme:
     • Sol menüden “Diller”→“PHP” seçin.
     • facturascripts.servbay.demo sitesini hangi PHP sürümüne ayarladıysanız onu seçin (örn. PHP 8.2).
     • PHP sürümü detay ekranında “Eklentiler” sekmesine geçin.
     • Yüklü ve aktif eklentiler burada listelenir. FacturaScripts yükleyicide eksik bildirilen bir eklenti varsa, karşısındaki kutucuğu işaretleyerek etkinleştirin.
     • Ekranın altındaki “Uygula” veya “Kaydet” butonuna tıklayın. Bazı değişikliklerin etkin olabilmesi için ilgili PHP servisini yeniden başlatmak gerekebilir. “Diller”→“PHP” kısmında ilgili PHP sürümünün yanındaki yeniden başlat simgesine tıklayabilirsiniz.

ServBay Web Sitesi Yapılandırma Arayüzü Örneği

Siteye Erişim ve FacturaScripts Kurulumunu Tamamlama

Artık ServBay ortamınız FacturaScripts’i çalıştırmaya hazır ve kurulum sihirbazını başlatabilirsiniz.

1. Tarayıcıyı açın: Chrome, Firefox, Safari vb. tarayıcınızı başlatın.

2. Adres girin: FacturaScripts için tanımladığınız alan adını adres çubuğuna yazın (örn. http://facturascripts.servbay.demo). Eğer SSL sertifikası ayarı yaptıysanız, https://facturascripts.servbay.demo üzerinden de erişebilirsiniz. Enter’a basın.

3. FacturaScripts Kurulum Sihirbazı:

   • ServBay sitesinin ayarları, hosts dosyası düzenlemesi ve web sunucusu/PHP servisleri sorunsuz çalışıyorsa, FacturaScripts’in hoşgeldiniz ekranı veya kurulum sihirbazı açılacaktır.
   • Dil Seçimi: Öncelikle arayüz dili seçin.
   • Sistem Kontrolü: Kurulum sihirbazı, sunucu ortamınızı (PHP sürümü, istenen PHP eklentileri, klasör yazma izinleri vs.) otomatik olarak denetler. Her şey uygunsa yeşil onay kutularıyla devam edilir. Sorun ya da uyarı varsa, ilgili PHP sürümünü, eklentilerini veya proje klasörü (/Applications/ServBay/www/facturascripts_project) erişim izinlerini inceleyin; web sunucusu kullanıcısına yazma izni verilmiş olmalı.
   • Veritabanı Ayarı: En önemli adımlardan biri. Daha önce oluşturduğunuz şu verileri girin:
     • Veritabanı Tipi: MySQL seçin.
     • Sunucu: localhost veya 127.0.0.1
     • Port: 3306 (veya ServBay’de belirttiğiniz port)
     • Veritabanı Adı: facturascripts_servbay_db (phpMyAdmin’de oluşturduğunuz)
     • Kullanıcı Adı: facturascripts_servbay_user
     • Şifre: Bir önceki adımda belirlediğiniz şifre
     • Tablo Öneki: Varsayılan fs_ kalabilir veya ihtiyaca göre değiştirilebilir.
   • Yönetici Hesabı: FacturaScripts yönetici paneline giriş için kullanıcı adı, şifre ve e-posta tanımlayın. Güçlü bir şifre belirleyin ve bu bilgileri saklayın!
   • Kurulumu Başlat: Tüm bilgiler doğruysa kurulumu başlat butonuna tıklayın. FacturaScripts, bağlandığınız veritabanını otomatik olarak oluşturacak ve gerekli tüm tablolar ile ayar dosyalarını oluşturacaktır.

4. Kurulum Sonrası:

   • Kurulum tamamlandıktan sonra, güvenlik gerekçesiyle ana dizindeki install klasörünün silinmesi önerilebilir (eğer varsa ve sihirbaz bildirirse). Uyarıları takip edin ve gerekirse silin.
   • Artık http://facturascripts.servbay.demo veya HTTPS adresinden FacturaScripts giriş ekranına ulaşmalı ve biraz önce tanımladığınız yönetici hesabı ile oturum açabilmelisiniz. Keyifli keşifler!

Sık Sorulan Sorular (SSS)

• FacturaScripts kurulum sihirbazı eksik PHP eklentisi uyarısı veriyor, ne yapmalıyım?
  • ServBay uygulamasında sol menüden “Diller”→“PHP”ye gelin, ilgili PHP sürümünün “Eklentiler” sekmesinde eksik bildirilen modülü (örn. opcache) işaretleyip “Uygula”ya basın ve PHP servisini yeniden başlatın.
• facturascripts.servbay.demo adresine girince “Forbidden” ya da boş sayfa çıkıyor?
  • Öncelikle web sunucusu ve PHP servislerinin aktif olduğundan emin olun. Ardından site ayarında “Kök Dizin” olarak doğru klasörün seçili olduğunu denetleyin (/Applications/ServBay/www/facturascripts_project). Boş sayfa alınırsa PHP hata loglarına bakın. “Forbidden” ise büyük olasılıkla dosya/klasör izinleriyle ilgilidir; web sunucusunun proje dosyalarını ve özellikle Dinamic klasörünü yazabilir olmasını sağlayın.
• FacturaScripts veritabanına bağlanmıyor, problem nerede olabilir?
  • MySQL/MariaDB servisinin çalışır durumda ve doğru portta olduğundan (çoğunlukla 3306) emin olun. Kurulum sihirbazında girdiğiniz tüm veritabanı bilgilerini (sunucu adresi, port, veritabanı adı, kullanıcı adı ve şifre) eksiksiz ve aynı şekilde yazın.

Sonuç

ServBay’in güçlü yerel web geliştirme ortamı sayesinde, macOS üzerinde FacturaScripts kurmak ve çalıştırmak oldukça basittir. ServBay tüm bağımlılıkları (web sunucusu, PHP, veritabanı) hazır olarak getirir ve kullanıcı dostu arayüzüyle teknik ayarları minimuma indirger. Bu rehberdeki adımları izleyerek FacturaScripts için hızlıca yerel geliştirme ya da test ortamınızı kurabilir, iş süreçlerinize ve yazılımın keşfine odaklanabilirsiniz. ServBay, sunduğu esneklik ve pratiklikle yerel geliştirme verimliliğinizi üst düzeye taşıyacaktır.