Yazılım

PHP’de Para İşlemleri: Değer Nesnesi Yaklaşımı

Son güncelleme: 21 Mart 2026 06:43

teknomers

Paylaş

Paylaş

Para İşlemenin Farklı Olmasının Sebepleri

<p>Finansal yazılımlar, bir blog veya yapılacaklar uygulaması geliştirmekten farklıdır. Kullanıcılar «<em>99.99 $ Öde</em>» butonuna bastıklarında, hesaplarından tam olarak 99.99 $ çıkmasını beklerler - <strong>99.989999999 $</strong> veya <strong>100.000000001 $</strong> değil.</p>

<p>0.01 centlik bir yuvarlama hatası önemsiz gibi görünebilir. Ancak bunu aşağıdaki durumlarla çarptığınızda:</p>

<ul>
    <li>Günlük 10,000 işlem</li>
    <li>500 çalışan için aylık maaş ödemeleri</li>
    <li>Yıllarca biriken muhasebe tutarsızlıkları</li>
</ul>

<p>Birdenbire «küçük float hassasiyetsizliği» birkaç bin dolara, başarısız denetimlere veya kızgın müşterilere dönüşebilir.</p>

<h3>
    <a name="the-silent-killer-float-precision" href="#the-silent-killer-float-precision"></a>
    Sessiz Katil: Float Hassasiyeti
</h3>

<p>PHP projelerinin %90'ı parayı yanlış yönetiyor. İşte klasik tuzak:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>$subtotal = 0.1 + 0.2;       // Olması gereken 0.3

$tax = $subtotal * 1.08; // Olması gereken 0.324
$total = $tax + 0.50; // Olması gereken 0.824

echo json_encode([
‘subtotal’ => $subtotal, // 0.30000000000000004 😱
‘tax’ => $tax, // 0.32400000000000006
‘total’ => $total // 0.8240000000000001
]);

<p>API’niz sahte sayılar döndürüyor. Muhasebeciniz panik içinde arıyor. Müşteriler yanlış ücretlerden şikayet ediyor.</p>

<h3>
    <a name="the-root-cause-ieee-754-horror" href="#the-root-cause-ieee-754-horror"></a>
    Temel Sebep: IEEE 754 Korkusu
</h3>

<p>Bu bir PHP hatası değil. Bu, ikili kayan nokta matematiği:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>0.1 decimal ≠ exact binary representation

↓
0.1000000000000000055511151231257827021181583404541015625 (24+ bytes!)

0.1 + 0.2 ≠ 0.3 exactly
↓
0.3000000000000000444089209850062616169452667236328125

<p>Her dil bu sorunu yaşıyor. <strong>Java</strong>, <strong>Python</strong>, <strong>JavaScript</strong>, <strong>C#</strong>, <strong>Go</strong> - hepsi benzer float hassasiyeti cehennemini yaşıyor.</p>

<h3>
    <a name="realworld-consequences" href="#realworld-consequences"></a>
    Gerçek Dünyadaki Sonuçlar
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>Alışveriş sepeti: $99.99 → $100.00 ödeme sırasında

Maaş: $1,234.56 → $1,234.55 (çalışanlar fark eder)
Vergiler: %18 KDV, denetimde $2,347.89 kaybı
Kripto: 0.0001 BTC, 0.000099999999 BTC haline gelir

<h3>
    <a name="the-problem-is-universal" href="#the-problem-is-universal"></a>
    Sorun Evrenseldir
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// MYSQL'de DECIMAL(10,2) → PHP'de float → tekrar hassasiyet kaybedildi.

$price = (float)$pdo->query(‘SELECT price FROM orders’)->fetchColumn();
$price += 0.1; // Hassasiyet kaybı tekrar gerçekleşiyor 😵

<p>Yarım önlemler işe yaramaz. Parayı düşünme şeklinizde köklü bir değişiklik yapmalısınız.</p>

<h2>
    <a name="the-industry-solution-integers-in-cents" href="#the-industry-solution-integers-in-cents"></a>
    Endüstri Çözümü: Sendever Cinsinden Tam Sayılar
</h2>

<p>Bankalar, Stripe, PayPal - asla float kullanmazlar. Parayı en küçük para birimini temsil eden tam sayılar olarak depolarlar:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight plaintext"><code>$100.50 USD = 10,050 cents → BIGINT

€75.25 EUR = 7,525 cents → BIGINT
¥5,000 JPY = 5,000 yen → BIGINT (cent gerekmez)
₽1,234.56 RUB = 123,456 kopecks → BIGINT

<h3>
    <a name="why-cents-storage-is-perfect" href="#why-cents-storage-is-perfect"></a>
    Para Birimi Depolamanın Neden Mükemmel Olduğu
</h3>

<ul>
    <li>
        <strong>Hassasiyet</strong>: Tam sayılar tam olarak temsil edilebilir - asla yuvarlama hatası yok.</li>
    <li>
        <strong>Performans</strong>: CPU tam sayı matemi 10-100 kat daha hızlıdır <code>decimal</code> veya <code>bcmath</code>'e göre.</li>
    <li>
        <strong>Depolama</strong>: <code>BIGINT UNSIGNED</code> quadrilyonlarca senti (<em>~99 trilyon dolar</em>) yönetebilir.</li>
    <li>
        <strong>Taşınabilirlik</strong>: Tüm para birimlerinde, tüm veritabanlarında aynı şekilde çalışır.</li>
</ul>

<p>Basit matematik:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>$totalCents = $priceCents + $taxCents;  // Kesin!

$discounted = $priceCents * 90 / 100; // Kesin!

<h3>
    <a name="from-float-%E2%86%92-cents-the-critical-conversion" href="#from-float-%E2%86%92-cents-the-critical-conversion"></a>
    Float'tan Cente: Kritik Dönüşüm
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// Yanlış ❌

$cents = (int)($dollars * 100); // Kısmen kesiliyor! 123.999 → 12300

// Doğru ✅
$cents = (int)round($dollars * 100); // Uygun yuvarlama 123.999 → 12400

<p><code>round()</code> zorunlu - aksi takdirde her işleminizde son centi kaybedersiniz.</p>

<h3>
    <a name="even-decimal-isnt-safe" href="#even-decimal-isnt-safe"></a>
    Hatta DECIMAL Güvenli Değil
</h3>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// MySQL DECIMAL(10,2) → PHP float → hassasiyet kaybedildi.

$price = 123.45; // DECIMAL’dan
$result = $price + 0.01; // 123.46000000000001 haline geliyor 😱

<p><strong>DECIMAL</strong> depolama konusunda yardımcı olur fakat çalışma zamanında başarısız olur. PHP bunu tekrar float'a dönüştürür.</p>

<h3>
    <a name="introducing-value-objects" href="#introducing-value-objects"></a>
    Değer Nesnelerini Tanıtma
</h3>

<p>Ham tam sayılar işe yarar, ancak geliştiricilerin anlam ve güvenlik ihtiyacı vardır:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code>// Belirsiz: cents mi? dolar mı? hangi para birimi?

$amount = 750025;

// Açık: “bu USD/RUB vs.” cinsinden aylık gelir”
$income = MonthlyIncome::fromPrincipal(7500.25);

<p>Değer Nesneleri şunları çözer:</p>

<ul>
    <li>Tür karmaşası (<em>Maaş vs Borç vs İndirim</em>)</li>
    <li>Doğrulama (<em>negatif maaş yok</em>)</li>
    <li>Kullanışlılık (<code>->formatted()</code>, <code>->asFloat()</code>)</li>
    <li>Değişmezlik (<em>yanlışlıkla değişiklik yok</em>)</li>
</ul>

<h2>
    <a name="productionready-monthlyincome-value-object" href="#productionready-monthlyincome-value-object"></a>
    Üretime Hazır Aylık Gelir Değer Nesnesi
</h2>

<p>İşte mükemmel para işlemesi için tam test edilmiş uygulamanız:<br/></p>

<div class="highlight js-code-highlight">
    <pre class="highlight php"><code><?php declare(strict_types=1);

namespace App\Identity\Domain\Money;

use Doctrine\ORM\Mapping as ORM;
use Doctrine\DBAL\Types\Types;
use App\Shared\Domain\Primitive;

[ORM\Embeddable]

final class MonthlyIncome extends Primitive
{
/ 

• Hassas para hesaplamaları için sent cinsinden miktar.
• @var int
  */

  [ORM\Column(name: ‘monthly_income’, type: Types::BIGINT, options: [

  ‘unsigned’ => true,
  ‘default’ => 0
  ])]
  private int $amountInCents;

/ 
 * Miktarı sent cinsinden doğrular ve ayarlar.
 * 
 * @param int $cents
 * @throws \InvalidArgumentException
 */
private function __construct(int $cents)
{
    if ($cents < 0) {
        throw new \InvalidArgumentException(message: 'Miktar negatif olamaz.');
    }

    if ($cents > 999_999_999_99) {
        throw new \InvalidArgumentException(message: 'Miktar çok büyük.');
    }

    $this->amountInCents = $cents;
}

/ 
 * Yüzde biriminden (ana döviz) değer oluşturur.
 * 
 * @param float $value
 * @return self
 */
public static function fromPrincipal(float $value): self
{
    $cents = (int)round($value * 100);
    return new self(cents: $cents);
}

/ 
 * Sent cinsinden doğrudan Aylık Gelir oluşturur.
 * 
 * @param int $value
 * @return self
 */
public static function fromCents(int $value): self
{
    return new self(cents: $value);
}

/ 
 * Ana miktarı float olarak döndürür.
 * 
 * @return float
 */
public function asFloat(): float
{
    return $this->amountInCents / 100.0;
}

/ 
 * Biçimlendirilmiş miktarı döndürür (boşluk/virgül).
 * 
 * @return string
 */
public function formatted(): string
{
    return number_format(
        num: $this->amountInCents(),
        decimals: 2,
        decimal_separator: ',',
        thousands_separator: ' '
    );
}

/ 
 * Aylık Gelir örneklerini karşılaştırır.
 * 
 * @param self $other
 * @return bool
 */
public function equals(self $other): bool
{
    return $this->amountInCents === $other->amountInCents;
}

/ 
 * Hammadde miktarını sent cinsinden döndürür.
 * 
 * @return int
 */
public function amountInCents(): int
{
    return $this->amountInCents;
}

}