rspec/rules/S2701/php/rule.adoc

== Why is this an issue?

Instead of using boolean literals or _null_ in an equality with _assertSame()_ or _assertEquals()_, it is recommended to rely on the alternative functions _assertTrue()_, _assertFalse()_, assertNull(), and _assertNotNull()_.

=== Noncompliant code example

[source,php]
----
assertEquals(true, $x); // Noncompliant {{Use assertTrue() instead.}}
assertNotEquals(false, $x); // Noncompliant {{Use assertTrue() instead.}}
assertSame(null, $x); // Noncompliant {{Use assertNull() instead.}}
assertNotSame(true, $x); // Noncompliant {{Use assertFalse() instead.}}
----

=== Compliant solution

[source,php]
----
assertTrue($x); // Compliant
assertFalse($x); // Compliant
assertNull($x); // Compliant
assertNotNull($x); // Compliant
----

ifdef::env-github,rspecator-view[]

'''
== Implementation Specification
(visible only on this page)

include::../message.adoc[]

'''
== Comments And Links
(visible only on this page)

include::../comments-and-links.adoc[]

endif::env-github,rspecator-view[]