Fonksiyonlar
Fonksiyonun aldığı parametreler Parametre: Birinci Parametre Tipi, İkinci Parametre Tipi.. şeklinde belirtilecektir. Parametreler virgül(,) ile ayrılacaktır. Fonksiyonun döndürdüğü değer ise Return: Veri tipi şeklinde belirtilecektir. Eğer fonksiyon hiç bir parametre almıyorsa Parametre: yazılmayacak, eğer fonksiyon geriye hiç bir şey döndürmüyorsa Return: yazılmayacaktır.
Uygulamaya harici fonksiyonlar eklemek isterseniz App>Functions klasörü altında istediğiniz bir dosya oluşturup içine fonksiyonları tanımlamanız yeterlidir. Framework otomatik olarak bu dizinde ki fonksiyonları uygulama başlamadan yükleyecektir.
Framework ile birlikte gelen fonksiyonlar
- get_url
- clean_xss
- clean
- clean_out
- redirect
- random_str
- slug
- pass
- get_route
- file_check
- set_cache_name
- is_admin_folder
- error_handler
- exception_handler
- shutdown_handler
- paginator
- add_file_with_ver
- create_dp_url
- add_slash
- remove_dir
- copy_dir
- is_email
- prev_url
- is_ssl
- is_phone
1. get_url
Bilgi: Aktif olan url adresini döndürür. Host adresini döndürmez yalnızca istek adresini döndürür. Örneğin example.com/deneme.php adresinde yalnızca /deneme.php bilgisini döndürür.
Return: String
2. clean_xss
Bilgi: Güvenlik amaçlı kullanılan bir fonksiyondur. Formdan gönderilen değerlerde xss açığını önler.
Parametre: String
Return: String
Örnek kullanım:
clean_xss("<script>alert("1");</script>");
3. clean
Bilgi: Güvenlik amaçlı kullanılan bir fonksiyondur. clean_xss fonksiyonundan farklı olarak dizi değeri alabilir. Gönderilen dizi içinde ki tüm elemanları üstteki clean_xss fonksiyonu ve diğer güvenlik fonksiyonlarından geçirerek geri döndürür.
Parametre: Mixed
Return: Mixed
Örnek kullanım:
$data = ["<h1>Hello</h1>", "<test>"];
clean($data);
4. clean_out
Bilgi: Güvenlik amaçlı kullanılan bir fonksiyondur. View katmanına çıktı olarak gönderilen değerlerin html tag içermemesi ve gönderilen değerleri parse eden fonksiyondur.
Parametre: Mixed
Return: String
5. redirect
Bilgi: Yönlendirme yapmayı sağlayan fonksiyondur. Fonksiyona gönderilen ikinci parametre kaç saniye sonra yönlendirileceğini belirtmeyi sağlar. Genel olarak giriş ve çıkış formlarında ve hata mesajlarında kullanılır.
Parametre: String, Integer
Return: Void
Örnek kullanım:
redirect("yonlendirilecekurl", 1);
6. random_str
Bilgi: Rastgele metin oluşturmayı sağlayan fonksiyondur.
Return: String
7. slug
Bilgi: SEO uyumlu url yapısı oluşturmak için kullanılır. Gönderilen parametreyi sef link olarak dönüştürür.
Parametre: Mixed
Return: String
Örnek kullanım:
echo slug("Merhaba Dünya!"); // Çıktı: merhaba-dunya
8. pass
Bilgi: Şifreleme işlemini yapan fonksiyondur.
Parametre: Mixed
Return: String (md5)
9. get_route
Bilgi: Geçerli olan rota bilgisini döndürür. MVC Mimarisinde ki rota yapısını belirlemek için kullanılır. "controller/method/param" gibi. Eğer hiç bir controller aktif değilse false değerini döndürür.
Return: False or Mixed
10. file_check
Bilgi: Dosya silme, listeleme gibi işlemlerde güvenlik açığı oluşturabilecek dosyaları kontrol eden fonksiyondur. Uygulama üzerinde ki .gitkeep .gitignore gibi versiyonlama sistemine ait dosyaları listeleme işlemlerinde göstermez.
Parametre: String
Return: Boolean
11. set_cache_name
Bilgi: Önbelleğe alınacak dosyayı, dosya adını önbellek dizinine kaydetmek için kullanılan fonksiyondur.
Parametre: Mixed, String
Return: String
12. is_admin_folder
Bilgi: Aktif olan adres satırının yönetim paneli üzerinde çalışıp çalışmadığı hakkında bilgi veren fonksiyondur. Tema ve dil sistemi bu fonksiyona sıkı sıkıya bağımlıdır. Örneğin example.com/dashboard/home adres satırında dashboard yönetim paneli dizinini ifade eder. Bu url adresi yönetim paneli dizini altında home controllerin çalıştığını bildirir. Buna göre bu fonksiyon yönetim paneline ait dil dosyalarını yükler. Eğer yönetim paneli üzerinde çalışmıyor ise önyüze ait dil dosyasını yükleyecekti.
Return: Boolean
13. error_handler
Bilgi: Uygulamaya özel hata yakalama sistemi oluşturmak için kullanılan fonksiyondur.
Parametre: Integer, String, String, Integer
14. exception_handler
Bilgi: Uygulamaya özel hata yakalama sistemi oluşturmak için kullanılan fonksiyondur.
Parametre: Array
15. shutdown_handler
Bilgi: Uygulamaya özel hata yakalama sistemi oluşturmak için kullanılan fonksiyondur.
16. paginator
Bilgi: Sayfalama işlemini yapan fonksiyondur. Modeldan gelen içeriği sayfalayarak view katmanına oluşan sayfa numaralarını aktarma işini yapar. Birinci parametre toplam sayfa sayısını, ikinci parametre aktif olan sayfa sayısını ve son parametre ise sayfa url adresini alır.
Parametre: Integer, Integer, String
Return: String
17. add_file_with_ver
Bilgi: Stil ve script dosyalarını sayfaya import ederken dosyanın son güncellenme tarihi ile birlikte ekler.
Parametre: String
Return: String
Örnek kullanım:
<link href="<?php add_file_with_ver('style.css'); ?>" />
// Çıktı: <link href="style.css?v=16328828" />
18. create_dp_url
Bilgi: Yönetim paneli için url adresi oluşturmaya yarayan fonksiyondur. Fonksiyona gönderilen parametrenin önüne yönetim panel url adresini ekleyerek link oluşturur. Örneğin:
echo create_dp_url('posts/index');
// Çıktı: http://example.com/dashboard/posts/index
19. add_slash
Bilgi: Metin yada url adresi sonuna slash(/) eklemeye yarayan fonksiyondur. Eğer gönderilen parametre slash içeriyorsa ekleme yapmaz. Daha çok kullanıcıdan alınan yönetim paneli adresi ve diğer dizin işlemlerinde kullanılır.
Parametre: String
Return: String
20. remove_dir
Bilgi: Dizinleri kaldırmaya yarayan fonksiyondur. PHP'de içi dolu olan dizinleri silemeyiz. Bu fonksiyon sayesinde içi dolu olan dizinleri silebilirsiniz.
Paremetre: String
Return: Boolean
21. copy_dir
Bilgi: Dizinleri kopyalamaya yarayan fonksiyondur. Birinci parametre kopyalanacak olan dizini, ikinci parametre ise dizinin hangi dizene kopyalanacağını belirtir.
Paremetre: String, String
Örnek kullanım:
copy_dir('public', 'yedekpublic');
22. is_email
Bilgi: Gönderilen parametrenin gerçek bir e-mail adresi olup olmadığını kontrol eden fonksiyondur.
Parametre: String
Return: Boolean
23. prev_url
Bilgi: Bir önceki sayfanın url adresini almaya yarayan fonksiyondur.
Return: String
24. is_ssl
Bilgi: Sitenin geçerli bir SSL sertifikasına sahip olup olmadığını kontrol eden fonksiyondur. Geçerli bir SSL sertifikası mevcut ise true, değilse false değeri döndürür.
Return: Boolean
25. is_phone
Bilgi: Girilen telefon numarasının geçerli olup olmadığını kontrol eder. Yalnızca türk operatörlere ait numaraları kontrol etmektedir. Eğer girilen telefon numarası geçerli aralıkta ise true, değilse false döndürür.
Parametre: Integer
Return: Boolean
Örnek kullanım:
is_phone('5075000000');
//Çıktı: true;
Dil Fonksiyonları
Framework ile birlikte gelen 3 adet dil fonksiyonu bulunmaktadır. Bu fonksiyonlar bootstrap dosyasında ve diğer tetikleme dosyalarında kullanılır.
1. __
Bilgi: Fonksiyona gönderilen parametrenin dil dosyasında tanımlı değerini geri döndürür.
Parametre: String
Return: String
Örnek kullanım:
echo __('hi');
// Çıktı: merhaba
2. lang_name
Bilgi: Gönderilenen global dil kısaltmasının kendi dilinde tam adını döndürür.
Parametre: String
Return: String
Örnek kullanım:
echo lang_name('tr');
// Çıktı: Türkçe
3. load_lang_files
Bilgi: Geçerli dile ait dil dosyalarını otomatik olarak yüklemeye yarayan fonksiyondur.
Parametre: String
Kullanıcı Fonksiyonları
Framework ile birlikte gelen 4 adet kullanıcı fonksiyonu bulunmaktadır.
1. get_ip
Bilgi: Kullanıcının IP adresini almaya yarayan fonksiyondur.
Return: String
2. get_user_agent
Bilgi: Tarayıcı bilgisini almaya yarayan fonksiyondur.
Return: String
3. user_name
Bilgi: Kullanıcı adı oluşturmaya yarayan fonksiyondur. Bu fonksiyona gönderilen parametre belirli filtre ve dönüşümlerden geçerek kullanıcı adına dönüştürülür.
Parametre: String
Return: String
echo user_name("john doe"); // Çıktı: johndoe
4. is_robot
Bilgi: Sayfayı ziyaret eden kullanıcının robot mu yoksa gerçek bir kullanıcı mı olduğu hakkında bilgi veren fonksiyondur.
Return: Boolean