Validasyon Kütüphaneleri

Bu kütüphanelerin temel amacı veri ve sistem güvenliğini sağlamaktır. 

# Kurulum

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

↓ composer require znframework/package-validation

# Validation (ZN >= 0.0.1)

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

# Uygulama

# Standart Validasyon Kullanımı
# Form Validasyon Kullanımı

# Yöntemler

# Validate (ZN >= 3.0.0)

Doğrulama yöntemidir. 

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

# Secure (ZN >= 3.0.0)

Güvenlik yöntemidir. 

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

# Compare (ZN >= 3.0.0)

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

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

# MatchPassword (ZN >= 3.0.0)

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 (ZN >= 3.0.0)

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

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

# Phone (ZN >= 3.0.0)

Telefon bilgisi kontrolünü yapan yöntemdir.

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

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

# Pattern (ZN >= 3.0.0)

İ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.

# Card (ZN >= 5.6.4)

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 (ZN >= 5.6.4)

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 (ZN >= 5.6.4)

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

Gelen değer ay/yıl formatında bir bilgi içermelidir.

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

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

# Messages (ZN >= 5.6.4)

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 (ZN >= 3.0.0)

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 (ZN >= 3.0.0)

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 (ZN >= 0.0.1)

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.

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:');

output( Validation::error() );

# Error (ZN >= 0.0.1)

Validasyon sonrası veri kontrolünün başarı ile sağlanıp sağlamadığı hakkın bilgi almak amaçlı kullanılır. Bu yöntem genellikle string parametresi ile bilgilendirme mesajı vermek için kullanılır.

echo Validation::error('string');
output( Validation::error() );

# Check (ZN >= 5.4.2)

Form kütüphanesine ait nesnelerin validate() yöntemi ile oluşturulan kuralların kontrolü için kullanılır.

$submitName = 'all'

<?php namespace Project\Controllers;

use Validation, Post;

class Home extends Controller
{
    public function main(String $params = NULL)
    {
        if( ! Validation::check() )
        {
            View::error(Validation::error('string'));
        }
    }
}

# 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. 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');

            if( ! $validationError = Validation::error('string') )
            {
                DB::insert('post:contact');               
            }    
        } 

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

# Form 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.

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)
    {
        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);

# 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.