mago-semantics 1.20.1

PHP Semantics Checker.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

use mago_php_version::feature::Feature;
use mago_reporting::Annotation;
use mago_reporting::Issue;
use mago_span::HasSpan;
use mago_syntax::ast::Assignment;
use mago_syntax::ast::AssignmentOperator;

use crate::internal::context::Context;

#[inline]
pub fn check_assignment(assignment: &Assignment, context: &mut Context<'_, '_, '_>) {
    if context.version.is_supported(Feature::NullCoalesceAssign) {
        return;
    }

    let AssignmentOperator::Coalesce(operator) = assignment.operator else {
        return;
    };

    context.report(
        Issue::error("The `??=` (null coalesce assignment) operator is only available in PHP 7.4 and later.")
            .with_annotation(
                Annotation::primary(operator.span()).with_message("Null coalesce assignment operator `??=` used here."),
            )
            .with_note("Use a manual check-and-assignment approach if you need compatibility with older PHP versions.")
            .with_help("Replace `$var ??= <default>` with `$var = $var ?? <default>`."),
    );
}