Validasyon Kütüphaneleri

Bu kütüphanelerin temel amacı veri ve sistem güvenliğini sağlamaktır. Aşağıda bu kütüphane içerisinde bulunan 3 farklı sınıf gösterilmiştir.

# Kurulum

ZN dağıtımları için kurulum gerekmez.

↓ composer require znframework/package-validation

# Validation

Formlardan post, get gibi yöntemlerle gönderilen verilerin kontrolünü sağlamak için oluşturulmuştur.

# Örnek Uygulamalar

# Standart Validasyon Kullanımı
# Form Kütüphanesi ile Validasyon Kullanımı

# Yöntemler

# Validate

Doğrulama yöntemidir. Aşağıdaki tabloda belirtilen filtrelere aykırı veri gönderimi durumunda Validation::error() aykırı kullanıma dair hata dizisi döndürür.

Validation::validate('numeric', 'trim')->rules('phone');

if( ! Validation::error() )
{
    # Hata yoksa işlemleriniz.
}

# Secure

Güvenlik yöntemidir. Aşağıdaki tabloda belirtilen filtrelere aykırı veri gönderimi durumunda veri üzerinde dönüştürme işlemi yapılarak verinin süzgeçten geçirilmesini sağlar. Bu nedenle bu filtreler herhangi bir hata çıktısına neden olmaz.

Validation::secure('xss', 'injection')->rules('content');

# Compare

Karşılaştırma yöntemidir. 

Validation::compare(4, 16)->rules('password');

# MatchPassword

Kayıt veya güncelleme işlemlerinden şifre ve şifre tekrar verilerinin eşleşip eşleşmediğinin kontrolünü yapan yöntemdir.

Validation::matchPassword('passagain')->rules('pass');

# Match

Herhangi iki bilginin eşleşip eşleşmediğinin kontrolünü yapan yöntemdir.

Validation::match('oldpass')->rules('newpass');

# Phone

Telefon bilgisi kontrolünü yapan yöntemdir.

Validation::phone('(+**)-(***)-(**)-(**)')->rules('example');

Yukarıdaki kurala uyan bir veri (+90)-(534)-(00)-(00) gibi bir dizilimde olmalıdır.

# Pattern

İstenilen türde değerin kontrolü için kullanılır. Bu yöntem içerisinde düzenli ifade içermelidir.

Validation::pattern('[a-zA-Z0-9]+', 'i')->rules('name');

# Between / BetweenBoth (ZN >= 5.3.5)

Verinin belirtilen 2 sayı arasında olup olup olmadığını kontrol eder.

Validation::between(100, 200)->rules('name');

Between kontrolünde sayılar arasında olmak zorundadır. BetweenBoth kontrolünde ise sayılara eşitte olabilir.

# Captcha

Güvenlik kodu doğrulaması yapar.

Validation::captcha()->rules('captchaInput');

# Answer [6.3.0][2021-03-02]

Güvenlik sorusuna verilen cevabın doğrulaması yapar. Bu yöntem Validator::question() yöntemi ile birlikte kullanılır.

Validation::answer()->rules('answerInput');

Uygulama - 1

Aşağıda bu yöntemin form ile nasıl kullanıldığının örneği verilmiştir.

@Form::open('contactForm')
{{ Validator::question() }} ? {{ Form::text('answertInput') }}
@Form::submit()

public function main()
{
    Validation::answer()->rules('answerInput');

    # your codes.
}

# Card

Kredi kartı numarasının geçerliliğini kontrol eder. Çok sayıda kredi kartı sağlayıcısını destekler.

Post::cardNumber('5522334422334112');

Validation::card('mastercard')->rules('cardNumber')

# CVC

Kredi kartı güvenlik numarasının geçerliliğini kontrol eder. Çok sayıda kredi kartı sağlayıcısını destekler.

Post::cardCVC('921');

Validation::cvc('mastercard')->rules('cardCVC');

# CardDate

Kredi kartının son kullanım tarihinin geçerliliğini kontrol eder.

Gelen değer mm/yyyy formatında bir bilgi içermelidir. 6.91.8.30 sürümü ile beraber bu sınırlama kaldırılmıştır. Yıl istenirse 2 veya 4 haneli ay ise 1 veya 2 hane olabilir.

Post::cardDate('04/2023');

Validation::cardDate()->rules('cardDate');

Bu güncelleme ile beraber yılın 4 ayın ise 2 hane olma zorunluluğu kaldırılmıştır. Aşağıdaki örnekte geçerli tarih gönderimini göstermektedir.

Post::cardDate('4/23');

Validation::cardDate()->rules('cardDate');

# Messages

Validasyon işlemlerinde oluşan hata çıktısı External/Languages/ViewObjects.php dosyasında yer alan tanımlamalara göre oluşturulur. Çıktıyı değiştirmek için bu dosyaları manipüle edebileceğiniz gibi bu işlemi bu yöntemle de gerçekleştirebilirsiniz.

Post::cvc(123123);

Validation::messages
([
    'cvc' => 'Geçersiz kart güvenlik numarası.'
]);

Validation::cvc('mastercard')->rules('cardCVC');

echo Validation::error('string');

Oluşturulan hata mesajına veri yerleştirmek için bazı deyimler kullanılır. 

Post::name('Mi');
Post::point(150);

Validation::messages
([
    'cvc'     => ':name alanı geçersiz kart güvenlik numarasına sahiptir.',
    'between' => ':name alanı [:p1 - :p2] sayı aralıklarında değildir.',
    'minchar' => ':name alanı en az :p1 adet sayı içermelidir.'
]);

Validation::value('İsim')->rules('name', ['minchar' => 3]);
Validation::between(50, 100)->value('Puan')->rules('point');

echo Validation::error('string');

# Value

Validation::rules() yönteminin 3. parametresi yerine kullanılır. Input name değerinin üretilen hata çıktısında görünen adını ayarlamak için kullanılır.

Validation::validate('required')->compare(5, 100)->value('Name')->rules('name');

# Method

Validation::rules() yönteminin 4. parametresi yerine kullanılır. İstek türü varsayılan olarak post ayarlıdır. Bunu değiştirmek için bu yöntemden yararlanılır.

Validation::validate('required')->method('get')->rules('name');

Data Parametresi

Parametrenin 'data' ayarlanması durumunda doğrudan Validation::rules() yönteminin 1. parametresine gelen değerin kontrolünü yapar.

Validation::validate('email')->method('data')->rules('robot@znframwork.com');

# Rules

Bu yöntemin temel amacı formlardan gelen verilerin hangi kontrol parametrelerinden geçeceğini belirlemektir. Veriler kontrolden başarılı bir şekilde geçerse error() yöntemi false döner. Bu nedenle başarım durumuna göre koda yön vermek için Validation::error() yöntemini kullanınız.

Parametreler

Filtreler

'required'

'email'

'phone', ['phone' => '(***)-(***)-(**)-(**)']

['minchar' => min]

['maxchar' => max]

['matchPassword' => 'input-name']

['match' => 'input-name']

['between' => [min, max]]

['betweenBoth' => [min, max]]

['card' => 'card-type']

['cvc' => 'card-type']

['pattern' => '/regex/']

Kullanımlar

Post::username('ExampleUser');
Post::password('1234');

Validation::rules('username', ['required', 'email'], 'Username:');
Validation::rules('password', ['required', 'minchar' => 8, 'maxchar' => 32], 'Username:');

# Kuralların kontrolü için bu yöntem kullanılır.
if( ! $error = Validation::error('string') )
{
    # Hata yoksa kodlarınız.
}
else
{
    output($error);
}

# Error

Validasyon sırasında hata olması durumunda hata üretir. Validasyon durumuna göre kod akışına yön vermek için kullanılır. 

Parametreler

$separator = '<br>'

Kullanımlar

if( Validation::error() )
{
    # Hata varsa kodlarınız
}
else
{
    # Hata yoksa kodlarınız
}​​​​​

İsme Göre [$type = 'name']

Hataya neden olan bir input varsa ismi kullanılarak o sadece o inputa ait hata elde edilebilir.

output( Validation::error('phone') );

Bu güncellemede $separator parametresi eklenmiştir. Bu parametre birden fazla oluşan hata mesajlarının alt alta yazılabilmesi için kullanılan <br> etiketi dışında farklı bir ayraç kullanılmasını sağlar.

$error = Validation::error('string', "\n");

# AddError [6.5.0][2021-03-07]

Validation::error() yöntemin döndürdüğü hata dizisine kendi hata mesajlarınızı eklemenizi sağlar.

Parametreler

Kullanımlar

Validation::addError('My error!');

echo Validation::error('string');

[string $name][7.8.0][2022-12-18]

Belirlenen hatayı temsil eden bir isim verilir.

Validation::addError('My error', 'myErrorInput');

echo Validation::error('myErrorInput');

# ErrorInputs [7.8.0][2022-12-18]

Hayata konu olan inputların isimlerinin yer aldığı bir dizi döndürür.

Parametreler

Kullanımlar

Validation::rules('emailInput', ['email']);
Validation::addError('Invalid Identity Number!', 'identityInput');

output( Validation::errorInputs() );

# Check (ZN >= 5.4.2)

Form::validate() yöntemi ile oluşturulan kuralların kontrolü için kullanılır.

Parametreler

$submitName = 'all'

Kullanımlar

<?php namespace Project\Controllers;

use Validation, Post;

class Home extends Controller
{
    public function main(string $params = NULL)
    {
        if( Post::all() )
        {
            if( Validation::check() )
            {
                # Validasyon geçerli ise yapılacak işlemler.   
            }
            else
            {
                # Validasyon geçersiz ise hatayı dizge türünden veri olarak gönder.
                View::error( Validation::error('string') );
            }
        }
    }
}

Rule Check Error

Bu hata validasyon kurallarında anormallik olması durumunda üretilmektedir.

# Standart Validasyon Kullanımı

Genellikle Validation kullanımı bir görünüm sayfasından post edilen forma ait değerleri kontrol etmek için kullanılır. Validation kontrolü için Validation::error() kullanılır. Buna göre aşağıdaki gibi bir kontrolcü ve bir görünüm sayfamızın var olduğunu kabul ederek kodlarımızı düzenleyelim.

Veri göndereceğiniz formunuzu hazırlayın. 

@Form::open('test')
@Form::placeholder('Name')->text('name'): <br>
@Form::placeholder('Subject')->textarea('subject'): <br>
@Form::submit('sendSubmit', 'Send')
@Form::close()

@if( ! empty($validationError) )
    @$validationError
@endif

Gelen form verilerini işleme sokan kontrolcüyü hazırlayın. 

<?php namespace Project\Controllers;

use Validation, DB, Post;

class Contact extends Controller
{
    public function main(string $params = NULL)
    {
        if( Post::sendSubmit() )
        {
            Validation::validate('required')
                      ->compare(2, 250)
                      ->secure('xss', 'injection')
                      ->value('Name : ')
                      ->rules('name');

            Validation::validate('required')
                      ->compare(5, 250)
                      ->secure('script', 'xss')
                      ->value('Subject : ')
                      ->rules('subject');
            
            # Bu kullanımda kontrol Validation::error() ile gerçekleştirilir.
            if( ! $validationError = Validation::error('string') )
            {
                DB::insert('post:contact');               
            }    
        } 

        View::validationError($validationError ?? NULL);    
    }
}

# Form Kütüphanesi ile Validasyon Kullanımı

Bu tip kullanımda form verilerinin kontrolü kontrolcü üzerinde Validation::rules() yerine görünüm üzerinde Form::validate() yöntemi ile yapılır. Validasyon kontrolü için Validation::check() kullanılır.

Veri göndereceğiniz formunuzu hazırlayın. 

@Form::open('test')
@Form::placeholder('Name')->validate('xss', 'injection', ['minchar' => 2])->text('name'): <br>
@Form::placeholder('Subject')->validate(['minchar' => 5, 'maxchar' => 250])->textarea('subject'): <br>
@Form::submit('sendSubmit', 'Send')
@Form::close()

@if( ! empty($validationError) )
    @$validationError
@endif

Gelen form verilerini işleme sokan kontrolcüyü hazırlayın. 

<?php namespace Project\Controllers;

use Validation;

class Home extends Controller
{
    public function main(string $params = NULL)
    {
        # Bu kullanımda kontrol Validation::check() ile gerçekleştirilir.
        if( ! Validation::check() )
        {
            # your codes...
            View::validationError(Validation::error('string'));
        }
    }
}

# Validator (ZN >= 4.0.23)

Verilerin kontrolü maksadıyla oluşturulmuş kütüphanedir. Bu bölümde Validator:: kütüphanesinin normal veriler için kullanımı anlatılacaktır.

# Yöntemler

# Phone (ZN >= 4.0.23)

Verinin telefon bilgisi içerip içermediği kontrol edilir.

echo Validator::phone('1231');
echo Validator::phone('32343234234');
echo Validator::phone('123-234', '● *-● -● ');
echo Validator::phone('123-23-23', '● *-● -● '); 

# Numeric (ZN >= 4.0.23)

Verinin sayısal veri olup olmadığı kontrol edilir.

echo Validator::numeric('1231');
echo Validator::numeric('a234');
echo Validator::numeric('234'); 

# Alpha (ZN >= 4.0.23)

Verinin alfabetik veri olup olmadığı kontrol edilir.

echo Validator::alpha('1231');
echo Validator::alpha('a234');
echo Validator::alpha('abcd'); 

# Alnum (ZN >= 4.0.23)

Verinin alfabetik veya sayısal veri olup olmadığı kontrol edilir.

echo Validator::alnum('1231');
echo Validator::alnum('a234');
echo Validator::alnum('abcd');
echo Validator::alnum('?+y12');

# Identity (ZN >= 4.0.23)

Verinin kimlik numarası olup olmadığı kontrol edilir.

echo Validator::identity(12312311231);
echo Validator::identity('12312312');

Gerçek bir kimlik numarası girdiğinizde sonucun 1 olduğunu görebilirsiniz.

# Email (ZN >= 4.0.23)

Verinin e-posta olup olmadığı kontrol edilir.

echo Validator::email('robot@znframework');
echo Validator::email('robot@znframework.com');

# URL (ZN >= 4.0.23)

Verinin url olup olmadığı kontrol edilir.

echo Validator::url('www.znframework.com');
echo Validator::url('https://www.znframework.com');

# SpecialChar (ZN >= 4.0.23)

Verinin içerisinde özel karakter olup olmadığı kontrol edilir.

echo Validator::specialChar('abc+');
echo Validator::specialChar('abc');

# Minchar (ZN >= 4.0.23)

Verinin minumum uzunluk değeri kontrol edilir. Belirtilen değere eşit ve büyük olduğu sürece true döner.

echo Validator::minchar('abc', 5);
echo Validator::minchar('abc', 2);

# Maxchar (ZN >= 4.0.23)

Verinin maksimum uzunluk değeri kontrol edilir. Belirtilen değere eşit ve küçük olduğu sürece true döner.

echo Validator::maxchar('abc', 5);
echo Validator::maxchar('abc', 2);

# Captcha [3.0.0]

Verinin captcha kodu ile uyumlu olup olmadığı kontrol edilir.

echo Validator::captcha('ab032c');

# Question [6.3.0][2021-03-02]

Verinin güvenlik sorusuna verilen yanıt ile uyumlu olup olmadığı kontrol edilir.  Bu yöntem Validation::answer() doğrulaması ile beraber kullanılır.

echo Validator::question();

[$questions]

Bu parametrenin tanımlanması durumunda kendinize özel soru cevap dizisi oluşturabilirsiniz. Bu sorular rasgele çıktılanır. Verilen cevapların harf duyarlılığı yoktur.

echo Validator::question(['Başkent?' => 'ankara', 'Güneş hangi yönden doğar?' => 'batı']);

# Answer [6.3.0][2021-03-02]

Validator::question() yöntemi ile oluşturulan güvenlik sorusuna verilen yanıtın doğrulu kontrol edilir.

echo Validator::answer(10);

# Validate (ZN >= 4.0.23)

Bu kütüphane Validator:: kütüphanesinin sıralı kullanımına yönelik oluşturulmuş kontrol kütüphanesidir. Validator:: kütüphanesinde yer alan bütün yöntemleri kullanabilir.

# Yöntemler

# Data (ZN >= 4.0.23)

Kontrol edilecek verinin girileceği yöntemdir.

$status = Validate::data('ExampleData')
                  ->maxchar(20)
                  ->minchar(5)
                  ->email()
                  ->get();

echo $status;
output( Validate::status() );

# Get (ZN >= 4.0.23)

Validate kütüphanesine ait filtreleme

işlemlerini sonlandırmak için kullanılır.

Yukarıdaki örnekte kullanımı gösterilmiştir.

# Status (ZN >= 4.0.23)

Validate kütüphanesine ait filtreleme işlemleri sonucunda hangi filtrelerden başarı ile geçilip hangilerinden geçilmediği hakkıkında bilgi veren bir dizi döndürür.

Yukarıdaki örnekte kullanımı gösterilmiştir.