Benchmark

---

(ZN >= 1.0.0)

Benchmark kütüphanesi, yazacağınız sistemin veya kodların performansını test etmek amacıyla oluşturulmuştur.

 

 

# Kurulum

---

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

↓ composer require znframework/package-comparison

 

 

# Yöntemler

---

1.0.0	void	start(string $test)
1.0.0	void	end(string $test)
4.0.1	this	run(callable $callback)
5.0.0	this	cycle(int $count = 1, callable $callback)
1.0.0	float	elapsedTime(string $result, int $decimal = 4)
1.0.0	int	memoryUsage(bool $realMemory = false)
1.0.0	int	maxMemoryUsage(bool $realMemory = false)
2.0.0	int	calculatedMemory(string $result)
2.0.0	array	usedFiles(string $result = NULL)
2.0.0	int	usedFileCount(string $result = NULL)

 

 

# Start (ZN >= 1.0.0)

---

Testi başlatır.

Parametreler

string	$test	Test adı.
return	void

Kullanımı

Benchmark::start('test');
# your codes
Benchmark::end('test');

output(Benchmark::elapsedTime('test'));

 

 

# End (ZN >= 1.0.0)

---

Testi bitirir.

Parametreler

string	$test	Test adı.
return	void

Kullanımı

Benchmark::start('test');
     # your codes
Benchmark::end('test');

Benchmark::start('test1');
     # your codes
Benchmark::end('test1');

output(Benchmark::elapsedTime('test'));
output(Benchmark::elapsedTime('test1'));

 

 

# Run (ZN >= 4.0.1)

---

Benchmark::start() ve Benchmark::end() yöntemlerinin yaptığı işlemi yapar.

Parametreler

callable	$callback	Performansı ölçülecek kodlar.
return	this

Opsiyonel Yöntemler

this

result()

Kullanımı

<?php namespace Project\Controllers;

use Benchmark, DB;

class TestController extends Controller
{
    public function main(string $params = NULL)
    {
        $bench = Benchmark::run(function()
        {
            DB::get('users')->result();
        });

        output($bench->result());
    }
}

 

 

# Cycle (ZN >= 5.0.0)

---

Benchmark::run() kullanımı gibidir. Farklı olarak bir kodu belli sayıda çalıştırmak için kullanılır. Bir nevi çalıştırılacak kodu döngüye sokarak test eder.

Parametreler

int	$count = 1	Kodların kaç kez çalıştırılacağı.
callable	$callback	Performansı ölçülecek kodlar.
return	this

Opsiyonel Yöntemler

this

result()

Kullanımı

<?php namespace Project\Controllers;

use Benchmark, DB;

class TestController extends Controller
{
    public function main(string $params = NULL)
    {
        $bench = Benchmark::cycle(1000, function()
        {
            DB::get('users')->result();
        });

        output($bench->result());
    }
}

Yukarıdaki örnekte kodun 1000 kez çalıştırılması sağlanmıştır.

 

 

# ElapsedTime (ZN >= 1.0.0)

---

Test sonunda geçen süreyi öğrenmek için kullanılır.

Parametreler

string	$test	Test adı.
int	$decimal = 4	Ondalıklı rakam adeti.
return	float

Kullanımlar

\Output::writeLine( Benchmark::elapsedTime('test', 5) );
\Output::writeLine( Benchmark::elapsedTime('test1', 6) );

 

 

# MemoryUsage (ZN >= 1.0.0)

---

PHP kodlarının sistemde kaç byte yer kapladığını öğrenmek için kullanılır.

Parametreler

bool	$realMemory = false	Gerçek hafıza miktarı hesaplansın mı?
return	float

Kullanımlar

echo Converter::byte( Benchmark::memoryUsage() );

 

 

# MaxMemoryUsage (ZN >= 1.0.0)

---

PHP kodlarına ayrılan maksimum bellek miktarını öğrenmek için kullanılır.

Parametreler

bool	$realMemory = false	Gerçek hafıza miktarı hesaplansın mı?
return	float

Kullanımlar

echo Converter::byte( Benchmark::maxMemoryUsage() );

 

 

# CalculatedMemory (ZN >= 2.0.0)

---

Bir PHP kodunun bellekte ne kadar yer kapladığını hesaplamak için kullanılır.

Parametreler

string	$test	Test adı.
return	float

Kullanımlar

echo Benchmark::calculatedMemory('test'); 
echo Benchmark::calculatedMemory('test1');

 

 

# UsedFiles (ZN >= 2.0.0)

---

Testte kullanılan dosyaların listesini dizi türünde çıktılar.

Parametreler

string	$test	Test adı.
return	array

Kullanımlar

output( Benchmark::usedFiles('test1') );

 

 

# UsedFileCount (ZN >= 2.0.0)

---

Testte kullanılan dosyaların sayısını çıktılar.

Parametreler

string	$test	Test adı.
return	int

Kullanımlar

echo Benchmark::usedFileCount('test1');