README

ANB PHP MATH — это специализированный PHP‑пакет для решения математических задач в веб‑приложениях. Он предоставляет удобный интерфейс для выполнения арифметических, статистических и инженерных вычислений.

✅ Основные возможности

Пакет включает классы, которые реализуют:

• Базовые арифметические операции: сложение, вычитание, умножение, деление.
• Степени и корни: возведение в степень, извлечение квадратного и кубического корней.
• Проценты [планы]: расчёт процентов от числа, процентного изменения.
• Факториалы и комбинаторика [планы]: вычисление факториала, числа сочетаний и размещений.
• Округление: до целого, до заданного количества знаков после запятой.
• Статистика [планы]: среднее арифметическое, медиана, дисперсия, стандартное отклонение.
• Теория чисел [планы]: проверка на простоту, нахождение НОД и НОК, разложение на простые множители.
• Геометрия [планы, частично]: площади и периметры фигур (круг, прямоугольник, треугольник), объёмы тел.
• Случайные числа [планы]: генерация в заданном диапазоне, выборка из массива.
• Константы [планы]: доступ к математическим константам ($\pi$, $e$ и др.).

⚙️ Установка и использование

Установите пакет через Composer:

composer require goodboyalex/php_math

Подключите класс и начните работу:

use goodboyalex\php_math\classes\MathOperation;

// Пример использования
try {
    // Базовые операции
    $sum = MathOperation::add(10, 5);           // 15
    $product = MathOperation::multiply(4, 3);     // 12

    // Степень и корень
    $power = MathOperation::power(2, 8);       // 256 (2⁸)
    $sqrt = MathOperation::sqrt(81);             // 9

    // Проценты
    //$percentage = MathOperation::percentage(200, 15); // 30 (15% от 200) // TODO

    // Статистика
    //$average = MathOperation::average([1, 2, 3, 4, 5]); // 3 // TODO

    // Теория чисел
    //$gcd = MathCalculator::gcd(48, 18);        // 6 // TODO
    $isPrime = MathOperation::isPrime(17);       // true

    // Геометрия
    //$circleArea = MathCalculator::circleArea(5); // ≈78.54 (π × 5²) // TODO

    echo "Сумма: $sum\n";
    echo "Среднее: $average\n";
    echo "Площадь круга (r=5): " . round($circleArea, 2) . "\n";
} catch (Exception $e) {
    echo "Ошибка: " . $e->getMessage();
}

🛠️ Поддерживаемые технологии

• PHP 8.3+
• Совместимость с фреймворками: Laravel, Symfony, Yii и др.
• Поддержка Composer для управления зависимостями.

💬 Обратная связь и поддержка

Обо всех ошибках и пожеланиях можно сообщать в разделе проблемы.