В программировании «магические числа» — это числовые значения, которые используются непосредственно в коде без явного объяснения, почему выбрано именно это значение. Такие числа часто являются «магическими» из-за своей непонятности и могут затруднить понимание и поддержку кода. В этом уроке мы рассмотрим, что такое магические числа, их проблемы и лучшие практики для их замены.
Магические числа не имеют явного смысла и могут быть трудны для понимания другим разработчикам или даже вам самим через некоторое время.
Пример:
<?php
$price = 100 * 1.2; // 1.2 — магическое число, представляющее налог
?>
В этом примере 1.2 не ясно указывает на то, что это ставка налога.
Если магическое число используется в нескольких местах, изменение его значения может быть трудной задачей, так как его нужно найти и обновить во всех местах использования.
Пример:
<?php
$finalPrice = $basePrice * 1.2; // Налог
$discountedPrice = $basePrice * 1.2; // Налог
?>
В этом примере изменение ставки налога потребует обновления в двух местах.
Для замены магических чисел используйте константы. Это делает код более читаемым и упрощает его изменение.
Пример:
<?php
define('TAX_RATE', 1.2); // Константа для налога
$finalPrice = $basePrice * TAX_RATE;
$discountedPrice = $basePrice * TAX_RATE;
?>
Теперь TAX_RATE ясно указывает, что это ставка налога, и её легко изменить в одном месте.
Если вы используете PHP 8.1 или новее, рассмотрите использование перечислений для группировки связанных констант.
Пример:
<?php
enum TaxRate: float {
case STANDARD = 1.2;
case REDUCED = 1.1;
}
$finalPrice = $basePrice * TaxRate::STANDARD->value;
?>
В этом примере перечисления дают чёткие имена для различных налоговых ставок.
Для значений, которые могут изменяться в зависимости от окружения или условий, используйте конфигурационные файлы.
Пример:
config.php:
<?php
return [
'tax_rate' => 1.2,
];
?>
main.php:
<?php
$config = require 'config.php';
$finalPrice = $basePrice * $config['tax_rate'];
?>
Теперь изменение ставки налога требует изменения только в конфигурационном файле.
Пример ошибки:
<?php
$finalPrice = $basePrice * 0.15; // 0.15 — не объяснено
?>
Решение:
Используйте константы для более ясного определения значений.
<?php
define('DISCOUNT_RATE', 0.15); // Константа для скидки
$finalPrice = $basePrice * DISCOUNT_RATE;
?>
Пример ошибки:
<?php
$totalAmount = $baseAmount * 1.15; // Налог
$discountedAmount = $baseAmount * 0.85; // Скидка
?>
Решение:
Используйте константы для всех числовых значений, чтобы обеспечить согласованность.
<?php
define('TAX_RATE', 1.15);
define('DISCOUNT_RATE', 0.85);
$totalAmount = $baseAmount * TAX_RATE;
$discountedAmount = $baseAmount * DISCOUNT_RATE;
?>
Использование магических чисел в коде может привести к трудностям в понимании и поддержке кода. Использование констант, перечислений и конфигурационных файлов помогает сделать код более читабельным и облегчает его поддержку.
Для закрепления материала выполните следующее задание:
Пример выполнения задания:
<?php
define('VAT_RATE', 1.20); // Константа для НДС
$basePrice = 100; // Исходная цена
$finalPrice = $basePrice * VAT_RATE; // Итоговая цена с НДС
echo "Final Price: $finalPrice"; // Вывод: Final Price: 120
?>
Удачи в выполнении задания и дальнейшем изучении PHP!
Наша цель и главная задача сделать качественное образование в вашем браузере
Телефон: +375 33 910-08-92
Email: info@codefor.tech
Адрес: г. Барановичи, ул. Пирогова, д. 7
© 2024 Все права защищены. CodeFor.
